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.
- 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.updateetapp-rights.delete. - Choisissez vos codes : 50 caractères au plus, sous la forme
ressource.action, par exempledossier.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.
/api/config/app-rightscurl -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"
}'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) :
{
"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.
- Dans Paramétrage, ouvrez l'onglet Matrice.
- Dans le sélecteur Environnement, choisissez Production, Staging ou Dev : la matrice exportée est celle de cet environnement.
- 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 :
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.