# 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.

Un [droit applicatif](/v1.0/glossaire#droit-applicatif) autorise une action précise dans votre application. Un [profil](/v1.0/glossaire#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](/v1.0/glossaire#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](/v1.0/utilisateurs/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](/v1.0/droits-et-profils/masquer-un-profil-pour-un-reseau)). 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](/v1.0/droits-et-profils/verifier-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](/v1.0/cles-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

- [Définir les droits de votre application](/v1.0/droits-et-profils/definir-les-droits-de-votre-application)
- [Créer un profil](/v1.0/droits-et-profils/creer-un-profil)
- [Attribuer un profil](/v1.0/droits-et-profils/attribuer-un-profil)
- [Niveaux d'administration](/v1.0/droits-et-profils/niveaux-d-administration)
