Aller au contenu

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.

DépannageDéveloppeurAdministrateur
Voir en Markdown

Les messages sont cités tels que l'API ou la console les affichent.

Symptômes

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 :

  1. Lisez les droits du profil dans cet environnement, avec un jeton ou une clé de cet environnement : GET /api/config/profiles/{profile}/rights.
  2. 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éponseCauseSolution
403 « Access denied: token authorized party does not match the target application »Le jeton a été émis pour une autre applicationUtilisez 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 environnementRafraîchissez le jeton ; vérifiez que l'utilisateur a une fiche dans cet environnement
409L'identité Keycloak correspond à plusieurs clientsContactez 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.