Profil de connexion

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

• Portée flexible

​

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_template	Repré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 : org_id : l’ID de l’organisation org_name : le nom de l’organisation Exemple : con-{org_id}-
enabled_features	Cette 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_login	Indique 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 connexion Valeur d’assign_membership_on_login dans Enable Connections none false optional false required true
organization	Objet contenant les paramètres qui sont appliqués à l’organisation 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 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 connexion Valeur de show_as_button de la connexion none false optional true required true

​

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

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