Aller au contenu

Ajouter une connexion sociale

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

GuideAdministrateurDéveloppeur
Accès requis
Administrateur client ou plus, avec les droits « Créer un fournisseur d'identité » et « Modifier un fournisseur d'identité »
Durée
15 min
Voir en Markdown

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. 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 avec un compte du client.

Voir aussi