Droits, profils et équipes
Ce qu'un utilisateur peut faire dans une application : des droits définis par l'application, regroupés en profils par environnement, complétés par les équipes.
This page has not been translated yet and is shown in French.
Un droit autorise une action précise dans une application. Un profil regroupe des droits sous un nom métier, et c'est lui que l'on attribue aux utilisateurs. Une équipe regroupe des collègues d'une même organisation, chacun avec un rôle dans l'équipe.
Définition
| Objet | Défini par | Contenu |
|---|---|---|
| Droit | l'application | un code de la forme ressource.action (dossiers.read), un nom, une catégorie ; il existe dans les trois environnements ; 200 droits au plus par application |
| Profil | l'application | un nom unique dans l'application, une description et un WID communs aux trois environnements, et ses droits, cochés dans la matrice de chaque environnement |
| Équipe | un client | un nom, des membres, et pour chaque membre un rôle dans l'équipe |
Pourquoi ça existe
Votre code ne devrait jamais tester « est-ce un administrateur ? », mais « a-t-il le droit factures.read ? ». Les droits nomment ces autorisations ; les profils évitent de les attribuer une à une. Comme la matrice profils × droits se règle par environnement, un droit en cours de développement peut être accordé en dev sans l'être en production.
Comment ça marche
Des profils d'application
Les profils sont créés au niveau de l'application et proposés à tous ses clients, sauf dans les réseaux qui les masquent. Un réseau ou un client ne crée plus de profils propres ; les anciens, s'il en reste, sont historiques et en lecture seule.
Une matrice par environnement
Dans Paramétrage, l'onglet Matrice croise les droits et les profils pour l'environnement choisi : une case cochée donne le droit au profil dans cet environnement. La matrice s'exporte et s'importe en JSON, un environnement à la fois. Elle ne se copie ni ne se promeut d'un environnement à l'autre : chaque environnement se règle séparément.
Attribution aux utilisateurs
Un profil s'attribue à une fiche utilisateur, et une fiche appartient à un seul environnement. Une personne présente en dev et en prod a donc deux fiches, avec le même profil ou un autre. À la connexion, GET /api/me renvoie le profil de la fiche de l'environnement de connexion et ses droits, lus dans la matrice de cet environnement, dans profile.rights. L'API publique, elle, vérifie les droits avant d'exécuter : sans le droit requis, elle répond 403 avec le message « Droit applicatif requis : » suivi du code du droit, par exemple Droit applicatif requis : factures.read. Un changement de profil prend effet dans la minute.
Les équipes
Chaque membre d'une équipe a un rôle :
| Rôle | Portée prévue |
|---|---|
ADMIN | tout sur l'équipe |
MANAGER | gère les membres |
MEMBER | accès complet aux données de l'équipe |
CONTRIBUTOR | ajout seulement |
VIEWER | lecture seule |
Votre application lit les équipes de l'utilisateur dans GET /api/me (teams, avec teamLevel) et décide de ce qu'elles autorisent : par exemple, ne montrer un dossier qu'aux membres de l'équipe qui le suit.
L'exemple de la console
La console Wakastart est elle-même une application, avec son catalogue de droits et six profils pour les administrateurs clients :
| Profil | Droits principaux |
|---|---|
| Chef de projet | projets, temps passé, tickets |
| Testeur | lecture et création de tickets |
| Développeur | tickets, lecture de l'hébergement et des logs |
| Infra | paramétrage des applications, hébergement complet, sauvegardes, accès à la production |
| Auditeur | journal d'audit, écran Stellar Proofs, conformité, fournisseurs d'identité et invitations en lecture |
| Financier | facturation, crédits, temps passé en lecture |
Exemples
Un éditeur santé. L'application déclare dossiers.read, dossiers.update et ordonnances.sign. Le profil modèle « Médecin » a les trois ; « Secrétaire » n'a que la lecture. Un réseau de centres de radiologie masque « Médecin » et crée « Radiologue ».
Une nouvelle fonctionnalité. Le droit exports.create est créé pour le seul environnement dev, coché pour le profil « Gestionnaire », testé, puis promu en staging et en production avec la matrice.
Profil, équipe ou fonctionnalité ?
| Besoin | Outil |
|---|---|
| Autoriser une action pour une catégorie de personnes | un droit dans un profil |
| Restreindre des données à un groupe de collègues | une équipe |
| Activer une option pour toute une organisation | une fonctionnalité activable, réglée par application, réseau et client |
Pour aller plus loin
- Droits et profils : créer droits et profils, promouvoir la matrice.
- Utilisateurs et équipes : attribuer les profils et gérer les équipes.
- Jeton enrichi et /me : où votre code lit les droits.
- Référence API : droits et profils, équipes.