Passer au contenu principal
Auth0 fournit des connexions Enterprise pour authentifier des utilisateurs auprès d’un fournisseur d’identité (IdP) fédéré externe, comme Okta, Microsoft Entra ID, Google Workspace et d’autres. Une connexion configurée inclura des paramètres propres à chaque protocole pour intégrer l’authentification unique (SSO), le provisionnement des utilisateurs et les intégrations de déconnexion avec l’IdP externe, ainsi que des paramètres privés régissant la façon dont la connexion interagit avec les fonctionnalités Universal Login et Organizations d’Auth0.
Le profil de connexion (CP) permet aux développeurs Auth0 de spécifier comment les paramètres privés d’une connexion Auth0 doivent être configurés lorsqu’elle est créée par des tiers.

Fonctionnement

  • Définition du profil

    Un administrateur crée un profil de connexion qui définit les valeurs de propriété devant être consignées dans la connexion chaque fois qu’une connexion est créée à l’aide de l’une des fonctionnalités d’administration déléguée d’Auth0.
  • Portée flexible

    Les profils sont aujourd’hui liés aux flux Self-Service SSO et Okta Express Configuration, mais ils sont conçus pour une réutilisation plus large, couvrant le provisioning, l’intégration des nouveaux utilisateurs (onboarding), la gestion des droits d’accès (entitlement management) et les futures capacités Auth0.

Propriétés du profil de connexion

Un profil de connexion est un objet JSON qui prend en charge ces propriétés configurables, lesquelles sont appliquées à toutes les nouvelles connexions créées.
PropriétéDescription
connection_name_prefix_templateReprésente le préfixe qui doit être utilisé pour nommer les connexions. Il correspond au paramètre name sur une connexion. Cette valeur prend en charge la substitution de variables pour l’ID de l’organisation et le nom de l’organisation. Le flux de travail OIN doit remplacer ces valeurs pour générer le préfixe final. Les variables sont encadrées par des accolades ().

Variables prises en charge :

Exemple : con-{org_id}-
enabled_featuresCette liste précise les fonctionnalités qui seront prises en charge par la connexion configurée. Les fonctionnalités qui ne figurent pas dans la liste ne sont pas autorisées.

Valeurs prises en charge :
  • scim : lorsqu’elle est présente, SCIM peut être configurée sur la connexion.
  • universal_logout : lorsqu’elle est présente, la fonctionnalité de déconnexion universelle (Universal Logout) peut être utilisée avec cette connexion.
organization.assign_membership_on_loginIndique si les utilisateurs doivent automatiquement se voir attribuer un statut de membre dans l’organisation lors de la connexion. Cette propriété correspond à la propriété assign_membership_on_login de la sous‑ressource enabled_connections de l’organisation.
Pour les intégrations Express Configuration avec Okta, optional est traité comme required

Valeur du profil de connexionValeur d’assign_membership_on_login dans Enable Connections
nonefalse
optionalfalse
requiredtrue
organizationObjet contenant les paramètres qui sont appliqués à l’organisation sous laquelle la connexion est créée.
organization.show_as_buttonIndique si la connexion doit être affichée sous forme de bouton sur l’écran de connexion une fois qu’une organisation a été choisie. Cette propriété correspond à la valeur show_as_button sur la connexion activée.
Valeur du profil de connexionValeur de show_as_button de la connexion
nonefalse
optionaltrue
requiredtrue

Exemple de profil de Connexion

{
  "organization": {
    "show_as_button": "none",
    "assign_membership_on_login": "none"
  },
  "connection_name_prefix_template": "ec-{org_id}-",
  "enabled_features": [
    "scim",
    "universal_logout"
  ]
}

Créer et gérer des profils de Connexion

Un profil de Connexion est généré automatiquement lorsque vous utilisez la fonctionnalité Express Configuration avec Okta. Vous pouvez également créer et gérer des profils de Connexion à l’aide de la Management API d’Auth0.

Configurer avec la Management API

Pour utiliser la Management API, vous devez obtenir un jeton d’accès Management API. Pour gérer les profils de connexion, les points de terminaison de la Management API suivants sont disponibles :
  • POST /api/v2/connection-profiles
  • GET /api/v2/connection-profiles
  • PATCH /api/v2/connection-profiles/{id}
  • GET /api/v2/connection-profiles/{id}
  • GET /api/v2/connection-profiles/templates

En savoir plus