Aller au contenu

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.

RéférenceAdministrateurDéveloppeur
Voir en Markdown

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

ActionDroit applicatif requisNiveau 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

ColonneContenu
NomNom d'affichage
FournisseurType : google, github, microsoft, facebook, oidc, saml
ProtocolOIDC ou SAML
ClientClient propriétaire du fournisseur
DomaineDomaine de messagerie
StatutDRAFT, ACTIVE, INACTIVE ou SUSPENDED
ActionsActiver dans Keycloak (si non actif), Désactiver dans Keycloak (si actif), Synchroniser avec Keycloak, Modifier, Supprimer

Onglet Général

ChampContraintesDescription
ClientObligatoireClient dont les utilisateurs se connecteront par ce fournisseur
Type de fournisseurGoogle, GitHub, Microsoft, Facebook, OpenID Connect (OIDC), SAML 2.0Détermine le protocole et les champs de configuration
ProtocolOIDC / OAuth2 ou SAML 2.0Protocole de fédération
StatutBrouillon, Actif, Inactif, SuspenduCréez en Brouillon, puis activez avec l'action dédiée
Nom d'affichage100 caractères au plus, obligatoireNom présenté aux utilisateurs
Domaine email (pour discovery)100 caractères au plusDomaine des adresses des utilisateurs, sans @

Onglet Configuration OIDC

ChampDescription
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 URLPoint de terminaison d'autorisation (authorization_endpoint)
Token URLPoint de terminaison de jetons (token_endpoint)
UserInfo URLPoint de terminaison d'informations utilisateur (userinfo_endpoint)
ScopesPrérempli avec openid email profile : gardez cette valeur

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

Onglet Configuration SAML

ChampDescription
Single Sign-On Service URL *URL du service d'authentification unique du fournisseur
Single Logout Service URLURL de déconnexion unique, facultative
Certificat de signature X.509Certificat PEM du fournisseur
NameID Policy FormatEmail Address, Persistent, Transient ou Unspecified

Statuts

StatutLibelléÉtat dans Keycloak
DRAFTBrouillonAbsent
ACTIVEActifCréé, activé, lié à l'organisation du client
INACTIVEInactifDésactivé
SUSPENDEDSuspenduInchangé depuis la dernière synchronisation

URL de fédération

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

ÉlémentForme
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 :

ChampDescription
idp_idIdentifiant du fournisseur
idp_nameNom d'affichage
idp_typeOIDC ou SAML

Voir Référence de l'authentification.