Configurer un fournisseur SAML
Brancher l'annuaire SAML 2.0 d'un client (ADFS, Shibboleth, Entra ID en SAML…) sur votre wakapp, avec son URL SSO et son certificat de signature.
- Required access
- Administrateur client ou plus, avec les droits « Créer un fournisseur d'identité » et « Modifier un fournisseur d'identité »
- Duration
- 25 min
This page has not been translated yet and is shown in French.
Choisissez SAML quand l'annuaire du client ne propose pas OpenID Connect. Comme en OIDC, vous déclarez d'abord le fournisseur en brouillon, échangez les informations de fédération avec le client, puis activez le fournisseur.
Avant de commencer
- Les utilisateurs concernés ont déjà un compte Wakastart chez ce client, avec un accès à l'application.
- Le client peut déclarer une application (un « relying party » ou « service provider ») dans son annuaire.
Déclarer le fournisseur en brouillon
- Ouvrez la page Fournisseurs d'identité à l'adresse
https://app.wakastart.app/identity-providers, puis cliquez sur Nouveau fournisseur. - Dans l'onglet Général, renseignez :
- Client : le client concerné ;
- Type de fournisseur : SAML 2.0 ;
- Protocol : SAML 2.0 ;
- Statut : Brouillon ;
- Nom d'affichage, par exemple
Groupe Exemple (ADFS); - Domaine email (pour discovery), par exemple
groupe-exemple.fr.
- Cliquez sur Enregistrer.
Résultat : le fournisseur apparaît avec le statut DRAFT.
Échanger les informations de fédération
- Demandez au support Wakastart les informations du fournisseur de service, en indiquant le client et le nom d'affichage :
- l'identifiant d'entité :
https://auth.wakastart.app/realms/<realm du réseau>; - l'URL de consommation des assertions (ACS) :
https://auth.wakastart.app/realms/<realm du réseau>/broker/<alias du fournisseur>/endpoint; - les métadonnées du fournisseur de service, publiées à l'adresse ACS suivie de
/descriptor.
- l'identifiant d'entité :
- Transmettez-les au client pour qu'il déclare votre application dans son annuaire.
- Demandez-lui en retour :
- l'URL du service d'authentification unique (Single Sign-On Service, liaison HTTP-POST ou Redirect) ;
- éventuellement l'URL de déconnexion unique ;
- le certificat de signature X.509, au format PEM ;
- la transmission de l'adresse e-mail de l'utilisateur, de préférence comme NameID au format Email Address.
Compléter la configuration
- Cliquez sur l'action Modifier du fournisseur, puis ouvrez l'onglet Configuration SAML.
- Renseignez :
- Single Sign-On Service URL * : par exemple
https://adfs.groupe-exemple.fr/adfs/ls/; - Single Logout Service URL : facultatif ;
- Certificat de signature X.509 : le certificat complet, de
-----BEGIN CERTIFICATE-----à-----END CERTIFICATE-----; - NameID Policy Format : Email Address.
- Single Sign-On Service URL * : par exemple
- Cliquez sur Enregistrer.
Activer le fournisseur
- Sur la ligne du fournisseur, cliquez sur Activer dans Keycloak.
Résultat : le statut passe à ACTIVE ; le fournisseur est créé dans Keycloak et lié à l'organisation du client.
Important
Le certificat de signature du client a une date d'expiration. Notez-la : à son renouvellement, mettez à jour le champ Certificat de signature X.509 avant la bascule, sinon les connexions échoueront.
Vérifier le résultat
Suivez Tester la connexion SSO.
Voir aussi
- Référence du SSO : formats NameID proposés.
- Gérer un fournisseur d'identité.