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

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

1. Ouvrez la page **Fournisseurs d'identité** à l'adresse `https://app.wakastart.app/identity-providers`, puis cliquez sur **Nouveau fournisseur**.
2. 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`.
3. Cliquez sur **Enregistrer**.

Résultat : le fournisseur apparaît avec le statut `DRAFT`.

## Échanger les informations de fédération

1. Demandez au [support Wakastart](/v1.0/support) 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`.
2. Transmettez-les au client pour qu'il déclare votre application dans son annuaire.
3. 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

1. Cliquez sur l'action **Modifier** du fournisseur, puis ouvrez l'onglet **Configuration SAML**.
2. 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**.
3. Cliquez sur **Enregistrer**.

## Activer le fournisseur

1. 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](/v1.0/sso/tester-la-connexion-sso).

## Voir aussi

- [Référence du SSO](/v1.0/sso/reference) : formats NameID proposés.
- [Gérer un fournisseur d'identité](/v1.0/sso/gerer-un-fournisseur).
