# Définir les droits de votre application

> Déclarer le catalogue des droits applicatifs de votre application, environnement par environnement, et exporter la matrice droits et profils.

Commencez par lister les actions de votre application qui doivent être réservées à certains utilisateurs, puis déclarez un droit par action. Votre code testera ces mêmes codes.

## Avant de commencer

- Vous avez le niveau Propriétaire, ou un profil qui porte `app-rights.read`, `app-rights.create`, `app-rights.update` et `app-rights.delete`.
- Choisissez vos codes : 50 caractères au plus, sous la forme `ressource.action`, par exemple `dossier.read`. Un code ne se modifie plus après la création.
- Une application compte 200 droits au plus.
- Un droit existe dans les trois environnements dès sa création : il ne peut pas être limité à certains. C'est en cochant ou non le droit pour un profil, dans la matrice de chaque environnement, que vous décidez où il est accordé.

## Créer un droit

:::::tabs{sync="voie"}
::::tab{label="Console"}
:::steps
### Ouvrir l'onglet Droits

Dans le menu latéral, sous le nom de votre application, cliquez sur **Paramétrage**, puis ouvrez l'onglet **Droits**.

Résultat : la carte **Droits de l'application** liste les droits, ou « Aucun droit défini ».

### Créer le droit

Cliquez sur **Nouveau droit**, puis renseignez :

- **Code** : par exemple `dossier.read` ;
- **Nom** : le libellé lisible, par exemple « Lire les dossiers » ;
- **Description** : facultative.

### Enregistrer

Cliquez sur **Créer**.

Résultat : le message « Droit créé » s'affiche et le droit apparaît dans la liste.
:::
::::

::::tab{label="API"}
::endpoint{method="POST" path="/api/config/app-rights"}

```bash
curl -X POST "https://api.wakastart.app/api/config/app-rights" \
  -H "Authorization: Bearer $WAKASTART_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "appId": "7a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
    "code": "dossier.read",
    "name": "Lire les dossiers",
    "category": "Dossiers"
  }'
```

```ts
const response = await fetch("https://api.wakastart.app/api/config/app-rights", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.WAKASTART_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    appId: "7a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
    code: "dossier.read",
    name: "Lire les dossiers",
    category: "Dossiers",
  }),
});
const right = await response.json();
```

Réponse attendue (extrait) :

```json
{
  "id": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
  "code": "dossier.read",
  "name": "Lire les dossiers",
  "category": "Dossiers",
  "isSystem": false
}
```

Le champ `id` sert à ajouter le droit à un profil. La catégorie (50 caractères au plus) regroupe les droits à l'affichage. Le champ `availableEnvs` n'existe plus : s'il est encore envoyé, il est ignoré.
::::
:::::

## Modifier ou supprimer un droit

- Dans **Paramétrage** > **Droits**, cliquez sur l'icône de modification pour changer **Nom** ou **Description**, puis sur **Mettre à jour**. Par l'API : `PUT /api/config/app-rights/{id}`.
- Pour supprimer, cliquez sur l'icône corbeille et confirmez « Êtes-vous sûr de vouloir supprimer ce droit ? ». Par l'API : `DELETE /api/config/app-rights/{id}`.

:::warning
Supprimer un droit le retire de tous les profils qui le contenaient, dans les trois environnements. Les utilisateurs concernés le perdent à la prochaine lecture de leurs droits.
:::

Les droits marqués système ne se modifient ni ne se suppriment.

## Exporter la matrice droits et profils

Gardez une trace de votre modèle de droits, par exemple avant une refonte.

1. Dans **Paramétrage**, ouvrez l'onglet **Matrice**.
2. Dans le sélecteur **Environnement**, choisissez **Production**, **Staging** ou **Dev** : la matrice exportée est celle de cet environnement.
3. Cliquez sur **Exporter la matrice**.

Résultat : le message « Matrice exportée » s'affiche et le navigateur télécharge `matrix-<nom de l'application>-<AAAA-MM-JJ>.json`, qui contient les droits et les profils d'application avec la matrice de l'environnement choisi. Recommencez pour chaque environnement à archiver. L'export demande le niveau Administrateur d'applications ou Propriétaire.

## Vérifier le résultat

Listez les droits de l'application :

```bash
curl "https://api.wakastart.app/api/config/app-rights/by-app/aB3dE9" \
  -H "Authorization: Bearer $WAKASTART_TOKEN"
```

La réponse contient vos codes, communs aux trois environnements.

## Voir aussi

- [Créer un profil](/v1.0/droits-et-profils/creer-un-profil)
- [Droits applicatifs et profils](/v1.0/droits-et-profils/droits-et-profils)
- [Référence API des droits et profils](/v1.0/reference-api/droits-et-profils)
