Aller au contenu

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.

ConceptAdministrateurDéveloppeur
Voir en Markdown

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

Chargement du schéma…
ObjetDéfini parContenu
Droitl'applicationun 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
Profill'applicationun 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
Équipeun clientun 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ôlePortée prévue
ADMINtout sur l'équipe
MANAGERgère les membres
MEMBERaccès complet aux données de l'équipe
CONTRIBUTORajout seulement
VIEWERlecture 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 :

ProfilDroits principaux
Chef de projetprojets, temps passé, tickets
Testeurlecture et création de tickets
Développeurtickets, lecture de l'hébergement et des logs
Infraparamétrage des applications, hébergement complet, sauvegardes, accès à la production
Auditeurjournal d'audit, écran Stellar Proofs, conformité, fournisseurs d'identité et invitations en lecture
Financierfacturation, 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é ?

BesoinOutil
Autoriser une action pour une catégorie de personnesun droit dans un profil
Restreindre des données à un groupe de collèguesune équipe
Activer une option pour toute une organisationune fonctionnalité activable, réglée par application, réseau et client

Pour aller plus loin