Aller au contenu principal

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
  • ✅ Assignez 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 :

Sans Gestion des Administrateurs :
- Tout le monde partage un compte → Impossible de savoir qui a fait quoi ❌
- Tout le monde a un accès complet → Risqué ! ❌
- Pas de contrôle sur les permissions ❌

Avec Gestion des Administrateurs :
- Chaque membre de l'équipe a son propre compte ✅
- Permissions spécifiques par rôle ✅
- Journal d'audit complet des modifications ✅
- Facile d'ajouter/retirer des membres de l'équipe ✅

✨ Concepts Clés​

Qu'est-ce qu'un Administrateur ?​

Un administrateur (admin) est un utilisateur avec 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 Ordinaire​

TypeObjectifExemple
AdministrateurGère le système (backend)Vous, vos membres d'équipe
Utilisateur OrdinaireUtilise 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,                          // ID unique de l'admin
  attributeSetId: 27,               // ID unique de l'ensemble d'attributs
  identifier: "admin",              // Identifiant unique
  attributeSetIdentifier: "admins", // Identifiant unique de l'ensemble d'attributs
  position: 1,                      // Position
  isSync: true,                     // Indique s'il faut synchroniser avec le backend
  attributeValues: {}               // Valeurs des attributs
}

Filtrage des Admins​

Utilisez des filtres pour trouver des admins spécifiques :

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

MarqueurSignificationExemple
eqÉgalstatusId = 1 (actif uniquement)
neqPas égalrole ≠ "Visiteur"
inContient (un des)role in ["Éditeur", "Gestionnaire"]
ninNe contient pasemail not in ["@temp.com"]
exsExiste (a une valeur)A un lastLogin
nexsN'existe pasJamais 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
  • 👤 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équemment Posées (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 des rôles et des permissions.

Que se passe-t-il avec le contenu lorsque je supprime un admin ?​

Le contenu reste, mais la référence au créateur est rompue.

Meilleure pratique : Désactiver au lieu de supprimer

💡 Notes Importantes​

Meilleures Pratiques de Sécurité​

Validez toujours les permissions des admins

🎓 Meilleures Pratiques​

  • Utilisez des rôles pour regrouper les permissions
  • Mettez en œuvre le principe du moindre privilège (permissions minimales nécessaires)
  • Désactivez au lieu de supprimer (préserver le journal d'audit)
  • Suivez les actions des admins (qui a fait quoi, quand)
  • Révisez régulièrement les permissions
  • Utilisez des politiques de mot de passe robustes
  • Activez l'authentification à deux facteurs (2FA)
  • Configurez des notifications par email pour les actions critiques

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 body = [
  {
    "attributeMarker": "num",
    "conditionMarker": "mth",
    "conditionValue": 1
  }
];

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

🔗 Documentation Connexe​