Connection Profile

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`
`cross_app_access_resource_app`	Facultatif. Détermine si les administrateurs d’Organization peuvent configurer cette connexion comme application de ressources Cross App Access (XAA) au moyen de l’API My Organization. Format : `{ "status": { "default_value": "enabled" \| "disabled", "allowed_values": ["enabled", "disabled"] } }`. Si cette propriété est omise du Connection Profile, les administrateurs d’Organization ne peuvent pas la configurer. `allowed_values` est facultatif ; lorsqu’il est défini, il doit contenir au moins deux valeurs.

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"
  ],
  "cross_app_access_resource_app": {
    "status": {
      "default_value": "disabled",
      "allowed_values": ["enabled", "disabled"]
    }
  }
}

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

Quickstarts

Auth0 Overview

Configure Auth0

Applications

Fonctionnement

Propriétés du Connection Profile

Exemple de Connection Profile

Créer et gérer Connection Profiles

Configurer à l’aide de la Management API

En savoir plus

​Fonctionnement

​Propriétés du Connection Profile

​Exemple de Connection Profile

​Créer et gérer Connection Profiles

​Configurer à l’aide de la Management API

​En savoir plus

Fonctionnement

Propriétés du Connection Profile

Exemple de Connection Profile

Créer et gérer Connection Profiles

Configurer à l’aide de la Management API

En savoir plus