Définir le comportement de l’organisation

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 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 , soit de la .

Auth0 Dashboard

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

Accédez à Auth0 Dashboard > Applications, puis sélectionnez l’application pour laquelle vous souhaitez configurer les organisations.
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`.

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 , le jeton d’accès de la Management API , l’option d’utilisation de l’organisation et l’option de comportement de l’organisation, respectivement.

Vous utilisez l’Auth0 CLI? Si ce n’est pas déjà fait, configurez et authentifiez votre session CLI avant d’exécuter cette commande.

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.

Gérer les utilisateurs

Gestion des accès

Définir le comportement de l’organisation

Auth0 Dashboard

Management API

Codes d’état de réponse

​Auth0 Dashboard

​Management API

​Codes d’état de réponse

Auth0 Dashboard

Management API

Codes d’état de réponse