Introduction

Gérez les comptes administrateurs avec des rôles, des permissions et un contrôle d'accès.

🎯 Que fait ce module ?

Le module Admins vous permet de savoir qui a accès à votre panneau d'administration OneEntry et ce qu'ils peuvent faire.

📖 Explication simple

Imaginez que vous gérez un site web avec une équipe :

• 👑 Super Admin - Peut tout faire (vous, le propriétaire).
• 👨‍💼 Gestionnaire de contenu - Peut modifier des pages et des produits.
• 📝 Éditeur - Peut rédiger des articles de blog.
• 🎨 Designer - Peut gérer des images et des blocs.
• 👀 Visiteur - Ne peut que consulter les données, sans possibilité de modification.

Au lieu de donner un accès complet à tout le monde, vous :

• Créez des comptes administrateurs pour les membres de l'équipe.
• Attribuez des rôles et des permissions spécifiques.
• Contrôlez ce que chaque personne peut voir et modifier.
• Suivez qui a effectué des modifications (journal d'audit).
• Révoquez l'accès lorsque quelqu'un quitte l'équipe.

Exemple concret :

Without Admin Management:
- Everyone shares one account → Can't track who did what.
- Everyone has full access → Risky!
- No control over permissions.

With Admin Management:
- Each team member has their own account.
- Specific permissions per role.
- Full audit trail of changes.
- Easy to add/remove team members.

✨ Concepts clés

Qu'est-ce qu'un Administrateur ?

Un administrateur (admin) est un utilisateur ayant un accès élevé pour gérer votre projet OneEntry :

• Droits d'accès - Quelles parties du système ils peuvent accéder.
• Permissions - Quelles actions ils peuvent effectuer (créer, modifier, supprimer).
• Rôle - Leur position/responsabilité (par exemple, "Gestionnaire de contenu").
• Informations sur le compte - Nom, email, statut.

Administrateur vs Utilisateur régulier

Type	Objectif	Exemple
Administrateur	Gère le système (backend)	Vous, les membres de votre équipe
Utilisateur régulier	Utilise votre application/site (frontend)	Vos clients, visiteurs du site

Différence clé : Les Admins gèrent le contenu, les Utilisateurs consomment le contenu.

📋 Ce que vous devez savoir

Attributs des Admins

Chaque admin a ces champs clés :

{
  id: 123,                          // Unique admin ID
  attributeSetId: 27,               // Unique attribute set ID
  identifier: "admin",              // Unique identifier
  attributeSetIdentifier: "admins", // Unique attribute set identifier
  position: 1,                      // Position
  isSync: true,                     // Whether to sync with the backend
  attributeValues: {}               // Attribute values
}

Filtrer les Admins

Utilisez des filtres pour trouver des admins spécifiques :

Marqueurs de condition (identiques à ceux du module Produits) :

Marqueur	Signification	Exemple
eq	Égal	statusId = 1 (actif uniquement)
neq	Pas égal	role ≠ "Visiteur"
in	Contient (un des)	role in ["Éditeur", "Gestionnaire"]
nin	Ne contient pas	email not in ["@temp.com"]
exs	Existe (a une valeur)	A un lastLogin
nexs	N'existe pas	Jamais connecté

Considérations de sécurité

Important :

• 🔒 Ne jamais exposer les identifiants d'admin dans le code frontend.
• 🔐 Utiliser des jetons sécurisés pour les appels API ou des certificats mtls.
• 👤 Mettre en œuvre le principe du moindre privilège - donner les permissions minimales nécessaires.
• 📝 Auditer les modifications - suivre qui a fait quoi.
• 🚪 Révoquer l'accès immédiatement lorsque quelqu'un part.

---

❓ Questions fréquentes (FAQ)

Quelle est la différence entre les modules Admins et Utilisateurs ?

• Admins - Gèrent votre équipe (utilisateurs backend qui gèrent le système).
• Utilisateurs - Gèrent les clients (utilisateurs frontend qui utilisent votre application/site).

---

Comment puis-je restreindre ce qu'un admin peut faire ?

Utilisez les rôles et permissions.

🎓 Meilleures pratiques

• Mettre en œuvre le principe du moindre privilège (permissions minimales nécessaires).
• Suivre les actions des admins (qui a fait quoi, quand).
• Réviser régulièrement les permissions.
• Utiliser des politiques de mot de passe robustes.
• Envisager d'utiliser l'authentification multi-facteurs.
• Changer régulièrement les mots de passe des administrateurs.

Pour plus d'informations sur l'interface utilisateur du module, visitez https://doc.oneentry.cloud/docs/category/administrators

---

Définition du module 'Admins'

const { Admins } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

---

const { Admins } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);
const body = [
  {
    "attributeMarker": "num",
    "conditionMarker": "mth",
    "conditionValue": 1
  }
];
const response = await Admins.getAdminsInfo(body, "en_US", 0, 30);

Schéma des paramètres

Schéma : (body)

attributeMarker: string
Identifiant textuel de l'attribut
exemple : price

conditionMarker: string
Identifiant textuel de la condition, valeurs possibles : 'in' - contient, 'nin' - ne contient pas, 'eq' - égal, 'neq' - pas égal, 'mth' - plus que, 'lth' - moins que, 'exs' - existe, 'nexs' - n'existe pas, 'pat' - motif, par exemple -, où '' représente n'importe quel caractère, 'same' - même valeur que l'attribut sélectionné*
exemple : in
Enum : [ in, nin, eq, neq, mth, lth, exs, nexs, pat, same ]

conditionValue: number
Valeur de condition
exemple : 1

---