Bien démarrer · Guide pratique
Organisations
Comprenez les rôles et les permissions des organisations.
Les organisations sont l'entité de niveau supérieur qui regroupe les utilisateurs. Chaque organisation peut avoir plusieurs membres avec différents rôles qui déterminent les actions qu'ils peuvent effectuer. Cette documentation couvre les rôles, les permissions et les options liées aux organisations.
Concepts clés
- Organisation : Un groupe ou une équipe qui contient des membres et des ressources comme des cours, des apprenants et des collections.
- Membre : Un utilisateur qui appartient à une organisation avec un rôle assigné.
- Rôle : Définit les actions qu'un membre peut effectuer au sein de l'organisation.
Rôles
L'accès au projet Kokobi définit quatre rôles : Propriétaire, Administrateur, Support et Membre. Les rôles Propriétaire et Administrateur ont un accès complet au projet, le rôle Support peut usurper l'identité des apprenants à des fins d'assistance et le rôle Membre peut consulter les principales ressources de l'organisation.
1. Membre (Par défaut)
Le rôle Membre est conçu pour les utilisateurs réguliers qui ont besoin de consulter le contenu de l'organisation, mais qui n'ont pas besoin de privilèges administratifs.
La plupart des membres de l'organisation devraient avoir le rôle Membre.
2. Administrateur
Le rôle Administrateur dispose de permissions complètes pour gérer toutes les ressources au sein de l'organisation, à l'exception de certains privilèges réservés au propriétaire.
N'accordez le rôle Administrateur qu'aux personnes de confiance qui ont besoin d'un contrôle complet sur les ressources et les paramètres de l'organisation.
3. Propriétaire
Le rôle Propriétaire a un contrôle total sur l'organisation avec toutes les permissions administratives ainsi que des capacités spécifiques au propriétaire.
Le rôle Propriétaire est attribué au créateur de l'organisation.
4. Support
Le rôle Support est strictement limité à l'usurpation d'identité des apprenants pour le dépannage et l'assistance.
Matrice des permissions du projet
La matrice dynamique ci-dessous est dérivée directement de la configuration d'accès au projet Kokobi. Elle couvre les rôles Propriétaire, Administrateur, Support et Membre, ainsi que les permissions maximales disponibles pour les clés API d'utilisateur et d'organisation.
Ces permissions du projet protègent les ressources et les opérations API de Kokobi. Les permissions d'organisation centralisées de Better Auth, notamment l'adhésion à une organisation et l'administration des rôles, constituent une couche d'autorisation distincte qui n'est pas représentée dans cette matrice.
Role grants
| Resource | Action | Owner | Admin | Support | Member |
|---|---|---|---|---|---|
Folderfolder | Readread | Allowed | Allowed | Not allowed | Allowed |
Folderfolder | Createcreate | Allowed | Allowed | Not allowed | Not allowed |
Folderfolder | Updateupdate | Allowed | Allowed | Not allowed | Not allowed |
Folderfolder | Deletedelete | Allowed | Allowed | Not allowed | Not allowed |
Coursecourse | Readread | Allowed | Allowed | Not allowed | Allowed |
Coursecourse | Createcreate | Allowed | Allowed | Not allowed | Not allowed |
Coursecourse | Shareshare | Allowed | Allowed | Not allowed | Not allowed |
Coursecourse | Updateupdate | Allowed | Allowed | Not allowed | Not allowed |
Coursecourse | Archivearchive | Allowed | Allowed | Not allowed | Not allowed |
Coursecourse | Deletedelete | Allowed | Allowed | Not allowed | Not allowed |
Collectioncollection | Readread | Allowed | Allowed | Not allowed | Allowed |
Collectioncollection | Createcreate | Allowed | Allowed | Not allowed | Not allowed |
Collectioncollection | Shareshare | Allowed | Allowed | Not allowed | Not allowed |
Collectioncollection | Updateupdate | Allowed | Allowed | Not allowed | Not allowed |
Collectioncollection | Archivearchive | Allowed | Allowed | Not allowed | Not allowed |
Collectioncollection | Deletedelete | Allowed | Allowed | Not allowed | Not allowed |
Learnerlearner | Readread | Allowed | Allowed | Not allowed | Allowed |
Learnerlearner | Createcreate | Allowed | Allowed | Not allowed | Allowed |
Learnerlearner | Updateupdate | Allowed | Allowed | Not allowed | Not allowed |
Learnerlearner | Deletedelete | Allowed | Allowed | Not allowed | Not allowed |
Learnerlearner | Impersonateimpersonate | Allowed | Allowed | Allowed | Not allowed |
Webhookwebhook | Readread | Allowed | Allowed | Not allowed | Allowed |
Webhookwebhook | Createcreate | Allowed | Allowed | Not allowed | Not allowed |
Webhookwebhook | Updateupdate | Allowed | Allowed | Not allowed | Not allowed |
Webhookwebhook | Deletedelete | Allowed | Allowed | Not allowed | Not allowed |
Organizationorganization | Readread | Allowed | Allowed | Not allowed | Allowed |
Organizationorganization | Updateupdate | Allowed | Allowed | Not allowed | Not allowed |
Domaindomain | Readread | Allowed | Allowed | Not allowed | Not allowed |
Domaindomain | Createcreate | Allowed | Allowed | Not allowed | Not allowed |
Domaindomain | Deletedelete | Allowed | Allowed | Not allowed | Not allowed |
API-key assignable permissions
| Resource | Action | User key | Organization key |
|---|---|---|---|
Folderfolder | Readread | Not allowed | Allowed |
Folderfolder | Createcreate | Not allowed | Allowed |
Folderfolder | Updateupdate | Not allowed | Allowed |
Folderfolder | Deletedelete | Not allowed | Allowed |
Coursecourse | Readread | Not allowed | Allowed |
Coursecourse | Createcreate | Not allowed | Allowed |
Coursecourse | Shareshare | Not allowed | Allowed |
Coursecourse | Updateupdate | Not allowed | Allowed |
Coursecourse | Archivearchive | Not allowed | Allowed |
Coursecourse | Deletedelete | Not allowed | Allowed |
Collectioncollection | Readread | Not allowed | Allowed |
Collectioncollection | Createcreate | Not allowed | Allowed |
Collectioncollection | Shareshare | Not allowed | Allowed |
Collectioncollection | Updateupdate | Not allowed | Allowed |
Collectioncollection | Archivearchive | Not allowed | Allowed |
Collectioncollection | Deletedelete | Not allowed | Allowed |
Learnerlearner | Readread | Not allowed | Allowed |
Learnerlearner | Createcreate | Not allowed | Allowed |
Learnerlearner | Updateupdate | Not allowed | Allowed |
Learnerlearner | Deletedelete | Not allowed | Allowed |
Learnerlearner | Impersonateimpersonate | Not allowed | Not allowed |
Webhookwebhook | Readread | Not allowed | Allowed |
Webhookwebhook | Createcreate | Not allowed | Allowed |
Webhookwebhook | Updateupdate | Not allowed | Allowed |
Webhookwebhook | Deletedelete | Not allowed | Allowed |
Organizationorganization | Readread | Not allowed | Allowed |
Organizationorganization | Updateupdate | Not allowed | Not allowed |
Domaindomain | Readread | Not allowed | Allowed |
Domaindomain | Createcreate | Not allowed | Allowed |
Domaindomain | Deletedelete | Not allowed | Allowed |