Aller au contenu

Fonctionnement du SSO

Ce qu'est un fournisseur d'identité dans Wakastart, ce que la plateforme crée dans Keycloak, ses statuts et ce que le client doit fournir.

ConceptAdministrateurDéveloppeur
Voir en Markdown

Dans Wakastart, le SSO repose sur la fédération d'identité de Keycloak : Keycloak reste le serveur d'identité de votre application, et délègue l'authentification des utilisateurs d'un client à l'annuaire de leur entreprise. Wakastart gère cette délégation pour vous, client par client.

Définition

Un fournisseur d'identité est la déclaration, pour un client donné, d'un annuaire externe capable d'authentifier ses utilisateurs. Il porte :

  • le client auquel il appartient ;
  • un protocole : OIDC (OpenID Connect, OAuth2) ou SAML 2.0 ; les connexions sociales (Google, Microsoft, GitHub, Facebook) sont des fournisseurs OIDC préconfigurés ;
  • un domaine de messagerie, par exemple clinique-exemple.fr, qui sert à la découverte par e-mail ;
  • la configuration technique du protocole : identifiants du client OAuth, URL du fournisseur, certificat SAML ;
  • un statut : DRAFT (Brouillon), ACTIVE (Actif), INACTIVE (Inactif) ou SUSPENDED (Suspendu).

Un fournisseur d'identité ne crée pas d'utilisateurs Wakastart et ne donne aucun droit : il remplace seulement la saisie du mot de passe.

Pourquoi ça existe

Les clients d'une wakapp, surtout dans la santé et les grands comptes, imposent que leurs collaborateurs se connectent avec le compte de l'entreprise : départs gérés en un seul endroit, authentification forte de l'entreprise, aucun mot de passe supplémentaire. Le SSO par client répond à ce besoin sans que votre application ait à gérer un protocole de fédération.

Comment ça marche

Ce que Wakastart crée dans Keycloak

À l'activation, Wakastart :

  1. crée le fournisseur dans le realm du réseau du client, sous un alias unique construit à partir de l'identifiant du client, du type de fournisseur et d'un suffixe ;
  2. reprend la configuration saisie dans la console ;
  3. considère comme vérifiée l'adresse e-mail transmise par le fournisseur ;
  4. lie le fournisseur à l'organisation Keycloak du client.

Une modification d'un fournisseur actif est répercutée dans Keycloak. La désactivation le désactive dans Keycloak sans le supprimer ; la suppression le retire de Keycloak.

Important

Le fournisseur est créé sur l'instance Keycloak de production. Testez et ouvrez le SSO sur l'environnement de production de votre application.

Le cycle de vie

StatutSignificationDans Keycloak
DRAFTBrouillon : la configuration est enregistrée dans WakastartRien
ACTIVEActif : le fournisseur est proposé à la connexionCréé, activé, lié à l'organisation du client
INACTIVEInactif : désactivé temporairementPrésent mais désactivé
SUSPENDEDSuspenduSelon le dernier état synchronisé

Créez toujours un fournisseur en DRAFT, puis activez-le avec l'action Activer dans Keycloak : c'est elle qui pousse la configuration dans Keycloak.

À la connexion

L'utilisateur arrive sur la page de connexion Keycloak de votre application, par le flux habituel. Keycloak lui propose le fournisseur de son entreprise, le redirige vers l'annuaire, puis le ramène vers votre application avec des jetons ordinaires. Côté wakapp, rien ne distingue une session SSO d'une session par mot de passe.

Pour la connexion par e-mail, GET /discover/email renvoie idp_name et idp_type quand le client a un fournisseur actif pour le domaine de l'adresse : votre page peut l'annoncer à l'utilisateur.

Les comptes

L'identité fédérée est rattachée au compte Keycloak de l'utilisateur par son adresse e-mail. L'utilisateur doit donc exister dans Wakastart chez ce client, avec un accès à l'application, avant sa première connexion SSO : invitez-le ou créez-le d'abord (voir Utilisateurs et équipes). Ses droits restent ceux de son profil Wakastart.

Ce que le client doit fournir

ProtocoleLe client fournitWakastart lui fournit
OIDCClient ID, Client Secret, URL de l'émetteur et points de terminaison (autorisation, jetons, informations utilisateur)L'URL de redirection à déclarer dans son application OAuth
SAMLURL du service SSO, certificat de signature X.509, format NameID, éventuellement l'URL de déconnexionL'identifiant de l'entité (SP) et l'URL de consommation des assertions (ACS)
SocialClient ID et Client Secret de l'application créée chez Google, Microsoft, GitHub ou FacebookL'URL de redirection à déclarer

Dans tous les cas, l'annuaire doit transmettre l'adresse e-mail de l'utilisateur.

Exemples

  • Une clinique sous Microsoft Entra ID. Son service informatique crée une application dans Entra ID, transmet le Client ID et le secret ; vous déclarez un fournisseur OIDC pour le domaine clinique-exemple.fr et l'activez.
  • Un groupe hospitalier sous ADFS. Il fournit l'URL SSO et le certificat ; vous déclarez un fournisseur SAML.
  • Une association sous Google Workspace. Vous ajoutez une connexion sociale Google restreinte, côté Google, à son domaine.

Pour aller plus loin