Skip to content

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.

GuideDeveloperPartner
Required access
Propriétaire, ou droits app-rights.read et app-rights.create
Duration
10 min

This page has not been translated yet and is shown in French.

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

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.

POST/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"
  }'
TypeScript
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