Résoudre les problèmes de droits
Droits absents de /api/me, refus de l'API publique, erreurs à la création d'un droit ou d'un profil - causes et solutions.
This page has not been translated yet and is shown in French.
Les messages sont cités tels que l'API ou la console les affichent.
Symptômes
- Un droit attendu est absent de /api/me
- Le profil vaut Default
- Droit applicatif requis
- Niveau d'administration insuffisant
- Le jeton est refusé par /api/me
- Erreur 400 en ajoutant un droit à un profil
- Erreur 409 en créant ou en renommant un profil
- Erreur 409 en créant un droit
- Erreur 403 sur un profil ou un droit système
- Les boutons de l'onglet Droits ou Profils échouent
Un droit attendu est absent de /api/me
Cause : profile.rights ne contient que les droits du profil dans la matrice de l'environnement de la session. Le droit est peut-être coché pour ce profil dans un autre environnement seulement : chaque matrice se règle séparément.
Solution :
- Lisez les droits du profil dans cet environnement, avec un jeton ou une clé de cet environnement :
GET /api/config/profiles/{profile}/rights. - S'il manque, cochez-le dans la matrice de cet environnement : voir Créer un profil.
Le profil vaut Default
Cause : profile vaut { "wid": "", "name": "Default" } : la fiche de l'utilisateur dans l'environnement de sa session n'a pas de profil. Un profil attribué à sa fiche d'un autre environnement ne compte pas.
Solution : attribuez un profil à sa fiche de cet environnement. Voir Attribuer un profil.
Droit applicatif requis
Cause : « Droit applicatif requis : profiles.create » (ou un autre code). L'appelant, utilisateur ou clé API, ne porte pas ce droit dans son profil.
Solution : ajoutez le droit au profil de l'appelant, ou faites l'opération avec un compte Propriétaire. Dans la console, un administrateur client sans ce droit peut afficher un onglet sans pouvoir l'enregistrer.
Niveau d'administration insuffisant
Cause : « Niveau d'administration insuffisant. Requis: CustomerAdmin, Actuel: User ». Les opérations d'administration exigent au moins le niveau Administrateur client, en plus du droit.
Solution : utilisez un appelant de niveau suffisant. Voir Niveaux d'administration.
Le jeton est refusé par /api/me
| Réponse | Cause | Solution |
|---|---|---|
| 403 « Access denied: token authorized party does not match the target application » | Le jeton a été émis pour une autre application | Utilisez le jeton obtenu par la connexion à votre application |
| 401 « Authentification requise: Bearer token (Authorization header) ou cle API (x-api-key header) » | Jeton absent, expiré, sans environnement, ou utilisateur sans fiche ni accès à l'application dans cet environnement | Rafraîchissez le jeton ; vérifiez que l'utilisateur a une fiche dans cet environnement |
| 409 | L'identité Keycloak correspond à plusieurs clients | Contactez le support Wakastart avec l'adresse de l'utilisateur |
Erreur 400 en ajoutant un droit à un profil
Cause : « Environment is deduced from the caller and cannot be provided ». La requête contient env ou envType, dans l'adresse ou dans le corps. Les routes de droits d'un profil agissent toujours dans l'environnement de l'appelant.
Solution : retirez le paramètre. Pour régler la matrice d'un autre environnement, appelez la route avec un jeton ou une clé de cet environnement.
Erreur 409 en créant ou en renommant un profil
Cause : un profil de ce nom existe déjà dans l'application. Le nom d'un profil est unique dans l'application, sans tenir compte de la casse.
Solution : choisissez un autre nom.
Erreur 409 en créant un droit
Cause : le code existe déjà dans l'application, ou l'application compte déjà 200 droits.
Solution : choisissez un autre code, ou supprimez des droits inutilisés.
Erreur 403 sur un profil ou un droit système
Cause : « Les profils système ne peuvent pas être modifiés ». Les profils et droits marqués système sont protégés.
Solution : créez votre propre profil et attribuez-le à la place.
Les boutons de l'onglet Droits ou Profils échouent
Cause : l'onglet s'affiche avec l'accès au Paramétrage, mais l'écriture exige app-rights.create, app-rights.update, profiles.create ou profiles.update. Le réglage de la matrice demande seulement le niveau Administrateur client. Le message affiché est « Droit applicatif requis : » suivi du code.
Solution : demandez ces droits, ou faites la modification avec un compte Propriétaire.
Toujours bloqué ?
Contactez le support Wakastart avec le WID de l'application, du profil et de l'utilisateur, l'environnement de la session et la réponse exacte de l'API.