# Référence du SSO

> Champs du formulaire de fournisseur d'identité, statuts, types proposés, actions et URL de fédération côté Keycloak.

Les fournisseurs d'identité se gèrent dans la console Wakastart, sur la page **Fournisseurs d'identité** (`https://app.wakastart.app/identity-providers`). Il n'existe pas d'opération de l'API publique pour les gérer.

## Accès

| Action | Droit applicatif requis | Niveau minimal |
|---|---|---|
| Voir la page et la liste | « Voir les fournisseurs d'identité » (`idp.read`) | Administrateur client |
| Créer un fournisseur | « Créer un fournisseur d'identité » (`idp.create`) | Administrateur client |
| Modifier, activer, désactiver, synchroniser | « Modifier un fournisseur d'identité » (`idp.update`) et « Créer un fournisseur d'identité » (`idp.create`) | Administrateur client |
| Supprimer | « Supprimer un fournisseur d'identité » (`idp.delete`) | Administrateur client |

Un Propriétaire dispose de toutes ces actions.

## Liste des fournisseurs

| Colonne | Contenu |
|---|---|
| **Nom** | Nom d'affichage |
| **Fournisseur** | Type : `google`, `github`, `microsoft`, `facebook`, `oidc`, `saml` |
| **Protocol** | `OIDC` ou `SAML` |
| **Client** | Client propriétaire du fournisseur |
| **Domaine** | Domaine de messagerie |
| **Statut** | `DRAFT`, `ACTIVE`, `INACTIVE` ou `SUSPENDED` |
| **Actions** | **Activer dans Keycloak** (si non actif), **Désactiver dans Keycloak** (si actif), **Synchroniser avec Keycloak**, **Modifier**, **Supprimer** |

## Onglet Général

| Champ | Contraintes | Description |
|---|---|---|
| **Client** | Obligatoire | Client dont les utilisateurs se connecteront par ce fournisseur |
| **Type de fournisseur** | Google, GitHub, Microsoft, Facebook, OpenID Connect (OIDC), SAML 2.0 | Détermine le protocole et les champs de configuration |
| **Protocol** | **OIDC / OAuth2** ou **SAML 2.0** | Protocole de fédération |
| **Statut** | **Brouillon**, **Actif**, **Inactif**, **Suspendu** | Créez en **Brouillon**, puis activez avec l'action dédiée |
| **Nom d'affichage** | 100 caractères au plus, obligatoire | Nom présenté aux utilisateurs |
| **Domaine email (pour discovery)** | 100 caractères au plus | Domaine des adresses des utilisateurs, sans `@` |

## Onglet Configuration OIDC

| Champ | Description |
|---|---|
| **Client ID \*** | Identifiant de l'application déclarée chez le fournisseur |
| **Client Secret \*** | Secret de cette application |
| **Issuer URL (Discovery)** | Émetteur du fournisseur (`issuer` de son document de découverte) |
| **Authorization URL** | Point de terminaison d'autorisation (`authorization_endpoint`) |
| **Token URL** | Point de terminaison de jetons (`token_endpoint`) |
| **UserInfo URL** | Point de terminaison d'informations utilisateur (`userinfo_endpoint`) |
| **Scopes** | Prérempli avec `openid email profile` : gardez cette valeur |

Pour une connexion sociale, seuls **Client ID** et **Client Secret** sont nécessaires.

## Onglet Configuration SAML

| Champ | Description |
|---|---|
| **Single Sign-On Service URL \*** | URL du service d'authentification unique du fournisseur |
| **Single Logout Service URL** | URL de déconnexion unique, facultative |
| **Certificat de signature X.509** | Certificat PEM du fournisseur |
| **NameID Policy Format** | **Email Address**, **Persistent**, **Transient** ou **Unspecified** |

## Statuts

| Statut | Libellé | État dans Keycloak |
|---|---|---|
| `DRAFT` | Brouillon | Absent |
| `ACTIVE` | Actif | Créé, activé, lié à l'organisation du client |
| `INACTIVE` | Inactif | Désactivé |
| `SUSPENDED` | Suspendu | Inchangé depuis la dernière synchronisation |

## URL de fédération

Ces adresses sont propres à chaque fournisseur ; le support Wakastart vous les communique.

| Élément | Forme |
|---|---|
| URL de redirection (OIDC, connexion sociale) | `https://auth.wakastart.app/realms/<realm>/broker/<alias>/endpoint` |
| Identifiant d'entité du fournisseur de service (SAML) | `https://auth.wakastart.app/realms/<realm>` |
| URL de consommation des assertions (SAML) | `https://auth.wakastart.app/realms/<realm>/broker/<alias>/endpoint` |
| Métadonnées du fournisseur de service (SAML) | `https://auth.wakastart.app/realms/<realm>/broker/<alias>/endpoint/descriptor` |

`<realm>` est le realm du réseau du client ; `<alias>` est attribué à l'enregistrement du fournisseur, sous la forme `<identifiant du client>-<type>-<suffixe>`.

## Champs renvoyés par Discovery

Pour une adresse dont le domaine correspond à un fournisseur actif du client, chaque compte de `GET /discover/email` contient :

| Champ | Description |
|---|---|
| `idp_id` | Identifiant du fournisseur |
| `idp_name` | Nom d'affichage |
| `idp_type` | `OIDC` ou `SAML` |

Voir [Référence de l'authentification](/v1.0/authentification/reference#compte-renvoyé-par-discovery).
