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

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](/v1.0/authentification/depannage).

## Symptômes

- [La page Fournisseurs d'identité affiche « Accès refusé »](#la-page-fournisseurs-didentité-affiche-accès-refusé)
- [Le fournisseur n'apparaît pas sur la page de connexion](#le-fournisseur-napparaît-pas-sur-la-page-de-connexion)
- [L'annuaire du client refuse l'adresse de redirection](#lannuaire-du-client-refuse-ladresse-de-redirection)
- [La connexion revient dans l'application, puis l'API répond 401](#la-connexion-revient-dans-lapplication-puis-lapi-répond-401)
- [Discovery ne renvoie pas idp_name](#discovery-ne-renvoie-pas-idp_name)
- [Les connexions échouent du jour au lendemain](#les-connexions-échouent-du-jour-au-lendemain)

## 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](/v1.0/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é](/v1.0/sso/gerer-un-fournisseur)).

## Toujours bloqué ?

Rassemblez avant de contacter le [support](/v1.0/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.
