Aller au contenu

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.

GuideAdministrateurDéveloppeur
Durée
10 min
Voir en Markdown

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

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