# Résoudre les problèmes d'utilisateurs

> Erreurs fréquentes à l'invitation, à la création, à l'import et à la connexion des utilisateurs, avec leur cause et la solution.

Les messages sont cités tels que l'API les renvoie, dans le champ `message` de la réponse d'erreur.

## Symptômes

- [Erreur 409 à l'invitation](#erreur-409-à-linvitation)
- [La fonctionnalité invitation n'est pas activée pour ce customer](#la-fonctionnalité-invitation-nest-pas-activée-pour-ce-customer)
- [Limite d'invitations atteinte](#limite-dinvitations-atteinte)
- [Adresse e-mail refusée à l'invitation](#adresse-e-mail-refusée-à-linvitation)
- [L'environnement est refusé dans la requête](#lenvironnement-est-refusé-dans-la-requête)
- [Un utilisateur introuvable par son WID](#un-utilisateur-introuvable-par-son-wid)
- [Le realm du network n'est pas provisionné](#le-realm-du-network-nest-pas-provisionné)
- [Le lien d'invitation ne fonctionne plus](#le-lien-dinvitation-ne-fonctionne-plus)
- [L'utilisateur n'a reçu aucun e-mail](#lutilisateur-na-reçu-aucun-e-mail)
- [L'utilisateur ne peut pas se connecter à l'application](#lutilisateur-ne-peut-pas-se-connecter-à-lapplication)
- [Le fichier CSV est refusé](#le-fichier-csv-est-refusé)
- [Droit applicatif ou niveau insuffisant](#droit-applicatif-ou-niveau-insuffisant)
- [La suppression d'un utilisateur est refusée](#la-suppression-dun-utilisateur-est-refusée)

## Erreur 409 à l'invitation

**Cause** : « Un utilisateur avec cet email existe déjà » : la personne a déjà une fiche chez ce client, dans l'environnement de l'inviteur. « Une invitation est déjà en cours pour cet email » : une invitation `PENDING` existe dans ce client, dans cet environnement. Une fiche ou une invitation dans un autre environnement ne provoque pas cette erreur.

**Solution** : pour un utilisateur existant, attribuez-lui le profil voulu au lieu de l'inviter. Pour une invitation en cours, relancez-la avec `POST /api/invitations/{id}/resend`.

## La fonctionnalité invitation n'est pas activée pour ce customer

**Cause** : la case **Activer les invitations** est décochée dans le paramétrage de l'application.

**Solution** : cochez-la dans **Paramétrage** > **Invitations**. Voir [Configurer les invitations](/v1.0/utilisateurs/configurer-les-invitations).

## Limite d'invitations atteinte

**Cause** : « Limite d'invitations atteinte (N par mois). Réessayez plus tard. » L'auteur a envoyé le nombre maximal d'invitations sur les 30 derniers jours.

**Solution** : attendez, faites envoyer l'invitation par un autre administrateur, ou relevez `invitationPerUserLimit` sur l'application.

## Adresse e-mail refusée à l'invitation

**Cause** : la vérification des adresses est activée et l'adresse est invalide (« Email invalide ») ou jetable (« Les emails jetables ne sont pas autorisés »).

**Solution** : demandez une adresse professionnelle. Si l'adresse est correcte, désactivez temporairement **Vérification email obligatoire**.

## L'environnement est refusé dans la requête

**Cause** : `400` « Environment is deduced from the caller and cannot be provided ». La requête contient `env`, `envType` ou `envs` (création d'utilisateur, liste, invitation). L'environnement est toujours déduit de l'appelant : la session de l'utilisateur ou la clé API.

**Solution** : retirez le paramètre. Pour agir dans un autre environnement, appelez l'API avec un jeton ou une clé de cet environnement.

Un `401` pour un jeton, ou un `403` pour une clé, sans autre précision sur l'environnement, signale un appelant dont l'environnement ne peut pas être déduit : Wakastart ne se replie pas sur la production. Reconnectez l'utilisateur, ou utilisez une clé rattachée à un environnement.

## Un utilisateur introuvable par son WID

**Cause** : `404` sur `GET /api/config/users/{wid}` alors que la personne existe. Le WID appartient à sa fiche d'un autre environnement que celui de l'appelant : chaque fiche a son propre WID.

**Solution** : retrouvez la fiche de l'environnement de l'appelant avec `GET /api/config/users/search?email=…`. Voir [Adapter votre application aux fiches par environnement](/v1.0/utilisateurs/adapter-votre-application-aux-fiches-par-environnement).

## Le realm du network n'est pas provisionné

**Cause** : le realm du réseau n'existe pas encore sur l'instance Keycloak de l'environnement de l'inviteur.

**Solution** : contactez Wakastart en indiquant le WID du réseau et l'environnement.

## Le lien d'invitation ne fonctionne plus

**Cause** : la vérification renvoie « Cette invitation a expiré », « Cette invitation a été annulée » ou « Cette invitation a déjà été acceptée ». Après une relance, seul le dernier lien envoyé fonctionne. Un jeton mal recopié renvoie « Invalid invitation token format ».

**Solution** : relancez l'invitation expirée ou annulée et demandez à la personne d'utiliser le dernier e-mail. Si elle est déjà acceptée, la personne se connecte directement.

## L'utilisateur n'a reçu aucun e-mail

**Cause possible 1** : la réponse de création contenait `"reconciledWithoutInvite": true`. Un compte Keycloak existait déjà pour cette adresse et a été réutilisé, sans e-mail.

**Solution** : prévenez l'utilisateur qu'il se connecte avec son mot de passe habituel.

**Cause possible 2** : l'e-mail est arrivé en courrier indésirable, ou le lien de 24 heures a expiré.

**Solution** : faites vérifier les courriers indésirables. Si le lien a expiré, contactez le support Wakastart avec le WID de l'utilisateur.

## L'utilisateur ne peut pas se connecter à l'application

**Cause possible 1** : « Access denied: user does not have access to this application ». L'utilisateur n'a pas de fiche, ou pas d'accès à l'application, dans l'environnement de sa session : par exemple une personne qui n'a qu'une fiche en prod et tente de se connecter en staging.

**Solution** : créez-lui une fiche dans cet environnement, ou invitez-la, avec un jeton ou une clé de cet environnement.

**Cause possible 2** : « User account is inactive ». L'utilisateur est désactivé.

**Solution** : réactivez sa fiche de cet environnement avec `PATCH /api/config/users/{wid}/enable`.

## Le fichier CSV est refusé

| Message | Solution |
|---|---|
| « Fichier CSV requis » | Envoyez le fichier dans le champ multipart `file`. |
| « Seuls les fichiers CSV sont acceptes » | Envoyez un fichier `.csv` de type `text/csv`. |
| « Le fichier CSV est vide » | Ajoutez au moins une ligne sous l'en-tête. |
| « Le fichier CSV contient N lignes, maximum autorise: 500 » | Découpez le fichier en lots de 500 lignes. |
| « Environment cannot be deduced: import requires the caller environment » | Appelez avec une clé API rattachée à un environnement, ou avec la session d'un administrateur. |
| « Vous ne pouvez importer que dans votre propre customer » | Vérifiez `customerId` : c'est l'UUID de votre client. |
| « Insufficient credits » (402) | Rechargez les crédits du client : voir [Crédits](/v1.0/credits). |

Les erreurs propres à une ligne (« Email requis », « Format email invalide », niveau trop élevé, niveau d'administration réservé hors client, adresse qui a déjà une fiche dans cet environnement) sont listées dans `errors` du rapport ; les autres lignes sont importées.

## Droit applicatif ou niveau insuffisant

**Cause** : « Droit applicatif requis : users.create » (ou un autre code) : l'appelant n'a pas ce droit. « Niveau d'administration insuffisant. Requis: CustomerAdmin, Actuel: User » : son niveau est trop bas.

**Solution** : ajoutez le droit au profil de la clé ou de l'administrateur, ou utilisez un appelant de niveau suffisant. Voir [Droits et profils](/v1.0/droits-et-profils).

## La suppression d'un utilisateur est refusée

**Cause** : erreur 409 : l'utilisateur est encore référencé, par exemple comme auteur d'invitations.

**Solution** : désactivez-le plutôt (`PATCH /api/config/users/{wid}/disable`).

## Toujours bloqué ?

Contactez le support Wakastart avec le WID de l'utilisateur ou l'identifiant de l'invitation, l'heure de l'appel, le chemin appelé et le message d'erreur exact.
