> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev-fix-docs-5528-php-updates.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# サブドメインURLプレースホルダー

> アプリケーション構成でサブドメイン機能のプレースホルダー（ワイルドカードプレースホルダーや組織プレースホルダーなど）について説明します。

さまざまなプレースホルダーを使用して、URLで動的なテキストエントリとして機能させることができます。

## URL評価の仕組み

`{organization_name}`プレースホルダーを含むURLは、次のすべての条件が満たされた場合にのみ評価されます。

* アプリケーションで`organization_usage`が`allow`または`require`に設定されている
* トランザクションが組織のコンテキストで実行された（たとえば、次の組織パラメーターを使用して承認トランザクションを開始します`/authorize?organization=org_bVss9Do3994SIbiH&…`）

`{organization_name}`プレースホルダーを含むURLは、完全一致URL（`https://app.exampleco.com`）およびワイルドカードを含むURL（`https://*.exampleco.com`）に加えて評価されます。URLの評価の特定の順序に依存しないでください。

ワイルドカードと組織のプレースホルダーを含むURLをアプリケーションの同じ構成フィールドに登録することは避けてください。望ましくない動作を引き起こし、トラブルシューティングが困難になる可能性があります。例として、2つの**許可されたコールバックURL** を持つアプリケーションを考えてみましょう。`https://*.exampleco.com`および`https://{organization_name}.exampleco.com`。テナントに`company-a`という名前の組織が登録されていない場合でも、値が`https://company-a.exampleco.com`の`redirect_uri`は有効とみなされます。これは、ワイルドカードプレースホルダーの評価によるものです。

## ワイルドカードURLのプレースホルダー

サブドメイン内のワイルドカードプレースホルダーは、運用アプリケーションでは使用**しないでください** 。Auth0は、該当する場合、`{organization_name}`プレースホルダーを含むURLを推奨します。

これらの設定は、[Dashboard > Applications（アプリケーション） > Applications（アプリケーション）](https://manage.auth0.com/#/applications)の次のフィールドで管理します。

* **Allowed Callback URL（許可されているコールバックURL）** ：Auth0が認証後にユーザーをリダイレクトできるURLのリスト。
* **Allowed Logout URLs（許可されているログアウトURL）** ：ユーザーがAuth0からログアウトした後にリダイレクトできるURLのリスト。
* **Allows Web Origins（Webオリジンの許可）** ：[クロスオリジン認証](/docs/ja-jp/authenticate/login/cross-origin-authentication)、[デバイスフロー](/docs/ja-jp/get-started/authentication-and-authorization-flow/device-authorization-flow)、および[web\_message](/docs/ja-jp/authenticate/protocols/oauth)を応答モードとして使用する認可要求が発信元に使用できるURLのリスト。
* **Allowed Origins (CORS)（許可されているオリジン（CORS））** ：JavaScriptからAuth0 APIへの要求を行うことが許可されるURLのリスト（通常はCORSと一緒に使用されます）。

クロスオリジン認証、デバイスフロー、および応答モードとしてweb\_messageを使用する認可要求の発信元となるURLのリスト。

星印（`*`）をサブドメインのワイルドカードですが、適切に機能するには次のルールに従って使用する必要があります。

* URLのプロトコルは`http`または`https`である**必要があります** 。`com.example.app`や`service:jmx:rmi`などのプロトコルは機能しません。
* ワイルドカードは、ホスト名コンポーネント内のサブドメインに配置する**必要があります** 。`https://*.com`は機能しません。
* ワイルドカードは、ルートドメインから最も遠いサブドメインに配置する**必要があります** 。`https://sub.*.example.com`は機能しません。
* URLには複数のワイルドカードを含めることは**できません** 。`https://*.*.example.com`は機能しません。
* ワイルドカードには、追加の有効なホスト名文字をプレフィックスまたはサフィックスとして付けることが**できます** 。`https://prefix-*-suffix.example.com`は機能します。
* 有効なワイルドカードを使用したURLは、ワイルドカードの代わりに1つ以上のサブドメインレベルURLに一致**しません** 。`https://*.example.com`は`https://sub1.sub2.example.com`では機能しません。

## 組織のURLプレースホルダー

`{organization_name}`をプレースホルダーとして使用して、登録済みの組織の名前をURL（`https://{organization_name}.exampleco.com`）に動的に指定できます。 ({organization_name}.exampleco.com) です。`{organization_name}`プレースホルダーを含むURLは、ご自身が完全に管理しているドメインでのみ使用する必要があります（例：`exampleco.com`ドメインを管理している場合に`https://{organization_name}.exampleco.com`）。

これらの設定は、[Dashboard > Applications（アプリケーション） > Applications（アプリケーション）](https://manage.auth0.com/#/applications)の次のフィールドで管理します。

* **Allowed Callback URL（許可されているコールバックURL）** ：Auth0が認証後にユーザーをリダイレクトできるURLのリスト。
* **Allowed Origins (CORS)（許可されているオリジン（CORS））** ：JavaScriptからAuth0 APIへの要求を行うことが許可されるURLのリスト（通常はCORSと一緒に使用されます）。

`{organization_name}`プレースホルダーを使用する場合、次の制限が適用されます。

* URLのプロトコルは`http:`または`https:`である必要があります。`com.example.app://{organization_name}.exampleco.com`は機能しません。
* プレースホルダーは、ホスト名コンポーネント内のサブドメインに配置する必要があります。`https://{organization_name}`または`https://exampleco.com/{organization_name}`はどちらも機能しません。
* プレースホルダーは、ルートドメインから最も遠いサブドメインに配置する必要があります。`https://sub.{organization_name}.exampleco.com`は機能しません。
* URLには複数のプレースホルダーを含めることはできません。`https://{organization_name}.{organization_name}.exampleco.com`は機能しません。
* プレースホルダーには、追加の有効なホスト名文字をプレフィックスまたはサフィックスとして付けることはできません。`https://prefix-{organization_name}-suffix.exampleco.com`は機能しません。
* プレースホルダーは、URL内のワイルドカードと組み合わせて使用​​することは**できません** 。`https://{organization_name}.*.exampleco.com`は機能しません。

## もっと詳しく

* [機密アプリケーションと公開アプリケーション](/docs/ja-jp/get-started/applications/confidential-and-public-applications)
* [ファーストパーティーアプリケーションとサードパーティーアプリケーション](/docs/ja-jp/get-started/applications/first-party-and-third-party-applications)
* [サードパーティアプリケーションを有効にする](/docs/ja-jp/get-started/applications/third-party-applications/configure-third-party-applications)
