Définir le comportement de l’organisation

Découvrez comment définir le comportement de l’organisation dans les applications avec la fonctionnalité Organizations d’Auth0.

Lorsque vous représentez votre application dans Auth0, vous pouvez préciser quels types d’utilisateurs elle doit prendre en charge. Certaines applications permettent à des utilisateurs individuels de se connecter avec des comptes personnels, tandis que d’autres sont destinées aux membres d’organizations. Certaines doivent prendre en charge les deux. C’est ce qu’on appelle le comportement d’organisation, et il peut être défini pour chaque application que vous connectez à Auth0.

Par exemple, votre application pourrait avoir :

• Une page d’accueil marketing générique avec un bouton Se connecter qui dirige vos utilisateurs vers le login flow d’Auth0 sans organisation.
• Une URL distincte pour chacun de vos clients B2B (par ex., les utilisateurs d’Acme vont à acme.yourcompany.com) qui redirige les utilisateurs vers Auth0 avec une organisation, afin qu’ils voient le bouton SSO Login d’Acme.

Vous pouvez définir le comportement d’organisation pour permettre l’un ou l’autre de ces scénarios. De plus, vous pouvez configurer le comportement d’organisation de sorte que, si votre application exige qu’une organisation soit fournie, mais que votre utilisateur est envoyé par erreur à Auth0 sans organisation, il verra une invite lui permettant d’entrer le nom de son organisation.

Vous pouvez définir le comportement d’organisation au moyen soit du Auth0 Dashboard, soit de la Management API.

​

Auth0 Dashboard

Pour définir le comportement d’une organisation dans l’Auth0 Dashboard :

1. Accédez à Auth0 Dashboard > Applications, puis sélectionnez l’application pour laquelle vous souhaitez configurer les organisations.
2. Passez à la vue Expérience de connexion et configurez les paramètres appropriés :

Champ	Description	mappage API
Type d’utilisateurs	Détermine quelle catégorie d’utilisateurs peut se connecter à votre application. Les options comprennent : Particuliers : Les utilisateurs peuvent s’inscrire avec un compte personnel et se connecter directement à votre application. Les utilisateurs individuels ne peuvent pas se connecter à l’aide d’une organisation. Business Users : Les utilisateurs doivent être membres d’une organisation pour se connecter. Lorsque cette option est sélectionnée, vous devez soit fournir une organisation lorsque vous redirigez les utilisateurs vers le point de terminaison /authorize, soit définir votre Flux de connexion sur Prompt for organisation. Both : Les utilisateurs peuvent se connecter comme membres d’une organisation ou s’inscrire avec un compte personnel.	Type d’utilisateurs correspond à organization_usage Options : Particuliers correspond à deny Business Users correspond à require Both correspond à allow
Flux de connexion	Détermine l’invite de connexion initiale présentée aux utilisateurs lorsqu’ils accèdent à votre application. Vous ne pouvez configurer ce champ que si le type d’utilisateurs est défini sur Business Users ou Both. Les options comprennent : Prompt for Credentials : Les utilisateurs doivent d’abord saisir leurs identifiants de connexion. Après s’être connectés, ils peuvent sélectionner leur organisation. Prompt for organisation : Les utilisateurs doivent d’abord sélectionner leur organisation. Ils peuvent ensuite fournir leurs identifiants pour se connecter. Aucune invite : Auth0 ne détermine pas quelle invite de connexion est présentée aux utilisateurs. C’est plutôt votre application qui doit envoyer à Auth0 les paramètres requis pour afficher l’invite appropriée.	Flux de connexion correspond à organization_require_behavior Options : Prompt for Credentials correspond à post_login_prompt Prompt for organisation correspond à pre_login_prompt Aucune invite correspond à no_prompt
Découverte de l’organisation	Définit la méthode utilisée pour identifier l’organisation de l’utilisateur avant l’authentification. Disponible uniquement avec le Flux de connexion Prompt for organisation. Les options comprennent : Prompt for organisation Email : Les utilisateurs doivent d’abord fournir l’adresse courriel associée à leur organisation. Prompt for organisation Name : Les utilisateurs doivent d’abord fournir le nom de leur organisation. Prompt for organisation Email and Name : Les utilisateurs doivent d’abord fournir le nom de leur organisation ou l’adresse courriel qui y est associée.	Prompt for Emails : correspond à email. Prompt for organisation : correspond à organization_name. Prompt for organisation Email and Name : correspond à email et organization_name.

3. Sélectionnez Save changes.

​

Management API

Effectuez une requête PATCH vers le point de terminaison Update a Client. Assurez-vous de remplacer les valeurs de l’espace réservé client_id, mgmt_api_access_token, organization_usage et organization_require_behavior par votre ID client, le jeton d’accès de la Management API jeton d’accès, l’option d’utilisation de l’organisation et l’option de comportement de l’organisation, respectivement.

Valeur	Description
CLIENT_ID	ID de l’application pour laquelle vous voulez ajouter un comportement d’organisation.
MGMT_API_ACCESS_TOKEN	Jetons d’accès pour la Management API avec la portée update:clients.
ORGANIZATION_USAGE	Indique si votre application peut prendre en charge des utilisateurs qui se connectent à une organisation. Les options comprennent : deny : (par défaut) Les utilisateurs ne peuvent pas se connecter au moyen d’une organisation. allow : Les utilisateurs peuvent se connecter avec ou sans organisation. Lorsque cette option est sélectionnée, vous devez fournir une organisation lorsque vous redirigez les utilisateurs vers le point de terminaison /authorize. require : Les utilisateurs doivent se connecter au moyen d’une organisation. Lorsque cette option est sélectionnée, vous devez soit fournir une organisation lorsque vous redirigez les utilisateurs vers le point de terminaison /authorize, soit définir organization_require_behavior sur pre_login_prompt pour permettre aux utilisateurs de choisir une organisation avant de se connecter.
ORGANIZATION_REQUIRE_BEHAVIOR	Détermine le flux de connexion présenté aux utilisateurs qui accèdent à votre application. S’applique uniquement lorsque organization_usage est défini sur require ou allow. Les options comprennent : no_prompt : (par défaut) N’affiche aucune invite. Les requêtes sans paramètre d’organisation valide sont rejetées. pre_login_prompt : Invite les utilisateurs à sélectionner une organisation avant de pouvoir se connecter. Vous ne pouvez utiliser cette option que si organization_usage est défini sur require. post_login_prompt : Invite les utilisateurs à se connecter avec leurs informations d’identification. Après la connexion, invite les utilisateurs à sélectionner leur organisation.
ORGANIZATION_DISCOVERY_METHODS	Détermine la méthode permettant d’identifier l’organisation d’un utilisateur avant l’authentification. S’applique uniquement lorsque organization_require_behavior correspond à pre_login_prompt et que organization_usage est défini sur require ou allow. email : (par défaut) Les utilisateurs sont invités à saisir leur adresse courriel associée à leur organisation. organization_name : Les utilisateurs sont invités à saisir le nom associé à leur organisation. Organization name et email : Les utilisateurs sont invités à saisir l’adresse courriel ou le nom associé à leur organisation.

​

Codes d’état de réponse

Les codes d’état de réponse possibles sont les suivants :

Code d’état	Code d’erreur	Message	Cause
200		Client mis à jour avec succès.
400	invalid_uri	URI de requête invalide. Le message varie en fonction de la cause.	Le chemin n’est pas valide.
400	invalid_body	Corps de la requête invalide. Le message varie en fonction de la cause.	La charge utile de la requête n’est pas valide.
401		Jeton invalide.
401		Le client n’est pas global.
401		Signature invalide reçue lors de la validation du JSON Web Token.
403	insufficient_scope	Scope insuffisant; l’un des suivants est attendu : update:clients.	Tentative de lecture ou d’écriture d’un champ non autorisée avec les scopes du bearer token fournis.
403	insufficient_scope	Certains champs ne peuvent pas être mis à jour avec les permissions accordées par les scopes du bearer token. Le message varie selon les champs et les scopes.	Tentative de lecture ou d’écriture d’un champ non autorisée avec les scopes du bearer token fournis.
403	operation_not_supported	Le compte n’est pas autorisé à effectuer cette opération.	Le compte n’est pas autorisé à effectuer cette opération.
404	inexistent_client	Client introuvable.	Ressource inexistante. L’application spécifiée n’existe pas.
429		Trop de requêtes. Vérifiez les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset.