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

> `enabled_clients` フィールドの使用から専用のコネクション エンドポイントへ移行するために、Auth0 のコネクション設定を更新する方法を説明します。

# Enabled Client Management から専用のコネクション エンドポイントへの移行

Auth0 は、Management API の [Get All Connections](/docs/ja-jp/api/management/v2/connections/get-connections)、[Get Connections](/docs/ja-jp/api/management/v2/connections/get-connections-by-id)、および [Update a Connection](/docs/ja-jp/api/management/v2/connections/patch-connections-by-id) での `enabled_clients` フィールドのサポートを非推奨とします。Auth0 のお客様は、[Get enabled clients for a connection](https://auth0.com/docs/api/management/v2/connections/get-connection-clients) エンドポイントを使用して、コネクションで有効になっているクライアントを取得できます。コネクションにすでに設定されているクライアントを更新するには、[Update enabled clients for a connection](https://auth0.com/docs/api/management/v2/connections/patch-clients) を使用してください。

この変更に備え、インテグレーションが今後も問題なく機能するように、以下の手順を確認して影響を受けるかどうかを確認し、新しいエンドポイントへ移行してください。

移行スケジュールの詳細については、[Deprecations and Migrations](/docs/ja-jp/troubleshoot/product-lifecycle/deprecations-and-migrations) の項目を参照してください。

<div id="verify-affected-tenants">
  ## 影響を受けるテナントを確認する
</div>

<Warning>
  Private Cloud テナントの管理者は、[Private Cloud デプロイ](/docs/ja-jp/deploy-monitor/deploy-private-cloud)のバージョンが `v202608` 以降であれば、以下の手順に従ってください。Private Cloud デプロイのバージョンの詳細については、[How to Check the Auth0 Private Cloud's Release Number and Deployment Date](https://support.auth0.com/center/s/article/How-to-check-the-Auth0-private-cloud-s-release-number-and-deployment-date)を参照してください。
</Warning>

Auth0 Dashboard を使用して、テナントで非推奨機能へのアクセスが許可されているかどうか、また移行が必要かどうかを確認できます。

1. [Auth0 Dashboard > Tenant Settings > Advanced](https://manage.auth0.com/dashboard/#/tenant/advanced) に移動します。
2. **Migrations** で、**Legacy Management of Connection's Enabled Clients toggle** を確認します。
   * トグルが **on**: テナントでは、コネクションの取得および更新時に非推奨フィールドへのアクセスが許可されているため、期限までに移行する必要があります。
   * トグルが **off**: 追加の対応は不要です。

<div id="identify-affected-integrations">
  ## 影響を受ける統合を特定する
</div>

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  * Public Cloud テナントでは、2026年2月前半からこれらの非推奨通知の受信が開始されました。
  * Private Cloud テナントでは、Private Cloud デプロイが `v202608` バージョンに達すると、これらの非推奨通知の受信が開始されました。
</Callout>

どのアプリケーションと統合で非推奨のエンドポイントが使用されているかを確認するには、テナントの[ログ](/docs/ja-jp/deploy-monitor/logs#logs)で非推奨通知を確認してください。

この非推奨に関する通知を検索するには、次のクエリを使用します。

```bash lines theme={null}
type:depnote AND description:Legacy\ Management\ of\ Connection's\ Enabled\ Clients*
```

クエリ結果の `client_id` フィールドを確認し、影響を受ける可能性があるアプリケーションを特定します。

一部の Auth0 プラットフォームサービスや拡張機能では、テナントログに非推奨に関する通知が出ることがあります。

* `client_id` フィールドが空の場合、その通知は拡張機能または Auth0 Dashboard によるものです。以下の拡張機能の使用状況を確認したうえで、Client ID のない通知は無視できます。
* 値がテナント内のどのクライアントアプリケーションとも一致しない場合、その通知はプラットフォームサービスによるものであり、無視できます。

また、特定のクライアントアプリケーションに非推奨通知があるからといって、そのアプリケーションが必ずしも影響を受けるとは限りません。たとえば、いずれかのアプリケーションが非推奨の `enabled_clients` フィールドを含む `GET` コネクション情報を取得していても、レスポンスで返されたそのフィールドを処理していなければ、そのフィールドの廃止予定による影響はありません。

<div id="review-extensions-usage">
  ## 拡張機能の利用状況を確認する
</div>

以下の拡張機能は、テナントのログに非推奨に関する通知を出すことがあります。

* [User Import/Export](/docs/ja-jp/customize/extensions/user-import-export-extension#user-import-export-extension): この拡張機能は、非推奨となった機能には依存していません。これらの通知は、この拡張機能がコネクション情報を取得する際に発生する誤検知です。
* [Custom Social Connections](https://github.com/auth0/custom-social-connections): この拡張機能は、非推奨となった機能に依存しているため、問題が発生します。
* [Delegated Administration Dashboard](/docs/ja-jp/customize/extensions/delegated-administration-extension/install-delegated-admin-extension): この拡張機能の古いバージョンは、非推奨となった機能に依存している可能性があり、問題が発生することがあります。Auth0 Dashboard からバージョン 4.8 以降に更新してください。

最初の 2 つの拡張機能は、そのユースケースに対応する Auth0 Dashboard の機能に置き換えられており、現在は更新されていません。

* User Import/Export 拡張機能の代わりに、[Bulk User Import / Export](/docs/ja-jp/manage-users/user-migration/bulk-user-import-export) の Dashboard 機能を使用してください。
* Custom Social Connections 拡張機能の代わりに、[Social Identity Providers](/docs/ja-jp/authenticate/identity-providers/social-identity-providers#auth0-dashboard) の Dashboard 機能を使用してください。

<div id="update-your-integrations">
  ## 統合を更新する
</div>

影響を受けるコネクション エンドポイントを使用して `enabled_clients` フィールドの取得 (`GET`) または更新 (`PATCH`) を行っているアプリケーションや統合では、専用のクライアント管理エンドポイントを使用するように変更する必要があります。

* **読み取り:** [コネクションで有効になっているクライアントを取得する](https://auth0.com/docs/api/management/v2/connections/get-connection-clients).
* **書き込み:** [コネクションで有効になっているクライアントを更新する](https://auth0.com/docs/api/management/v2/connections/patch-clients).

<div id="update-sdks-and-tools">
  ## SDK とツールを更新する
</div>

以下の SDK およびツールのバージョンで、新しいエンドポイントがサポートされています。

* [node-auth0](https://github.com/auth0/node-auth0): `4.25.0+`
* [go-auth0](https://github.com/auth0/go-auth0/): `1.21.0+`
* [auth0-java](https://github.com/auth0/auth0-java): `2.21.0+`
* [auth0-python](https://github.com/auth0/auth0-python): `5.1.0+`
* [auth0.net](https://github.com/auth0/auth0.net): `7.38.0+`
* [Auth0 Deploy CLI](https://auth0.com/docs/deploy-monitor/deploy-cli-tool): `8.27.0+`
* [Auth0 Terraform Provider](https://auth0.com/docs/deploy-monitor/auth0-terraform-provider): `1.29.0+`

Auth0 Deploy CLI / Auth0 Terraform Provider では、データモデル内でのコネクション と対応するクライアントの表現方法を変更する必要はありません。ツールで専用のエンドポイントが確実に使用されるよう、利用可能な最新バージョンを使用してください。

Ruby および PHP の Management API SDK は現在更新中です。

<div id="opt-out-finalize-migration">
  ## オプトアウト (移行の完了)
</div>

連携機能が非推奨の動作に依存しなくなったことを確認したら、テナントが明示的にオプトアウトするよう設定してください。

* **なぜ早めにオプトアウトするのか？** これにより、特定のテナントが新しい動作に切り替わるタイミングを正確に管理できます。予期しない問題が発生した場合でも、トグルをすぐに元に戻して、元の動作を復元できます。
* **オプトアウトする方法:** **[Auth0 Dashboard > Tenant Settings > Advanced](https://manage.auth0.com/dashboard/#/tenant/advanced)** に移動します。Migrations で、**Legacy Management of Connection's Enabled Clients** オプションをオフにします。