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.
This page has not been translated yet and is shown in French.
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
| Action | Droit applicatif requis | Niveau 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
| Colonne | Contenu |
|---|---|
| Nom | Nom d'affichage |
| Fournisseur | Type : google, github, microsoft, facebook, oidc, saml |
| Protocol | OIDC ou SAML |
| Client | Client propriétaire du fournisseur |
| Domaine | Domaine de messagerie |
| Statut | DRAFT, ACTIVE, INACTIVE ou SUSPENDED |
| Actions | Activer dans Keycloak (si non actif), Désactiver dans Keycloak (si actif), Synchroniser avec Keycloak, Modifier, Supprimer |
Onglet Général
| Champ | Contraintes | Description |
|---|---|---|
| Client | Obligatoire | Client dont les utilisateurs se connecteront par ce fournisseur |
| Type de fournisseur | Google, GitHub, Microsoft, Facebook, OpenID Connect (OIDC), SAML 2.0 | Détermine le protocole et les champs de configuration |
| Protocol | OIDC / OAuth2 ou SAML 2.0 | Protocole de fédération |
| Statut | Brouillon, Actif, Inactif, Suspendu | Créez en Brouillon, puis activez avec l'action dédiée |
| Nom d'affichage | 100 caractères au plus, obligatoire | Nom présenté aux utilisateurs |
| Domaine email (pour discovery) | 100 caractères au plus | Domaine des adresses des utilisateurs, sans @ |
Onglet Configuration OIDC
| Champ | Description |
|---|---|
| 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 URL | Point de terminaison d'autorisation (authorization_endpoint) |
| Token URL | Point de terminaison de jetons (token_endpoint) |
| UserInfo URL | Point de terminaison d'informations utilisateur (userinfo_endpoint) |
| Scopes | Prérempli avec openid email profile : gardez cette valeur |
Pour une connexion sociale, seuls Client ID et Client Secret sont nécessaires.
Onglet Configuration SAML
| Champ | Description |
|---|---|
| Single Sign-On Service URL * | URL du service d'authentification unique du fournisseur |
| Single Logout Service URL | URL de déconnexion unique, facultative |
| Certificat de signature X.509 | Certificat PEM du fournisseur |
| NameID Policy Format | Email Address, Persistent, Transient ou Unspecified |
Statuts
| Statut | Libellé | État dans Keycloak |
|---|---|---|
DRAFT | Brouillon | Absent |
ACTIVE | Actif | Créé, activé, lié à l'organisation du client |
INACTIVE | Inactif | Désactivé |
SUSPENDED | Suspendu | Inchangé depuis la dernière synchronisation |
URL de fédération
Ces adresses sont propres à chaque fournisseur ; le support Wakastart vous les communique.
| Élément | Forme |
|---|---|
| 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 :
| Champ | Description |
|---|---|
idp_id | Identifiant du fournisseur |
idp_name | Nom d'affichage |
idp_type | OIDC ou SAML |