# Tester la connexion SSO

> Valider avec un compte du client qu'un fournisseur d'identité actif mène bien à une session dans votre wakapp, avec les bons droits.

Testez chaque fournisseur avec un vrai compte du client avant de l'annoncer à ses utilisateurs. Le test couvre la découverte, l'authentification chez le client et le retour dans votre application avec le bon profil.

## Avant de commencer

- Le fournisseur a le statut `ACTIVE` sur la page **Fournisseurs d'identité**.
- Un utilisateur de test du client possède un compte dans l'annuaire de l'entreprise **et** un compte Wakastart chez ce client, avec la même adresse e-mail et un accès à l'application en production.
- Utilisez une fenêtre de navigation privée, pour partir sans session ouverte.

## Vérifier la découverte par e-mail

Si votre application propose la connexion par e-mail, interrogez Discovery avec l'adresse du compte de test :

```bash
curl -s "https://discovery.wakastart.app/discover/email?email=test.sso%40clinique-exemple.fr&domain=portail.mon-app.fr"
```

Réponse attendue (extrait) :

```json
{
  "users": [
    {
      "user_email": "test.sso@clinique-exemple.fr",
      "customer_wid": "EXCLI1",
      "customer_name": "Clinique Exemple",
      "idp_name": "Clinique Exemple (Entra ID)",
      "idp_type": "OIDC",
      "keycloak_org_alias": "EXCLI1"
    }
  ]
}
```

`idp_name` et `idp_type` renseignés confirment que le fournisseur est actif pour le domaine de l'adresse. S'ils valent `null`, vérifiez le champ **Domaine email (pour discovery)** du fournisseur.

## Se connecter avec le compte de test

1. Ouvrez la page de connexion de votre application en production.
2. Sur la page Keycloak, choisissez le fournisseur, affiché sous son **Nom d'affichage**.
3. Authentifiez-vous dans l'annuaire du client.
4. À la première connexion, confirmez le rattachement de l'identité de l'entreprise au compte existant si Keycloak le demande.

Résultat : vous revenez dans votre application, connecté.

## Vérifier le contexte

Depuis votre serveur, appelez `GET /api/me` avec le jeton de la session (voir [Charger le contexte utilisateur](/v1.0/authentification/charger-le-contexte-utilisateur)).

Résultat attendu : `customer.wid` est celui du client du fournisseur, et `profile.rights` contient les droits du profil de l'utilisateur. Une session SSO a exactement les mêmes droits qu'une session par mot de passe.

## Vérifier le résultat

Le test est réussi quand :

- la connexion n'a demandé aucun mot de passe Wakastart ;
- `/api/me` renvoie le bon client et le bon profil ;
- la déconnexion de votre application puis une nouvelle connexion repassent par le fournisseur.

## Voir aussi

- [Liste de contrôle du SSO](/v1.0/sso/liste-de-controle).
- [Résoudre les problèmes de SSO](/v1.0/sso/depannage).
