# 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.

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

## Symptômes

- [Un droit attendu est absent de /api/me](#un-droit-attendu-est-absent-de-apime)
- [Le profil vaut Default](#le-profil-vaut-default)
- [Droit applicatif requis](#droit-applicatif-requis)
- [Niveau d'administration insuffisant](#niveau-dadministration-insuffisant)
- [Le jeton est refusé par /api/me](#le-jeton-est-refusé-par-apime)
- [Erreur 400 en ajoutant un droit à un profil](#erreur-400-en-ajoutant-un-droit-à-un-profil)
- [Erreur 409 en créant ou en renommant un profil](#erreur-409-en-créant-ou-en-renommant-un-profil)
- [Erreur 409 en créant un droit](#erreur-409-en-créant-un-droit)
- [Erreur 403 sur un profil ou un droit système](#erreur-403-sur-un-profil-ou-un-droit-système)
- [Les boutons de l'onglet Droits ou Profils échouent](#les-boutons-de-longlet-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** :

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](/v1.0/droits-et-profils/creer-un-profil#régler-les-droits-du-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](/v1.0/droits-et-profils/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](/v1.0/droits-et-profils/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.
