Organizations を作成する

Auth0 Dashboard と Management API を使用して Organizations を作成する方法について説明します。

組織 は、Auth0 Dashboard または Management API のいずれかで作成できます。

利用可否は Auth0 のプランによって異なります

この機能を利用できるかどうかは、ご利用の Auth0 プランまたはカスタム契約によって異なります。詳しくは、Pricing をご覧ください。

​

Auth0 Dashboard

Auth0 Dashboard で organization を作成するには、次の手順に従います。

1. Auth0 Dashboard > Organizations に移動します。

2. Create Organization を選択します。

3. organization の基本情報を入力し、Add Organization を選択します。

   Field	Description
   Name	作成する organization の名前です。これは、エンドユーザーがどの organization からログインするかを識別するために pre-login prompt に入力する名前です。一意の論理識別子で、小文字のアルファベット、数字、アンダースコア (_) 、ダッシュ (-) を使用できます。数字で始めることもできます。1 文字以上 50 文字以下である必要があります。
   Display Name	表示用のわかりやすい名前です。

4. Branding セクションで organization をカスタマイズし、変更を保存 を選択します。

   Field	Description
   Organization Logo	表示するロゴです。推奨される最小解像度は、幅 200 ピクセル、高さ 200 ピクセルです。
   Primary Color	主要な要素に使用する色です。
   Page Background Color	背景に使用する色です。

5. メタデータ セクションで、organization に必要なメタデータのキーと値のペアを追加し、Add を選択します。

​

Management API

Management API を使用して organization を作成するには:

Create Organizations エンドポイントに POST リクエストを送信します。プレースホルダー値は テナント の適切な値に置き換えてください。詳細については、以下のパラメータ一覧を参照してください。

Auth0ドメインを確認する

Auth0ドメインは、テナント名、リージョンサブドメイン (テナントが US リージョンにあり、2020 年 6 月より前に作成されている場合を除く) 、および .auth0.com を組み合わせたものです。たとえば、テナント名が travel0 の場合、Auth0ドメイン名は travel0.us.auth0.com になります。 (テナントが US にあり、2020 年 6 月より前に作成されている場合、ドメイン名は https://travel0.auth0.com になります。)

カスタムドメインを使用している場合は、ここにはそのカスタムドメイン名を指定します。

値	説明
MGMT_API_ACCESS_TOKEN	スコープ create:organizations を持つ Access Token for the Management API。
ORG_NAME	作成する organization の名前。これは、エンドユーザーが pre-login prompt で、どの organization を通じてログインするかを識別するために入力する名前です。一意の論理識別子です。使用できるのは、小文字のアルファベット、数字、アンダースコア (_) 、ダッシュ (-) です。数字で始めることもできます。1 文字以上 50 文字以下である必要があります。
ORG_DISPLAY_NAME	任意。ログインフローやメールテンプレートに表示できる、organization のわかりやすい名前です。
ORG_LOGO	任意。organization のロゴの URL。
ORG_PRIMARY_COLOR	任意。主要な要素に使用する HEX カラーコード。
ORG_BACKGROUND_COLOR	任意。背景の HEX カラーコード。
KEY/VALUE	任意。organization のメタデータを表す String のキーと値のペア。各項目は最大 255 文字です。メタデータのペアは最大 25 個までです。
CONNECTION_ID	任意。指定した organization で有効にする接続の ID。有効化された接続は organization の login prompt に表示されるため、ユーザーはそれらを通じてアプリケーションにアクセスできます。
ASSIGN_MEMBERSHIP_OPTION	任意。有効化された接続でログインしたユーザーに、指定した organization のメンバーシップを自動的に付与するかどうかを示します。true に設定すると、ユーザーには自動的にメンバーシップが付与されます。false に設定すると、自動的には付与されません。

​

レスポンスステータスコード

レスポンスで返される可能性のあるステータスコードは次のとおりです。

ステータスコード	エラーコード	メッセージ	原因
201		組織が正常に作成されました。
400	invalid_body	無効なリクエスト本文です。メッセージは原因に応じて異なります。	リクエスト本文の payload が無効です。
400	invalid_query_string	無効なリクエストクエリ文字列です。メッセージは原因に応じて異なります。	クエリ文字列が無効です。
401		無効なトークンです。
401		JSON Web トークンのバリデーションで無効な署名を受信しました。
401		クライアントはグローバルではありません。
403	insufficient_scope	scope が不足しています。必要な scope のいずれか: create:organizations。	指定されたベアラートークンの scopes では許可されていないフィールドの読み取りまたは書き込みを試みました。
409	organization_conflict	同じ名前の organization がすでに存在します。	同じ名前の organization がすでに存在します。
429		リクエストが多すぎます。X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset ヘッダーを確認してください。