Skip to content

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.

ConceptAdministratorDeveloper

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émentPortée
Liste des droits de l'applicationCommune aux trois environnements
Profil : nom, description, WIDCommun aux trois environnements
Matrice profils × droitsPropre à chaque environnement
Profil attribué à un utilisateurPropre à sa fiche, donc à son environnement
Droits d'une clé APILus 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.ia existe 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.

Pour aller plus loin