Skip to content

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.

GuideAdministratorDeveloper
Required access
Administrateur client ou plus, avec les droits « Créer un fournisseur d'identité » et « Modifier un fournisseur d'identité »
Duration
20 min

This page has not been translated yet and is shown in French.

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).
  • 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 :

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

Voir aussi