# SSO entreprise

> Laisser les utilisateurs d'un client se connecter à votre wakapp avec l'annuaire de leur entreprise, en OIDC, en SAML ou par connexion sociale.

Le SSO entreprise permet aux utilisateurs d'un [client](/v1.0/glossaire#client) de se connecter à votre application avec le compte de leur entreprise : Microsoft Entra ID, Okta, Google Workspace, ou tout fournisseur OpenID Connect ou SAML 2.0. Vous déclarez le [fournisseur d'identité](/v1.0/glossaire#fournisseur-didentité) du client dans la console ; Wakastart le branche dans Keycloak. Votre code de connexion ne change pas.

## Comment ça marche

```mermaid
flowchart LR
  A["Administrateur<br/>console Wakastart"] -- "1. Déclare et active" --> W["Fournisseur d'identité<br/>du client"]
  W -- "2. Créé dans le realm<br/>et lié à l'organisation du client" --> K["Keycloak"]
  U["Utilisateur du client"] -- "3. Se connecte à la wakapp" --> K
  K -- "4. Délègue l'authentification" --> I["Annuaire de l'entreprise<br/>Entra ID, Okta…"]
  I -- "5. Identité confirmée" --> K
  K -- "6. Jetons habituels" --> APP["Votre wakapp"]
```

Un fournisseur est rattaché à un client et à un domaine de messagerie. Une fois actif, Keycloak propose ce fournisseur aux utilisateurs du client, et Discovery le signale pour les adresses de ce domaine. Le fonctionnement complet est décrit dans [Fonctionnement du SSO](/v1.0/sso/fonctionnement-du-sso).

## Choisissez votre approche

::::cards{cols=3}
:::card{title="OpenID Connect" href="/v1.0/sso/configurer-un-fournisseur-oidc" icon="KeyRound"}
Microsoft Entra ID, Okta, Auth0, Keycloak ou tout fournisseur OIDC : le choix par défaut.
:::
:::card{title="SAML 2.0" href="/v1.0/sso/configurer-un-fournisseur-saml" icon="FileKey"}
Pour les annuaires qui ne parlent que SAML, comme ADFS.
:::
:::card{title="Connexion sociale" href="/v1.0/sso/ajouter-une-connexion-sociale" icon="Users"}
Google, Microsoft, GitHub ou Facebook pour des comptes personnels ou Google Workspace.
:::
::::

## Commencer

::::cards{cols=3}
:::card{title="Fonctionnement du SSO" href="/v1.0/sso/fonctionnement-du-sso" icon="Network"}
Ce que Wakastart crée dans Keycloak, et ce que le client doit fournir.
:::
:::card{title="Configurer un fournisseur OIDC" href="/v1.0/sso/configurer-un-fournisseur-oidc" icon="Settings"}
Le guide principal, de la déclaration à l'activation.
:::
:::card{title="Tester la connexion" href="/v1.0/sso/tester-la-connexion-sso" icon="FlaskConical"}
Valider le parcours avec un compte du client avant de l'annoncer.
:::
::::

## Fonctionnalités

::::cards{cols=2}
:::card{title="Un fournisseur par client" href="/v1.0/sso/fonctionnement-du-sso" icon="Building2"}
Chaque client branche son propre annuaire, sans effet sur les autres clients du réseau.
:::
:::card{title="Gestion du cycle de vie" href="/v1.0/sso/gerer-un-fournisseur" icon="RefreshCw"}
Modifier, désactiver, resynchroniser ou supprimer un fournisseur.
:::
:::card{title="Découverte par domaine" href="/v1.0/authentification/connexion-multi-tenants-par-email" icon="AtSign"}
Discovery signale le fournisseur actif pour les adresses du domaine du client.
:::
:::card{title="Mise en production" href="/v1.0/sso/liste-de-controle" icon="ListChecks"}
Les vérifications avant d'ouvrir le SSO à tous les utilisateurs du client.
:::
::::

## Produits liés

::::cards{cols=3}
:::card{title="Authentification" href="/v1.0/authentification" icon="LogIn"}
Le flux de connexion que le SSO prolonge.
:::
:::card{title="Utilisateurs et équipes" href="/v1.0/utilisateurs" icon="Users"}
Inviter les utilisateurs avant leur première connexion SSO.
:::
:::card{title="Page de connexion" href="/v1.0/page-de-connexion" icon="PanelsTopLeft"}
Habiller l'écran Keycloak où apparaît le fournisseur.
:::
::::

## Ressources

- [Référence du SSO](/v1.0/sso/reference) : champs du formulaire, statuts, URL à communiquer au client.
- [Résoudre les problèmes de SSO](/v1.0/sso/depannage).
- [Liste de contrôle](/v1.0/sso/liste-de-controle).
