Droits applicatifs et profils
Le modèle de droits de Wakastart - des codes de droits définis par votre application, regroupés en profils, avec une matrice de droits par environnement.
This page has not been translated yet and is shown in French.
Un droit applicatif autorise une action précise dans votre application. Un profil est un paquet de droits que vous attribuez à un utilisateur. Wakastart stocke ce modèle et le restitue à votre application ; c'est votre application qui applique les droits.
Définition
Droit applicatif
Un droit est un code défini par votre application, par convention sous la forme ressource.action : dossier.read, dossier.write, facture.export. Il porte aussi un nom lisible, une description et une catégorie facultative. Un droit existe dans les trois environnements dès sa création : il ne peut pas être limité à certains.
Les droits appartiennent à une application : deux applications peuvent utiliser le même code sans conflit. Une application compte 200 droits au plus.
Profil
Un profil appartient à l'application. Il se désigne par son WID, commun aux trois environnements, et son nom est unique dans l'application. Comme les droits, il existe dans les trois environnements dès sa création.
Ce qui varie d'un environnement à l'autre, c'est la matrice profils × droits : les droits cochés pour chaque profil. Le profil « Gérant » peut ainsi avoir facture.export en production mais pas en staging. Chaque environnement se règle séparément : il n'existe ni copie ni promotion de la matrice d'un environnement vers un autre.
Un profil s'attribue à une fiche utilisateur, et une fiche appartient à un seul environnement (voir Comptes et environnements). Les droits d'un utilisateur sont donc ceux du profil de sa fiche, lus dans la matrice de l'environnement de sa session.
Pourquoi ce modèle
- Votre vocabulaire, pas celui de Wakastart. Les codes de droits sont les vôtres : votre code les teste tels quels.
- Des environnements étanches. Un droit coché pour un profil en dev, pour tester une fonctionnalité, ne l'est pas en prod tant que vous ne le cochez pas dans la matrice de prod.
- Des profils réutilisables. Vous définissez une fois « Secrétariat » ou « Gérant » et l'attribuez à des centaines d'utilisateurs, plutôt que de cocher des droits utilisateur par utilisateur.
Comment ça marche
Ce qui est commun aux environnements
| Élément | Portée |
|---|---|
| Liste des droits de l'application | Commune aux trois environnements |
| Profil : nom, description, WID | Commun aux trois environnements |
| Matrice profils × droits | Propre à chaque environnement |
| Profil attribué à un utilisateur | Propre à sa fiche, donc à son environnement |
| Droits d'une clé API | Lus dans la matrice de l'environnement de la clé |
Profils proposés à un client
Les profils sont créés au niveau de l'application. Un réseau peut masquer un profil de l'application pour ses clients (voir Masquer un profil pour un réseau). Les profils proposés à un client sont donc les profils de l'application que son réseau ne masque pas.
Les anciens profils propres à un réseau ou à un client ne se créent plus : un profil appartient à l'application. Ceux qui existent encore sont affichés comme historiques, en lecture seule.
Profils protégés
Certains profils et droits sont marqués système par Wakastart : ils ne se modifient ni ne se suppriment.
Lecture par votre application
Votre application lit les droits de l'utilisateur connecté avec GET /api/me : le champ profile.rights liste les droits de son profil dans la matrice de l'environnement de la session. Voir Vérifier un droit dans votre application.
Les droits des opérations Wakastart
Les opérations de l'API publique sont elles aussi protégées par des codes de droits : users.create, invitations.create, teams.read… Pour un appel avec une clé API, ces droits viennent du profil de la clé, lus dans la matrice de l'environnement de la clé : une clé de dev porte les droits de la matrice de dev. Pour un appel avec le jeton d'un utilisateur, ils viennent du profil de cet utilisateur dans l'application qui a émis le jeton. Le niveau Propriétaire les possède tous.
Exemples
- Une application de gestion de cabinet. Droits
agenda.read,agenda.write,facture.export. Profil d'application « Secrétariat » (agenda), « Gérant » (tout). Chaque cabinet client choisit entre les deux. - Un distributeur particulier. Son réseau masque « Gérant » ; l'éditeur ajoute à l'application un profil « Gérant distributeur » sans
facture.export, que les autres réseaux masquent. - Une bêta. Le droit
rapport.iaexiste partout, mais il n'est coché que dans les matrices de dev et de staging. Les testeurs le reçoivent en staging ; en production, aucun profil ne le porte.