> ## Documentation Index > Fetch the complete documentation index at: https://auth0.com/llms.txt > Use this file to discover all available pages before exploring further. # Application Profiles > Application Profilesを使用して、Auth0で動的に登録されたCIMDアプリケーションに一貫したランタイム設定ポリシーを適用する方法について説明します。 > [!WARNING] > > **Application Profiles機能は現在、です。** Application Profilesを使用すると、テナント内の複数のアプリケーションに自動で適用されるランタイム設定ポリシーを定義できます。これにより、アプリケーションを1つずつ設定しなくても、リフレッシュトークンの有効期間や[Organization](/docs/ja-jp/manage-users/organizations/organizations-overview.md)の動作などのアプリケーション設定を統一できます。 Application Profiles EAは、動的に作成される[Client ID Metadata Document (CIMD) ](/docs/ja-jp/get-started/auth0-overview/create-applications/cimd-overview)アプリケーションを対象としています。動的CIMDアプリケーションは、Auth0 DashboardやManagement APIで手動作成されるのではなく、メタデータURLを指定することで、ランタイムに自身を登録します。[CIMD標準](https://datatracker.ietf.org/doc/draft-ietf-oauth-client-id-metadata-document)には、OAuth 2.0クライアントの動作を制御するためにメタデータで指定できるパラメーターが定義されていますが、Auth0固有のパラメーターは含まれていません。そのため、何も対策をしなければ、すべてのCIMDアプリケーションが同じデフォルト値を使用することになります。Application Profilesは、Auth0固有のパラメーターに値を設定することで、メタデータを補完します。 Application Profiles EAがサポートするのは、動的に登録されたCIMDアプリケーションのみです。[動的に登録されたクライアント](/docs/ja-jp/get-started/applications/dynamic-client-registration.md)や[手動で登録されたCIMDアプリケーション](/docs/ja-jp/get-started/auth0-overview/create-applications/register-applications-with-cimd.md)はサポートされていません。詳しくは、[制限事項](#limitations)を参照してください。 ## ユースケース Application Profiles の主なユースケースは次のとおりです。 * **動的な CIMD アプリケーション**：メタデータ URL を指定することで、ランタイムに自身を登録するアプリケーションです。この場合、通常テナント管理者がアプリケーション設定を行う手動の作成手順が存在しません。 * **フリート管理**：1 つの設定で多数のアプリケーションをまとめて制御します。 ## 仕組み Application Profileは、テナント管理者が、そのプロファイルの対象となるクライアントのデフォルト値を指定して定義します。Auth0は、Application Profileをアプリケーションの作成時ではなく、認証リクエストのたびにランタイムで評価します。つまり、次のようになります。 * プロファイルは、一致するすべてのアプリケーションに遡って適用されます。プロファイルの作成前に登録されたアプリケーションも対象です。 * プロファイルを更新または削除すると、5分間のキャッシュ反映期間内に、次の認証リクエストから変更が有効になります。個々のアプリケーションを更新する必要はありません。 * Application Profileの設定がアプリケーションのレコードに書き込まれることはありません。設定は、認証リクエストの時点でメモリ上の設定にマージされます。 Auth0は、Application Profileの設定を最大5分間キャッシュします。プロファイルを作成、更新、または削除した後は、変更がすべての認証リクエストに反映されるまで最大5分ほどお待ちください。 ### プロファイルの適用対象 Application Profile が適用されるのは、動的に登録された CIMD アプリケーション (`external_metadata_type: cimd`、テナント管理者ではなくクライアント自身が作成したもの) のみです。手動で作成したアプリケーションは、手動で設定した CIMD アプリケーションも含め、プロファイルの対象になりません。アプリケーションを手動で作成した場合は、すべての設定をすでに直接かつ明示的に管理できるため、その設定にプロファイルが上乗せして適用されることはありません。 ### プロファイルはテナントごとに1つのみ 1つのテナントに設定できるApplication Profileは1つまでです。複数プロファイルのサポート (優先度に基づく競合解決を含む) は、今後のリリースで対応予定です。 ## サポートされているクライアント設定 Application Profilesでは、次のクライアント設定がサポートされています。 ### トークン Application Profiles EAでは、リフレッシュトークンのローテーションの動作 (`rotation_type`) をApplication Profileで構成することはできません。この動作は、各アプリケーションの認証方法に基づいて自動的に決定されます。パブリックアプリケーションはデフォルトでリフレッシュトークンをローテーションし、機密アプリケーションはローテーションしません。 | 設定 | 説明 | | - | - | | Rotation Overlap Period | 最後に使用されたリフレッシュトークンを、侵害検出をトリガーすることなく再利用できる時間 (秒) です。リフレッシュトークンのローテーションを使用するパブリックな動的 (CIMD) アプリケーションにのみ適用されます。機密の動的 (CIMD) アプリケーションはローテーションを行いません。詳細については、「[リフレッシュトークンのローテーションを構成する](/docs/ja-jp/secure/tokens/refresh-tokens/configure-refresh-token-rotation.md)」をお読みください。 | | Set Idle Refresh Token Lifetime | 有効にするには、**Expiring**に設定します。Auth0 Dashboardでは常に**Expiring**に設定されます。 | | Idle Refresh Token Lifetime | リフレッシュトークンを使用しないまま保持できる時間 (秒) です。この時間を過ぎるとリフレッシュトークンは失効し、新しいアクセストークンの取得に使用できなくなります。詳細については、「[リフレッシュトークンの有効期限を構成する](/docs/ja-jp/secure/tokens/refresh-tokens/configure-refresh-token-expiration.md)」をお読みください。 | | Set Maximum Refresh Token Lifetime | 有効にするには、**Expiring**に設定します。Auth0 Dashboardでは常に**Expiring**に設定されます。 | | Maximum Refresh Token Lifetime | リフレッシュトークンの最大有効期間 (秒) です。指定された期間内にリフレッシュトークンが交換されなかった場合、そのリフレッシュトークンは失効し、新しいアクセストークンの取得に使用できなくなります。Maximum Refresh Token Lifetimeは、常にIdle Refresh Token Lifetimeより長く設定する必要があります。詳細については、「[リフレッシュトークンの有効期限を構成する](/docs/ja-jp/secure/tokens/refresh-tokens/configure-refresh-token-expiration.md)」をお読みください。 | | Require Sender Constraining | **Not Required**または**Required**に設定します。詳細については、「[送信者拘束](/docs/ja-jp/secure/sender-constraining.md)」をお読みください。 | Idle Refresh Token LifetimeとMaximum Refresh Token Lifetimeは、必ず両方をあわせて設定してください。互いに依存するこの2つの設定のうち、一方だけを上書きすることはできません。一方だけを上書きすると、アプリケーション独自の値やプラットフォームのデフォルト値とマージされた際に、無効な組み合わせになるおそれがあるためです。 ### ログインエクスペリエンス | 設定 | 説明 | | - | - | | Types of Users | このアプリケーションにログインするユーザーの種類を定義します。**Individuals**、**Business Users**、**Both**のいずれかに設定します。詳細については、「[アプリケーションのログインエクスペリエンスを構成する](/docs/ja-jp/manage-users/organizations/login-flows-for-organizations.md#configure-the-login-experience-of-your-application)」をお読みください。 | | Login Initiation Prompt | このアプリケーションのユーザーに対して、ログインフローをどのように開始するかを定義します。**認証情報の入力を求める**、**組織の選択を求める**、**No Prompt**のいずれかに設定します。詳細については、「[アプリケーションのログインフローを構成する](/docs/ja-jp/manage-users/organizations/login-flows-for-organizations.md#configure-the-login-flow-for-your-application)」をお読みください。 | ## Application Profilesを管理する Application Profilesは、Auth0 DashboardまたはManagement APIを使って管理します。 **Auth0 Dashboard** Auth0 DashboardでApplication Profileを作成するには、以下の手順に従います。 1. **Applications > Application Profiles**に移動します。 2. **Application Profile**のトグルをオンにします。 3. **Settings**タブで、Application Profileの名前 (必須) と説明を入力します。 4. **Tokens**セクションで、リフレッシュトークンに関するクライアント設定を構成します。 5. **Login Experience**タブで、Organizationsに関するクライアントの動作を構成します。 Application Profileを削除するには、トグルをオフにします。 **Management API** Management API を使用してアプリケーションプロファイルを管理します。すべてのオペレーションで、該当するスコープを持つアクセストークンが必要です。 | スコープ | 認可 | | - | - | | `read:client_profiles` | プロファイルの取得または一覧表示 | | `create:client_profiles` | プロファイルの作成 | | `update:client_profiles` | プロファイルの更新 | | `delete:client_profiles` | プロファイルの削除 | ### アプリケーションプロファイルを作成する アプリケーションプロファイルを作成するには、`/api/v2/client-profiles`エンドポイントに`POST`リクエストを送信します： **Auth0 CLI** Auth0 CLIをお使いですか？このコマンドを実行する前に、まだ済ませていない場合は[CLIセッションのセットアップと認証](/docs/ja-jp/deploy-monitor/auth0-cli.md)を行ってください。 ```bash theme={null} auth0 api post "client-profiles" \ --data '{ "name": "Dynamic Third-Party Applications", "description": "Default runtime policy for dynamically registered third-party clients", "apply_policy": { "external_metadata_type": "cimd", "external_metadata_created_by": "client" }, "client_configuration": { "refresh_token": { "token_lifetime": { "default_value": 2592000 }, "idle_token_lifetime": { "default_value": 1296000 }, "leeway": { "default_value": 0 } }, "organization_usage": { "default_value": "deny" }, "organization_require_behavior": { "default_value": "no_prompt" }, "organization_discovery_methods": { "default_value": ["email", "organization_name"] }, "require_proof_of_possession": { "default_value": false } } }' ``` **cURL** ```bash wrap lines theme={null} curl --request POST \ --url 'https://YOUR_AUTH0_DOMAIN/api/v2/client-profiles' \ --header 'Authorization: Bearer YOUR_MANAGEMENT_API_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "name": "Dynamic Third-Party Applications", "description": "Default runtime policy for dynamically registered third-party clients", "apply_policy": { "external_metadata_type": "cimd", "external_metadata_created_by": "client" }, "client_configuration": { "refresh_token": { "token_lifetime": { "default_value": 2592000 }, "idle_token_lifetime": { "default_value": 1296000 }, "leeway": { "default_value": 0 } }, "organization_usage": { "default_value": "deny" }, "organization_require_behavior": { "default_value": "no_prompt" }, "organization_discovery_methods": { "default_value": ["email", "organization_name"] }, "require_proof_of_possession": { "default_value": false } } }' ``` `name` と `client_configuration` は必須です。`apply_policy` も必須ですが、現在指定できる値は次の 1 つのみです。 ```json theme={null} { "external_metadata_type": "cimd", "external_metadata_created_by": "client" } ``` リクエストが成功すると `201 Created` が返され、レスポンスには完全なプロファイルオブジェクトと、新しいリソースを指す `Location` ヘッダーが含まれます。 ### アプリケーションプロファイルを取得する アプリケーションプロファイルを取得するには、`/api/v2/client-profiles/{clientId}`エンドポイントに`GET`リクエストを送信します： **Auth0 CLI** ```bash theme={null} auth0 api get "client-profiles/YOUR_PROFILE_ID" ``` **cURL** ```bash wrap lines theme={null} curl --request GET \ --url 'https://YOUR_AUTH0_DOMAIN/api/v2/client-profiles/YOUR_PROFILE_ID' \ --header 'Authorization: Bearer YOUR_MANAGEMENT_API_TOKEN' ``` 成功するとプロファイルオブジェクトとともに `200 OK` を返します。指定した ID のプロファイルが存在しない場合は `404 Not Found` を返します。 ### アプリケーションプロファイルの一覧表示 すべてのアプリケーションプロファイルを一覧表示するには、`/api/v2/client-profiles`エンドポイントに`GET`リクエストを送信します： **Auth0 CLI** ```bash theme={null} auth0 api get "client-profiles" ``` **cURL** ```bash wrap lines theme={null} curl --request GET \ --url 'https://YOUR_AUTH0_DOMAIN/api/v2/client-profiles' \ --header 'Authorization: Bearer YOUR_MANAGEMENT_API_TOKEN' ``` 成功すると、Auth0はクライアントプロファイルオブジェクトの配列を返します： ```json theme={null} { "client_profiles": [ { "id": "cpr_7Yw3kBnP4mQ8vX", "name": "Dynamic Third-Party Applications", "apply_policy": { "external_metadata_type": "cimd", "external_metadata_created_by": "client" }, "client_configuration": { "..." }, "created_at": "2026-01-15T10:30:00.000Z", "updated_at": "2026-05-11T14:22:00.000Z" } ], "next": "eyJpZCI6ImNwcl83..." } ``` このエンドポイントは、チェックポイント方式のページネーションに対応しています。 ### アプリケーションプロファイルを更新する アプリケーションプロファイルを更新するには、`/api/v2/client-profiles/{clientId}`エンドポイントに`PATCH`リクエストを送信します： **Auth0 CLI** ```bash theme={null} auth0 api patch "client-profiles/YOUR_PROFILE_ID" \ --data '{ "client_configuration": { "refresh_token": { "token_lifetime": { "default_value": 2592000 }, "idle_token_lifetime": { "default_value": 604800 }, "leeway": { "default_value": 30 } }, "organization_usage": { "default_value": "allow" } } }' ``` **cURL** ```bash wrap lines theme={null} curl --request PATCH \ --url 'https://YOUR_AUTH0_DOMAIN/api/v2/client-profiles/YOUR_PROFILE_ID' \ --header 'Authorization: Bearer YOUR_MANAGEMENT_API_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "client_configuration": { "refresh_token": { "token_lifetime": { "default_value": 2592000 }, "idle_token_lifetime": { "default_value": 604800 }, "leeway": { "default_value": 30 } }, "organization_usage": { "default_value": "allow" } } }' ``` `PATCH` はトップレベルでの部分更新に対応しているため、変更するフィールド (`name`、`description`、`client_configuration`、`apply_policy`) のみを含めれば十分です。 `PATCH`リクエストに`client_configuration`および`apply_policy`パラメーターを含める場合は、オブジェクト全体を送信する必要があります。これらのオブジェクト内のネストされたフィールドだけを部分的に更新することはできません。オブジェクトで省略したサブフィールドは、以前の値が維持されるのではなく、プロファイル上で未設定として扱われます (その場合は、管理対象アプリケーション自体の設定が適用されます) 。 更新に成功すると、`200 OK` とともに、更新後のプロファイルオブジェクト全体が返されます。変更内容は、キャッシュの伝播期間である5分以内に反映されます。 ### アプリケーションプロファイルを削除する アプリケーションプロファイルを削除するには、`/api/v2/client-profiles/{clientId}`エンドポイントに`DELETE`リクエストを送信します： **Auth0 CLI** ```bash theme={null} auth0 api delete "client-profiles/YOUR_PROFILE_ID" ``` **cURL** ```bash wrap lines theme={null} curl --request DELETE \ --url 'https://YOUR_AUTH0_DOMAIN/api/v2/client-profiles/YOUR_PROFILE_ID' \ --header 'Authorization: Bearer YOUR_MANAGEMENT_API_TOKEN' ``` 指定したIDのプロファイルが存在するかどうかにかかわらず、`204 No Content` を返します。プロファイルを削除すると、そのプロファイルに一致していたすべてのアプリケーションに対する管理が直ちに解除されます。これらのアプリケーションは、次回の認証リクエスト時に、それぞれ個別に構成された設定 (またはプラットフォームのデフォルト設定) に戻ります。 ## 制限事項 これは早期アクセスリリースです。以下の制限事項があり、今後のリリースで対応される予定です。 * 1つのテナントで使用できるApplication Profileは1つのみです。 * Application Profileは、動的に登録されたCIMDアプリケーションにのみ適用されます。手動で作成されたアプリケーション (手動で構成されたCIMDアプリケーションを含む) が一致対象になることはありません。 * 本リリースでは、[Dynamic Client Registration (DCR) ](/docs/ja-jp/get-started/applications/dynamic-client-registration.md)アプリケーションはApplication Profileの対象外です。 * 特定のプロファイルが現在管理しているアプリケーションを一覧表示する方法はありません。 * 本来であれば一致するはずのApplication Profileから、個々のアプリケーションを除外 (オプトアウト) する方法はありません。 * プロファイルによって適用されるリフレッシュトークンの設定では、パブリックアプリケーションと機密アプリケーションが区別されません。認証方法に関係なく、管理対象のすべてのアプリケーションに同じ値が適用されます。 ## さらに詳しく * [CIMDの概要](/docs/ja-jp/get-started/auth0-overview/create-applications/cimd-overview) * [CIMDでアプリケーションを登録する](/docs/ja-jp/get-started/auth0-overview/create-applications/register-applications-with-cimd.md) * [Dynamic Client Registration](/docs/ja-jp/get-started/applications/dynamic-client-registration.md)