Application Profiles

Application Profilesを使用すると、テナント内の複数のアプリケーションに自動で適用されるランタイム設定ポリシーを定義できます。これにより、アプリケーションを1つずつ設定しなくても、リフレッシュトークンの有効期間やOrganizationの動作などのアプリケーション設定を統一できます。 Application Profiles EAは、動的に作成されるClient ID Metadata Document (CIMD) アプリケーションを対象としています。動的CIMDアプリケーションは、Auth0 DashboardやManagement APIで手動作成されるのではなく、メタデータURLを指定することで、ランタイムに自身を登録します。CIMD標準には、OAuth 2.0クライアントの動作を制御するためにメタデータで指定できるパラメーターが定義されていますが、Auth0固有のパラメーターは含まれていません。そのため、何も対策をしなければ、すべてのCIMDアプリケーションが同じデフォルト値を使用することになります。Application Profilesは、Auth0固有のパラメーターに値を設定することで、メタデータを補完します。

Application Profiles EAがサポートするのは、動的に登録されたCIMDアプリケーションのみです。動的に登録されたクライアントや手動で登録されたCIMDアプリケーションはサポートされていません。詳しくは、制限事項を参照してください。

ユースケース

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) アプリケーションはローテーションを行いません。詳細については、「リフレッシュトークンのローテーションを構成する」をお読みください。
Set Idle Refresh Token Lifetime	有効にするには、Expiringに設定します。Auth0 Dashboardでは常にExpiringに設定されます。
Idle Refresh Token Lifetime	リフレッシュトークンを使用しないまま保持できる時間 (秒) です。この時間を過ぎるとリフレッシュトークンは失効し、新しいアクセストークンの取得に使用できなくなります。詳細については、「リフレッシュトークンの有効期限を構成する」をお読みください。
Set Maximum Refresh Token Lifetime	有効にするには、Expiringに設定します。Auth0 Dashboardでは常にExpiringに設定されます。
Maximum Refresh Token Lifetime	リフレッシュトークンの最大有効期間 (秒) です。指定された期間内にリフレッシュトークンが交換されなかった場合、そのリフレッシュトークンは失効し、新しいアクセストークンの取得に使用できなくなります。Maximum Refresh Token Lifetimeは、常にIdle Refresh Token Lifetimeより長く設定する必要があります。詳細については、「リフレッシュトークンの有効期限を構成する」をお読みください。
Require Sender Constraining	Not RequiredまたはRequiredに設定します。詳細については、「送信者拘束」をお読みください。

Idle Refresh Token LifetimeとMaximum Refresh Token Lifetimeは、必ず両方をあわせて設定してください。互いに依存するこの2つの設定のうち、一方だけを上書きすることはできません。一方だけを上書きすると、アプリケーション独自の値やプラットフォームのデフォルト値とマージされた際に、無効な組み合わせになるおそれがあるためです。

設定	説明
Types of Users	このアプリケーションにログインするユーザーの種類を定義します。Individuals、Business Users、Bothのいずれかに設定します。詳細については、「アプリケーションのログインエクスペリエンスを構成する」をお読みください。
Login Initiation Prompt	このアプリケーションのユーザーに対して、ログインフローをどのように開始するかを定義します。認証情報の入力を求める、組織の選択を求める、No Promptのいずれかに設定します。詳細については、「アプリケーションのログインフローを構成する」をお読みください。

Application Profilesを管理する

Application Profilesは、Auth0 DashboardまたはManagement APIを使って管理します。

Auth0 Dashboard
Management API

Auth0 DashboardでApplication Profileを作成するには、以下の手順に従います。

Applications > Application Profilesに移動します。
Application Profileのトグルをオンにします。
Settingsタブで、Application Profileの名前 (必須) と説明を入力します。
Tokensセクションで、リフレッシュトークンに関するクライアント設定を構成します。
Login Experienceタブで、Organizationsに関するクライアントの動作を構成します。

Application Profileを削除するには、トグルをオフにします。

Management API を使用してアプリケーションプロファイルを管理します。すべてのオペレーションで、該当するスコープを持つアクセストークンが必要です。

スコープ	認可
`read:client_profiles`	プロファイルの取得または一覧表示
`create:client_profiles`	プロファイルの作成
`update:client_profiles`	プロファイルの更新
`delete:client_profiles`	プロファイルの削除

アプリケーションプロファイルを作成する

アプリケーションプロファイルを作成するには、/api/v2/client-profilesエンドポイントにPOSTリクエストを送信します：

Auth0 CLI
cURL

Auth0 CLIをお使いですか？このコマンドを実行する前に、まだ済ませていない場合はCLIセッションのセットアップと認証を行ってください。

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 --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 つのみです。

{ "external_metadata_type": "cimd", "external_metadata_created_by": "client" }

リクエストが成功すると 201 Created が返され、レスポンスには完全なプロファイルオブジェクトと、新しいリソースを指す Location ヘッダーが含まれます。

アプリケーションプロファイルを取得する

アプリケーションプロファイルを取得するには、/api/v2/client-profiles/{clientId}エンドポイントにGETリクエストを送信します：

Auth0 CLI
cURL

auth0 api get "client-profiles/YOUR_PROFILE_ID"

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
cURL

auth0 api get "client-profiles"

curl --request GET \
  --url 'https://YOUR_AUTH0_DOMAIN/api/v2/client-profiles' \
  --header 'Authorization: Bearer YOUR_MANAGEMENT_API_TOKEN'

成功すると、Auth0はクライアントプロファイルオブジェクトの配列を返します：

{
  "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
cURL

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 --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
cURL

auth0 api delete "client-profiles/YOUR_PROFILE_ID"

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) アプリケーションはApplication Profileの対象外です。
特定のプロファイルが現在管理しているアプリケーションを一覧表示する方法はありません。
本来であれば一致するはずのApplication Profileから、個々のアプリケーションを除外 (オプトアウト) する方法はありません。
プロファイルによって適用されるリフレッシュトークンの設定では、パブリックアプリケーションと機密アプリケーションが区別されません。認証方法に関係なく、管理対象のすべてのアプリケーションに同じ値が適用されます。

クイックスタート

Auth0の概要

Auth0を設定する

アプリケーション

Application Profiles

ユースケース

仕組み

プロファイルの適用対象

プロファイルはテナントごとに1つのみ

サポートされているクライアント設定

トークン

Application Profilesを管理する

アプリケーションプロファイルを作成する

アプリケーションプロファイルを取得する

アプリケーションプロファイルの一覧表示

アプリケーションプロファイルを更新する

アプリケーションプロファイルを削除する

制限事項

さらに詳しく

​ユースケース

​仕組み

​プロファイルの適用対象

​プロファイルはテナントごとに1つのみ

​サポートされているクライアント設定

​トークン

​ログインエクスペリエンス

​Application Profilesを管理する

​アプリケーションプロファイルを作成する

​アプリケーションプロファイルを取得する

​アプリケーションプロファイルの一覧表示

​アプリケーションプロファイルを更新する

​アプリケーションプロファイルを削除する

​制限事項

​さらに詳しく

ユースケース

仕組み

プロファイルの適用対象

プロファイルはテナントごとに1つのみ

サポートされているクライアント設定

トークン

ログインエクスペリエンス

Application Profilesを管理する

アプリケーションプロファイルを作成する

アプリケーションプロファイルを取得する

アプリケーションプロファイルの一覧表示

アプリケーションプロファイルを更新する

アプリケーションプロファイルを削除する

制限事項

さらに詳しく