Créer des organisations

Découvrez comment créer des organisations à l’aide d’Auth0 Dashboard et de la Management API.

Vous pouvez créer des organisations en utilisant soit le Auth0 Dashboard, soit la Management API.

La disponibilité varie selon votre forfait Auth0

Votre forfait Auth0 ou votre entente personnalisée a une incidence sur la disponibilité de cette fonctionnalité. Pour en savoir plus, consultez Tarification.

​

Auth0 Dashboard

Pour créer une organisation dans l’Auth0 Dashboard :

1. Accédez à Auth0 Dashboard > Organizations.

2. Sélectionnez Créer une organisation.

3. Saisissez les renseignements de base de votre organisation, puis sélectionnez Ajouter une organisation :

   Champ	Description
   Nom	Nom de l’organisation que vous souhaitez créer. Il s’agit du nom qu’un utilisateur final saisirait dans l’invite de préconnexion pour indiquer l’organisation avec laquelle il souhaite se connecter. Identifiant logique unique. Peut contenir des lettres minuscules, des chiffres, des traits de soulignement (_) et des tirets (-). Peut commencer par un chiffre. Doit comporter entre 1 et 50 caractères.
   Nom d’affichage	Nom convivial à afficher.

4. Repérez la section Image de marque et personnalisez votre organisation, puis sélectionnez Enregistrer les modifications :

   Champ	Description
   Logo de l’organisation	Logo à afficher. La résolution minimale recommandée est de 200 pixels (largeur) sur 200 pixels (hauteur).
   Couleur principale	Couleur des éléments principaux.
   Couleur d’arrière-plan de la page	Couleur de l’arrière-plan.

5. Repérez la section Métadonnées et ajoutez à l’organisation toutes les paires clé-valeur de métadonnées nécessaires, puis sélectionnez Ajouter.

​

Management API

Pour créer une organisation à l’aide de la Management API :

Effectuez un appel POST au point de terminaison Create Organizations. Assurez-vous de remplacer les valeurs fictives par les valeurs appropriées de votre locataire. Pour en savoir plus, consultez le tableau des paramètres ci-dessous.

Trouvez votre domaine Auth0

Votre domaine Auth0 est composé du nom de votre locataire, de votre sous-domaine régional (sauf si votre locataire se trouve dans la région des États-Unis et a été créé avant juin 2020), puis de .auth0.com. Par exemple, si le nom de votre locataire était travel0, votre domaine Auth0 serait travel0.us.auth0.com. (Si votre locataire se trouvait aux États-Unis et avait été créé avant juin 2020, votre nom de domaine serait alors https://travel0.auth0.com.)

Si vous utilisez des domaines personnalisés, il doit s’agir du nom de votre domaine personnalisé.

Valeur	Description
MGMT_API_ACCESS_TOKEN	Jeton d’accès pour la Management API avec le scope create:organizations.
ORG_NAME	Nom de l’organisation que vous souhaitez créer. Il s’agit du nom qu’un utilisateur final saisirait dans l’invite de préconnexion pour identifier l’organisation par laquelle il souhaite se connecter. Identifiant logique unique. Peut contenir des lettres minuscules, des chiffres, des traits de soulignement (_) et des tirets (-). Peut commencer par un chiffre. Doit contenir entre 1 et 50 caractères.
ORG_DISPLAY_NAME	Facultatif. Nom convivial de l’organisation pouvant être affiché dans le flux de connexion et les modèles de courriel.
ORG_LOGO	Facultatif. URL du logo de l’organisation.
ORG_PRIMARY_COLOR	Facultatif. Code de couleur HEX pour les éléments principaux.
ORG_BACKGROUND_COLOR	Facultatif. Code de couleur HEX pour l’arrière-plan.
KEY/VALUE	Facultatif. Paires clé-valeur de type String représentant les métadonnées de l’organisation. Maximum de 255 caractères chacune. Maximum de 25 paires de métadonnées.
CONNECTION_ID	Facultatif. ID de la connexion que vous souhaitez activer pour l’organisation indiquée. Les connexions activées s’affichent dans l’invite de connexion de l’organisation, afin que les utilisateurs puissent accéder à votre ou vos applications par leur intermédiaire.
ASSIGN_MEMBERSHIP_OPTION	Facultatif. Indique si vous souhaitez que les utilisateurs qui se connectent avec la connexion activée obtiennent automatiquement l’adhésion à l’organisation indiquée. Lorsque cette option est définie sur true, l’adhésion leur est accordée automatiquement. Lorsqu’elle est définie sur false, elle ne leur est pas accordée automatiquement.

​

Codes de statut de la réponse

Les codes de statut de réponse possibles sont les suivants :

Code de statut	Code d’erreur	Message	Cause
201		Organisation créée avec succès.
400	invalid_body	Corps de la requête non valide. Le message varie selon la cause.	Le payload de la requête n’est pas valide.
400	invalid_query_string	Chaîne de requête non valide. Le message varie selon la cause.	La chaîne de requête n’est pas valide.
401		Jeton invalide.
401		Signature non valide reçue lors de la validation du JSON Web Token.
401		L’application n’est pas globale.
403	insufficient_scope	scope insuffisant ; l’une des valeurs suivantes est attendue : create:organizations.	Tentative de lire ou d’écrire un champ non autorisé avec les scopes du Bearer Token fourni.
409	organization_conflict	Une organisation portant le même nom existe déjà.	Une organisation portant le même nom existe déjà.
429		Trop de requêtes. Vérifiez les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset.