Créer des Organizations

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

Vous pouvez créer des organizations à l’aide de l’Auth0 Dashboard ou de l’Management API.

La disponibilité varie selon le forfait Auth0

La disponibilité de cette fonctionnalité dépend de votre forfait Auth0 ou de votre entente personnalisée. Pour en savoir plus, consultez Tarification.

​

Auth0 Dashboard

Pour créer une organisation dans 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 par laquelle il souhaite se connecter. Identifiant logique unique. Peut contenir des lettres minuscules, des chiffres, des traits de soulignement (_) et des traits d’union (-). 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 :

Faites une requête POST au point de terminaison Create Organizations. Assurez-vous de remplacer les valeurs de l’espace réservé par les valeurs appropriées de votre tenant. Pour en savoir plus, consultez le tableau des paramètres ci-dessous.

Trouvez votre domaine Auth0

Votre domaine Auth0 correspond au nom de votre tenant, suivi de votre sous-domaine régional (sauf si votre tenant 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 tenant était travel0, votre domaine Auth0 serait travel0.us.auth0.com. (Si votre tenant 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 de votre nom de domaine personnalisé.

Valeur	Description
MGMT_API_ACCESS_TOKEN	Jeton d’accès pour la Management API avec la portée 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 indiquer par quelle organisation 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 à 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 une appartenance à l’organisation indiquée. Lorsque cette option est définie sur true, les utilisateurs obtiennent automatiquement une appartenance. Lorsqu’elle est définie sur false, ils ne l’obtiennent pas automatiquement.

​

Codes d’état de la réponse

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

Code d’état	Code d’erreur	Message	Cause
201		Organisation créée avec succès.
400	invalid_body	Corps de la requête invalide. 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 invalide. Le message varie selon la cause.	La chaîne de requête n’est pas valide.
401		Jeton invalide.
401		Signature invalide reçue lors de la validation du JSON Web Token.
401		Le client n’est pas global.
403	insufficient_scope	Portée insuffisante; une des portées suivantes est requise : create:organizations.	Tentative de lire ou de modifier un champ qui n’est pas autorisé avec les portées du jeton Bearer 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.