Organization ドメインの作成

Organization Discovery Domain は現在、早期アクセスとして提供されています。この機能を利用することにより、Okta の Master Subscription Agreement に定められた該当する無料トライアル条件に同意したものとみなされます。

ログインフローで Organization ドメインを使用すると、ユーザーが正しい組織を選択できるよう促すプロンプトを表示できます。設定された検証済みドメインは、ユーザーがメールアドレスを入力した際に、Auth0 がユーザーの組織を自動的に検出したり、組織候補を絞り込んだりするのに役立ちます。詳細については、Login Flows for Organizations を参照してください。

組織ドメインを作成する

Auth0 Dashboard または Auth0 Management API を使用して組織ドメインを作成します。

Auth0 Dashboard
Management API

Auth0 Dashboard で組織ドメインを作成するには:

Auth0 Dashboard > Organizations に移動します。
Domains タブを選択します。
Add Domain を選択します。
ドメイン情報とステータスを入力します。
Add Domain を選択します。

Field	Description
Domain	組織ディスカバリーに関連付けるメールドメイン (例: `Travel0.com`)。有効なドメイン形式である必要があります。所有権が確認されるまで、デフォルトでは `pending` になります。

Auth0 ドメインを特定するAuth0 ドメインは、テナント名、リージョンのサブドメイン、および auth0.com を組み合わせたものです。ただし、2020 年 6 月以前に US リージョンで作成されたテナントは除きます。例: テナント名が Travel0 でリージョンが US の場合、Auth0 ドメインは travel0.us.auth0.com です。US リージョンで 2020 年 6 月より前にテナントが作成されている場合、ドメイン名は https://travel0.auth0.com になります。Auth0 Dashboard でカスタムドメインを設定して検証済みの場合は、そのカスタムドメイン名がドメインになります。詳細は Custom Domains を参照してください。

Management API の Create Organization Discovery Domain エンドポイントを呼び出します。プレースホルダー値を、テナントに対応する適切な値に置き換えてください。

curl --request POST \
  --url 'https://{yourDomain}/api/v2/organizations/{ORGANIZATION_ID}/discovery-domains' \
  --header 'authorization: Bearer {MGMT_API_ACCESS_TOKEN}' \
  --header 'cache-control: no-cache' \
  --header 'content-type: application/json' \
  --data '{
    "domain": "{DOMAIN}",
    "status": "{STATUS}"
  }'

Placeholder	Description
`MGMT_API_ACCESS_TOKEN`	スコープ `create:organization_discovery_domains` を持つ Management API 用アクセストークン。
`ORGANIZATION_ID`	ディスカバリードメインを追加する対象の組織の ID (例: `org_abc123`)。
`DOMAIN`	必須。組織ディスカバリーに関連付けるメールドメイン (例: example.com)。
`STATUS`	任意。ドメインの初期ステータス。一般的な値: `pending`, `verified`。

Status code	Error description	Message	Cause
`201`		ディスカバリードメインが正常に作成されました。ドメインレコードが組織に追加されました。
`400`	`invalid_body`	無効なリクエストボディです。メッセージは原因に応じて異なります。	リクエストペイロードが無効です。
`400`	`invalid_query_string`	無効なクエリ文字列です。メッセージは原因に応じて異なります。	クエリ文字列が無効です。
`401`		無効なトークンです。
`403`	`insufficient_scope`	スコープが不十分です。想定されるいずれかのスコープ: `create:organization_discovery_domains`。	付与された Bearer トークンのスコープでは許可されていないフィールドを書き込もうとしました。
`409`	`conflict`	同じ名前の組織ドメインがすでに存在します。	同じ名前の組織ドメインがすでに存在します。
`429`		リクエストが多すぎます。`X-RateLimit-Limit`、`X-RateLimit-Remaining`、`X-RateLimit-Reset` ヘッダーを確認してください。

Documentation Index

​組織ドメインを作成する

組織ドメインを作成する