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
- La fonctionnalité invitation n'est pas activée pour ce customer
- Limite d'invitations atteinte
- Adresse e-mail refusée à l'invitation
- L'environnement est refusé dans la requête
- Un utilisateur introuvable par son WID
- Le realm du network n'est pas provisionné
- Le lien d'invitation ne fonctionne plus
- L'utilisateur n'a reçu aucun e-mail
- L'utilisateur ne peut pas se connecter à l'application
- Le fichier CSV est refusé
- Droit applicatif ou niveau insuffisant
- La suppression d'un 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.
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.
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. |
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.
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.