# Configurer un fournisseur OIDC

> Brancher l'annuaire OpenID Connect d'un client (Microsoft Entra ID, Okta, Auth0…) sur votre wakapp, de la déclaration à l'activation dans Keycloak.

Ce guide branche un annuaire OpenID Connect sur un client de votre application. Il se fait en deux temps : vous déclarez le fournisseur en brouillon pour obtenir l'URL de redirection à communiquer au client, puis vous complétez sa configuration et l'activez. L'exemple prend Microsoft Entra ID ; les autres fournisseurs OIDC suivent les mêmes étapes.

## Avant de commencer

- Le client existe et les utilisateurs qui se connecteront en SSO ont déjà un compte Wakastart chez ce client, avec un accès à l'application (voir [Utilisateurs et équipes](/v1.0/utilisateurs)).
- Un interlocuteur du client peut créer une application dans son annuaire.
- Vous connaissez le domaine de messagerie des utilisateurs, par exemple `clinique-exemple.fr`.

## Déclarer le fournisseur en brouillon

1. Dans la console Wakastart, ouvrez la page **Fournisseurs d'identité** à l'adresse `https://app.wakastart.app/identity-providers`.
2. Cliquez sur **Nouveau fournisseur**.
3. Dans l'onglet **Général** de la fenêtre **Nouveau fournisseur d'identité**, renseignez :
   - **Client** : le client concerné ;
   - **Type de fournisseur** : **OpenID Connect (OIDC)** ;
   - **Protocol** : **OIDC / OAuth2** ;
   - **Statut** : **Brouillon** ;
   - **Nom d'affichage** : le nom que verront les utilisateurs, par exemple `Clinique Exemple (Entra ID)` ;
   - **Domaine email (pour discovery)** : `clinique-exemple.fr`.
4. Cliquez sur **Enregistrer**.

Résultat : le fournisseur apparaît dans la liste avec le statut `DRAFT`. Rien n'est encore créé dans Keycloak.

## Obtenir l'URL de redirection

Le client doit déclarer dans son annuaire l'adresse vers laquelle il renverra les utilisateurs. Elle a la forme :

```text
https://auth.wakastart.app/realms/<realm du réseau>/broker/<alias du fournisseur>/endpoint
```

L'alias est attribué par Wakastart à l'enregistrement du fournisseur. Demandez l'URL exacte au [support Wakastart](/v1.0/support) en indiquant le client et le nom d'affichage du fournisseur, puis transmettez-la au client.

## Créer l'application chez le client

Côté Microsoft Entra ID, l'administrateur du client :

1. ouvre **App registrations > New registration** ;
2. choisit le type de plateforme **Web** et colle l'URL de redirection obtenue ;
3. crée un secret dans **Certificates & secrets** ;
4. vous transmet, par un canal sécurisé :
   - l'**Application (client) ID** ;
   - la valeur du secret ;
   - l'identifiant du tenant (**Directory (tenant) ID**).

Les URL du fournisseur se lisent dans son document de découverte OpenID, par exemple pour Entra ID :

```bash
curl -s "https://login.microsoftonline.com/<tenant-id>/v2.0/.well-known/openid-configuration"
```

Réponse attendue (extrait) :

```json
{
  "issuer": "https://login.microsoftonline.com/<tenant-id>/v2.0",
  "authorization_endpoint": "https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/authorize",
  "token_endpoint": "https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token",
  "userinfo_endpoint": "https://graph.microsoft.com/oidc/userinfo"
}
```

## Compléter la configuration

1. Sur la page **Fournisseurs d'identité**, cliquez sur l'action **Modifier** du fournisseur.
2. Ouvrez l'onglet **Configuration OIDC** et renseignez :
   - **Client ID \*** : l'Application (client) ID ;
   - **Client Secret \*** : la valeur du secret ;
   - **Issuer URL (Discovery)** : la valeur `issuer` ;
   - **Authorization URL** : la valeur `authorization_endpoint` ;
   - **Token URL** : la valeur `token_endpoint` ;
   - **UserInfo URL** : la valeur `userinfo_endpoint`.
3. Cliquez sur **Enregistrer**.

Renseignez toutes les URL, même si l'émetteur est fourni : c'est ce qui garantit que Keycloak dispose de chaque point de terminaison.

:::warning
Le secret donne accès à l'annuaire du client pour votre application. Ne le faites transiter ni par e-mail ni par une messagerie ; demandez au client une durée de validité et notez sa date d'expiration pour le renouveler à temps.
:::

## Activer le fournisseur

1. Sur la ligne du fournisseur, cliquez sur l'action **Activer dans Keycloak**.

Résultat : le statut passe à `ACTIVE`. Le fournisseur est créé dans le realm du réseau, sur l'instance Keycloak de production, et lié à l'organisation du client.

## Vérifier le résultat

Suivez [Tester la connexion SSO](/v1.0/sso/tester-la-connexion-sso) avec un compte du client.

## Voir aussi

- [Fonctionnement du SSO](/v1.0/sso/fonctionnement-du-sso).
- [Gérer un fournisseur d'identité](/v1.0/sso/gerer-un-fournisseur) : renouveler le secret, désactiver, supprimer.
- [Résoudre les problèmes de SSO](/v1.0/sso/depannage).
