> ## Documentation Index
> Fetch the complete documentation index at: https://auth0.generaltranslation.app/llms.txt
> Use this file to discover all available pages before exploring further.

> Auth0 Dashboard と Management API を使用して Organization Discovery Domain を作成および削除する方法について説明します。

# Organization ドメインの作成

<Warning>
  Organization Discovery Domain は現在、[早期アクセス](/docs/ja-JP/troubleshoot/product-lifecycle/product-release-stages)として提供されています。この機能を利用することにより、Okta の [Master Subscription Agreement](https://www.okta.com/legal/) に定められた該当する無料トライアル条件に同意したものとみなされます。
</Warning>

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

詳細については、[Login Flows for Organizations](/docs/ja-JP/manage-users/organizations/login-flows-for-organizations) を参照してください。

<div id="create-an-organization-domain">
  ## 組織ドメインを作成する
</div>

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

<Tabs>
  <Tab title="Auth0 Dashboard">
    Auth0 Dashboard で組織ドメインを作成するには:

    1. [Auth0 Dashboard > Organizations](https://manage.auth0.com/#/organizations) に移動します。
    2. **Domains** タブを選択します。
    3. **Add Domain** を選択します。
    4. ドメイン情報とステータスを入力します。
    5. **Add Domain** を選択します。

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

  <Tab title="Management API">
    <Callout icon="file-lines" color="#0EA5E9" iconType="regular">
      <b>Auth0 ドメインを特定する</b>

      Auth0 ドメインは、テナント名、リージョンのサブドメイン、および `auth0.com` を組み合わせたものです。ただし、2020 年 6 月以前に US リージョンで作成されたテナントは除きます。

      例: テナント名が Travel0 でリージョンが US の場合、Auth0 ドメインは `travel0.us.auth0.com` です。US リージョンで 2020 年 6 月より前にテナントが作成されている場合、ドメイン名は `https://travel0.auth0.com` になります。

      Auth0 Dashboard でカスタムドメインを設定して検証済みの場合は、そのカスタムドメイン名がドメインになります。詳細は [Custom Domains](/docs/ja-JP/customize/custom-domains) を参照してください。
    </Callout>

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

    ```bash theme={null}
    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 用アクセストークン](/docs/ja-JP/tokens/management-api-access-tokens)。 |
    | `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` ヘッダーを確認してください。 |                                                   |
  </Tab>
</Tabs>