Aller au contenu

Résoudre les problèmes de SSO

Causes et solutions des problèmes de connexion par le fournisseur d'identité d'un client, de la page Fournisseurs d'identité au retour dans la wakapp.

DépannageAdministrateurDéveloppeur
Voir en Markdown

Cette page couvre les problèmes propres au SSO d'entreprise. Pour les erreurs du flux de connexion en général (Discovery, redirect URIs, jetons), voir Résoudre les problèmes de connexion.

Symptômes

La page Fournisseurs d'identité affiche Accès refusé

« Vous n'avez pas les permissions nécessaires pour accéder à cette page. »

Cause : votre profil ne porte pas le droit « Voir les fournisseurs d'identité ».

Solution : demandez à l'administrateur de votre organisation un profil qui porte les droits idp.* (voir Droits et profils).

Le fournisseur n'apparaît pas sur la page de connexion

Cause : le fournisseur n'est pas actif dans Keycloak : statut DRAFT ou INACTIVE, statut passé à Actif par le formulaire sans utiliser l'action d'activation, ou test fait sur un environnement autre que la production.

Solution :

  1. Sur la page Fournisseurs d'identité, vérifiez que le statut est ACTIVE.
  2. Si le statut est ACTIVE mais que le fournisseur reste invisible, cliquez sur Synchroniser avec Keycloak.
  3. Testez sur l'environnement de production de votre application : le fournisseur est créé sur l'instance Keycloak de production.

Pour vérifier : la page de connexion Keycloak de l'application en production affiche le Nom d'affichage du fournisseur.

L'annuaire du client refuse l'adresse de redirection

Par exemple, Microsoft Entra ID affiche « AADSTS50011: The redirect URI … does not match the redirect URIs configured for the application ».

Cause : l'URL de redirection déclarée chez le client ne correspond pas à celle du fournisseur dans Keycloak.

Solution : faites déclarer chez le client l'URL exacte communiquée par le support Wakastart, de la forme https://auth.wakastart.app/realms/<realm>/broker/<alias>/endpoint. Une suppression puis recréation du fournisseur change son alias, donc cette URL.

La connexion revient dans l'application, puis l'API répond 401

GET /api/me répond 401 avec « Authentification requise: Bearer token (Authorization header) ou cle API (x-api-key header) ».

Cause : l'utilisateur s'est authentifié chez son entreprise, mais il n'a pas de compte Wakastart chez ce client avec un accès à l'application en production, ou son adresse dans l'annuaire diffère de celle de son compte Wakastart.

Solution :

  1. Vérifiez que l'utilisateur existe chez le client, est actif et a accès à l'application en production avec un profil.
  2. Vérifiez que l'annuaire transmet la même adresse e-mail que celle du compte Wakastart.

Discovery ne renvoie pas idp_name

GET /discover/email renvoie le compte avec "idp_name": null.

Cause : le domaine de l'adresse ne correspond pas au Domaine email (pour discovery) du fournisseur, ou le fournisseur n'est pas ACTIVE.

Solution : corrigez le domaine dans l'onglet Général du fournisseur (sans @), puis vérifiez son statut.

Les connexions échouent du jour au lendemain

Cause : le secret OIDC ou le certificat SAML du client a expiré ou a été renouvelé sans mise à jour dans Wakastart.

Solution : demandez au client le nouveau secret ou le nouveau certificat, puis mettez-le à jour avec l'action Modifier (voir Gérer un fournisseur d'identité).

Toujours bloqué ?

Rassemblez avant de contacter le support :

  • le client, le nom d'affichage et le type du fournisseur ;
  • l'heure exacte de l'essai et l'adresse du compte de test ;
  • le message affiché par Keycloak ou par l'annuaire du client, à l'identique ;
  • la réponse de GET /api/me si la connexion est revenue dans l'application.