# Droits et profils

> Définir les droits de votre application, les regrouper en profils par environnement, les attribuer et les vérifier dans votre code.

Wakastart décide qui peut faire quoi à deux niveaux. Le [niveau d'administration](/v1.0/glossaire#niveau-dadministration) dit jusqu'où une personne administre l'organisation. Les [droits applicatifs](/v1.0/glossaire#droit-applicatif), regroupés en [profils](/v1.0/glossaire#profil), disent ce qu'elle peut faire dans votre application.

## Comment ça marche

Votre application déclare ses droits sous forme de codes `ressource.action`. Vous les regroupez en profils : droits et profils existent dans les trois environnements, et une matrice propre à chaque environnement dit quels droits porte chaque profil. Chaque fiche utilisateur, qui appartient à un environnement, reçoit un profil ; votre application lit ses droits avec `GET /api/me` et décide.

```mermaid
flowchart LR
  subgraph APP["Votre application"]
    D1["dossier.read"]
    D2["dossier.write"]
    D3["facture.export"]
  end
  D1 --> P1["Profil Secrétariat<br/>(matrice prod)"]
  D1 --> P2["Profil Gérant<br/>(matrice prod)"]
  D2 --> P2
  D3 --> P2
  P1 --> U1["Marie"]
  P2 --> U2["Paul"]
  U2 -- "GET /api/me" --> R["profile.rights :<br/>dossier.read, dossier.write, facture.export"]
```

Les profils appartiennent à l'application et sont proposés à tous ses clients. Un réseau peut masquer ceux qui ne concernent pas ses clients.

## Commencer

::::cards{cols=3}
:::card{title="Niveaux d'administration" href="/v1.0/droits-et-profils/niveaux-d-administration" icon="Layers"}
Propriétaire, administrateurs d'applications, de réseau, de client, utilisateur.
:::
:::card{title="Droits applicatifs et profils" href="/v1.0/droits-et-profils/droits-et-profils" icon="ShieldCheck"}
Le modèle : codes de droits, profils, matrice par environnement.
:::
:::card{title="Vérifier un droit" href="/v1.0/droits-et-profils/verifier-un-droit-dans-votre-application" icon="Code"}
Lire les droits de l'utilisateur dans votre code, avec un exemple complet.
:::
::::

## Fonctionnalités

::::cards{cols=2}
:::card{title="Définir vos droits" href="/v1.0/droits-et-profils/definir-les-droits-de-votre-application" icon="ListPlus"}
Déclarer le catalogue des droits de votre application et l'exporter.
:::
:::card{title="Créer un profil" href="/v1.0/droits-et-profils/creer-un-profil" icon="UserCog"}
Regrouper des droits en un profil, environnement par environnement.
:::
:::card{title="Attribuer un profil" href="/v1.0/droits-et-profils/attribuer-un-profil" icon="UserCheck"}
Donner un profil à un utilisateur, à l'invitation ou après coup.
:::
:::card{title="Masquer un profil pour un réseau" href="/v1.0/droits-et-profils/masquer-un-profil-pour-un-reseau" icon="EyeOff"}
Ne proposer aux clients d'un réseau que les profils qui les concernent.
:::
::::

## Produits liés

::::cards{cols=3}
:::card{title="Utilisateurs et équipes" href="/v1.0/utilisateurs" icon="Users"}
Inviter les utilisateurs qui recevront vos profils.
:::
:::card{title="Clés API" href="/v1.0/cles-api" icon="KeyRound"}
Donner à un serveur un profil et ses droits.
:::
:::card{title="Fonctionnalités activables" href="/v1.0/organisations/fonctionnalites-activables" icon="ToggleRight"}
Activer un module pour un client, en complément des droits.
:::
::::

## Ressources

- [Référence des droits et profils](/v1.0/droits-et-profils/reference)
- [Référence API des droits et profils](/v1.0/reference-api/droits-et-profils)
- [Résoudre les problèmes de droits](/v1.0/droits-et-profils/depannage)
