Connection Profile

Utilisez un Connection Profile pour définir comment les paramètres privés d’une connexion Auth0 doivent être configurés lorsqu’elle est créée par des tiers.

Auth0 propose des connexions Enterprise pour authentifier les utilisateurs auprès d’un fournisseur d’identité (IdP) fédéré externe, comme Okta, Microsoft Entra ID, Google Workspace, entre autres. Une connexion configurée comprend des paramètres propres au protocole pour intégrer le single sign-on (SSO), le provisionnement des utilisateurs et les intégrations de logout avec l’IdP externe, ainsi que des paramètres privés qui régissent la façon dont la connexion interagit avec Universal Login et la fonctionnalité Organizations d’Auth0.

Le Connection Profile (CP) permet aux développeurs Auth0 de définir 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 Connection Profile qui définit les valeurs de propriétés à écrire dans la connexion chaque fois qu’elle est créée à l’aide de l’une des fonctionnalités de Delegated Administration d’Auth0.

• Portée flexible : Les profils sont aujourd’hui liés aux flux Self-Service Enterprise Configuration et Okta Express Configuration, mais ils sont conçus pour être réutilisés plus largement afin de couvrir le Provisioning, l’onboarding, la gestion des droits et les futures capacités d’Auth0.

​

Propriétés du Connection Profile

Un Connection Profile est un objet JSON qui prend en charge les propriétés configurables suivantes, lesquelles s’appliquent à toutes les connexions nouvellement créées.

Propriété	Description
connection_name_prefix_template	Représente le préfixe à utiliser pour nommer les connexions. Correspond au paramètre name d’une connexion. Cette valeur prend en charge la substitution de variables pour l’ID de l’organization et le nom de l’organization. Le workflow OIN doit remplacer ces valeurs pour générer le préfixe final. Les variables sont placées entre accolades (). Variables prises en charge : org_id : l’ID de l’organization org_name : le nom de l’organization Exemple : con-{org_id}-
enabled_features	Cette liste précise les fonctionnalités 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é sur la connexion. universal_logout : lorsqu’elle est présente, la fonctionnalité Universal Logout peut être utilisée avec cette connexion.
organization.assign_membership_on_login	Indique si les utilisateurs doivent automatiquement se voir attribuer une adhésion à l’organization au moment du login. Cela correspond à la propriété assign_membership_on_login de la sous-ressource enabled_connections de l’organization. Pour les intégrations Express Configuration avec Okta, optional est traité comme required

Valeur du Connection Profile	Valeur de assign_membership_on_login dans Enable Connections
none	false
optional	false
required	true
organization	Un objet contenant les paramètres appliqués à l’organization sous laquelle la connexion est créée.
organization.show_as_button	Indique si la connexion doit être affichée sous forme de bouton sur l’écran de login une fois qu’une organization a été choisie. Cela correspond à la valeur show_as_button de la connexion activée.

Valeur du Connection Profile	Valeur de show_as_button de la connexion
none	false
optional	true
required	true

​

Exemple de Connection Profile

{
  "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 Connection Profiles

Un Connection Profile est généré automatiquement lorsque vous utilisez la fonctionnalité Express Configuration avec Okta. En outre, vous pouvez créer et gérer des Connection Profiles à l’aide de l’Auth0 Management API.

​

Configurer à l’aide de la Management API

Pour utiliser la Management API, vous devez obtenir un jeton d’accès à la Management API. Pour gérer les Connection Profiles, les points de terminaison suivants de la Management API 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

• Express Configuration
• Gérer les utilisateurs à l’aide de l’API Management API