Créer des organisations

Découvrez comment récupérer les rôles des membres d’une organisation à l’aide du Auth0 Dashboard et de Management API.

Vous pouvez créer des organisations à l’aide du Tableau de bord Auth0 ou de Management API.

La disponibilité varie selon le plan Auth0

Votre plan Auth0 ou votre accord personnalisé ont un impact sur la disponibilité de cette fonctionnalité. Pour en savoir plus, lisez Tarification.

​

Auth0 Dashboard

Pour créer une organisation via le Auth0 Dashboard :

1. Naviguez vers Auth0 Dashboard > Organisations.
2. Sélectionnez Créer une organisation.
3. Saisissez les informations de base pour votre organisation, et sélectionnez Ajouter une organisation :

Champ	Description
Nom	Nom de l’organization que vous souhaitez créer. Il s’agit du nom qu’un utilisateur final saisira dans l’invite de pré-connexion pour identifier l’organisation par laquelle il souhaitait se connecter. Identifiant logique unique. Peut contenir des caractères alphabétiques minuscules, des chiffres, des caractères de soulignement (_) et des tirets (–). Peut commencer par un chiffre. Il doit comporter entre 1 et 50 caractères.
Nom affiché	Nom convivial à afficher.

4. Localisez la section Branding et personnalisez votre organisation, puis sélectionnez Enregistrer les modifications :

Champ	Description
Logo de l’organization	Logo à afficher. La résolution minimale recommandée est de 200 pixels (largeur) par 200 pixels (hauteur).
Couleur primaire	Couleur pour les éléments primaires.
Couleur d’arrière-plan de la page	Couleur pour l’arrière-plan.

5. Localisez la section Métadonnées et ajoutez toutes les métadonnées nécessaires aux paires de clé/valeur à votre organisation, puis sélectionnez Ajouter.

​

Management API

Pour créer une organisation via Management API :

Effectuer un appel POST au point de terminaison Créer des organisations. Assurez-vous de remplacer les valeurs d’espace par les valeurs appropriées de votre locataire. Pour plus de détails, consultez le graphique des paramètres ci-dessous.

cURL

curl --request POST \
  --url 'https://{yourDomain}/api/v2/organizations' \
  --header 'authorization: Bearer {MGMT_API_ACCESS_TOKEN}' \
  --header 'cache-control: no-cache' \
  --header 'content-type: application/json' \
  --data '{ "name": "ORG_NAME", "display_name": "ORG_DISPLAY_NAME", "branding": [ { "logo_url": "{orgLogo}", "colors": [ { "primary": "{orgPrimaryColor}", "page_background": "{orgPageBackground}" } ] } ], "metadata": [ { "{key}": "{value}", "{key}": "{value}", "{key}": "{value}" } ] }, "enabled_connections": [ { "connection_id": "{connectionId}", "assign_membership_on_login": "{assignMembershipOption}" }, { "connection_id": "{connectionId}", "assign_membership_on_login": "{assignMembershipOption}" } ] }'

Trouvez votre domaine Auth0

Si votre domaine Auth0 est le nom de votre locataire, votre sous-domaine régional (sauf si votre locataire se trouve aux États-Unis et a été créé avant juin 2020), est .auth0.com. Par exemple, si votre nom de locataire est travel0, votre nom de domaine Auth0 sera travel0.us.auth0.com. (Si votre locataire est aux États-Unis et qu’il a été créé avant juin 2020, votre nom de domaine Auth0 sera https://travel0.auth0.com.)

Si vous utilisez des domaines personnalisés, votre domaine est le nom de votre domaine personnalisé.

Valeur	Description
MGMT_API_ACCESS_TOKEN	Jeton d’accès pour le Management API avec la permission create:organizations.
ORG_NAME	Nom de l’organization que vous souhaitez créer. Il s’agit du nom qu’un utilisateur final saisira dans l’invite de pré-connexion pour identifier l’organisation par laquelle il souhaitait se connecter. Identifiant logique unique. Peut contenir des caractères alphabétiques minuscules, des chiffres, des caractères de soulignement (_) et des tirets (–). Peut commencer par un chiffre. Il doit comporter entre 1 et 50 caractères.
ORG_DISPLAY_NAME	Facultatif. Nom convivial des organizations qui peut être affiché dans le flux de connexion et dans les modèles courriel.
ORG_LOGO	Facultatif. URL du logo de l’organization.
ORG_PRIMARY_COLOR	Facultatif. Code HEX de couleur pour les éléments primaires.
ORG_BACKGROUND_COLOR	Facultatif. Code HEX de couleur pour l’arrière-plan.
KEY/VALUE	Facultatif. Paires de clés et de valeurs représentant les métadonnées de l’organization. Maximum de 255 caractères chaque. Maximum de 10 paires de métadonnées.
CONNECTION_ID	Facultatif. ID de la connexion que vous souhaitez activer pour l’organization spécifiée. Les connexions activées sont affichées sur l’invite de connexion de l’organization, afin que les utilisateurs puissent accéder à leur(s) application(s).
ASSIGN_MEMBERSHIP_OPTION	Facultatif. Indique si vous voulez que les utilisateurs qui se connectent avec la connexion activée se voient automatiquement accorder le statut de membre de l’organization spécifiée. Si la valeur est true, les utilisateurs deviendront automatiquement membres. Lorsque défini à false, ils ne se verront pas accorder automatiquement le statut de membre.

​

Codes d’état des réponses

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

Code d’état	Code d’erreur	Message	Cause
201		organization créée avec succès.
400	invalid_body	Corps invalide de la requête. Le message varie selon la cause.	La charge utile de la requête n’est pas valide.
400	invalid_query_string	Chaîne de requête non valide. Le message varie en fonction de la cause.	La chaîne de requête n’est pas valide.
401		Jeton non valide.
401		Signature non valide reçue pour la validation du jeton Web JSON.
401		Le client n’est pas global.
403	insufficient_scope	Permission insuffisante; une des permissions suivantes était attendue : create:organizations.	Tentative de lire/écrire un champ qui n’est pas autorisé avec les permissions de jeton du porteur fourni.
409	organization_conflict	Une organisation existe déjà sous ce nom.	Une organisation existe déjà sous ce nom.
429		Trop de requêtes. Vérifiez les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset.