# Ajouter une connexion sociale

> Proposer la connexion avec Google, Microsoft, GitHub ou Facebook aux utilisateurs d'un client de votre wakapp.

Une connexion sociale est un fournisseur OIDC préconfiguré : Keycloak connaît déjà les adresses de Google, Microsoft, GitHub et Facebook. Vous lui donnez seulement les identifiants d'une application OAuth créée chez ce fournisseur. C'est aussi la voie la plus directe pour un client sous Google Workspace.

## Avant de commencer

- Les utilisateurs concernés ont un compte Wakastart chez ce client, avec la même adresse e-mail que leur compte Google, Microsoft, GitHub ou Facebook.
- Vous, ou le client, pouvez créer une application OAuth dans la console du fournisseur (Google Cloud Console, Microsoft Entra, GitHub Developer settings, Meta for Developers).

## Déclarer la connexion 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** : **Google**, **Microsoft**, **GitHub** ou **Facebook** ;
   - **Statut** : **Brouillon** ;
   - **Nom d'affichage**, par exemple `Google` ;
   - **Domaine email (pour discovery)** : le domaine des utilisateurs, par exemple `association-exemple.org`.
3. Cliquez sur **Enregistrer**.

Résultat : la connexion apparaît avec le statut `DRAFT` et le protocole `OIDC`.

## Créer l'application OAuth chez le fournisseur

1. Demandez l'URL de redirection au [support Wakastart](/v1.0/support). Elle a la forme `https://auth.wakastart.app/realms/<realm du réseau>/broker/<alias>/endpoint`.
2. Dans la console du fournisseur, créez une application OAuth de type « application web » et déclarez cette URL comme URL de redirection autorisée. Pour Google, créez un « ID client OAuth » dans **API et services > Identifiants**.
3. Récupérez le Client ID et le Client Secret.

Pour réserver la connexion Google aux comptes d'un Google Workspace, configurez l'écran de consentement en mode « Interne » dans le projet Google de l'organisation.

## Compléter et activer

1. Cliquez sur l'action **Modifier** de la connexion, puis ouvrez l'onglet **Configuration OIDC**.
2. Renseignez **Client ID \*** et **Client Secret \***. Laissez les autres champs vides : Keycloak connaît les adresses du fournisseur.
3. Cliquez sur **Enregistrer**.
4. Sur la ligne de la connexion, cliquez sur **Activer dans Keycloak**.

Résultat : le statut passe à `ACTIVE`.

## Vérifier le résultat

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

## Voir aussi

- [Configurer un fournisseur OIDC](/v1.0/sso/configurer-un-fournisseur-oidc) : pour un annuaire d'entreprise.
- [Gérer un fournisseur d'identité](/v1.0/sso/gerer-un-fournisseur).
