有効なクライアント管理を専用の接続エンドポイントに移行する

enabled_clients フィールドの使用から専用の接続エンドポイントへの移行に向けて、Auth0 の接続設定を更新する方法を説明します。

Auth0 は、Management API の Get All Connections、Get Connections、および Update a Connection での enabled_clients フィールドを非推奨化します。Auth0 のお客様は、Get enabled clients for a connection エンドポイントを使用して、接続で有効なクライアントを取得できます。接続にすでに設定されているクライアントを更新するには、Update enabled clients for a connection を使用します。

この変更に備え、統合が引き続き円滑に機能するよう、以下の手順を確認して影響の有無を確認し、新しいエンドポイントに移行してください。

移行スケジュールの詳細については、Deprecations and Migrations の項目を確認してください。

​

影響を受けるテナントを確認する

Private Cloud テナント管理者は、自身の Private Cloud deployment がバージョン v202608 以降であれば、以下の手順に従うことができます。Private Cloud デプロイメントのバージョンの詳細については、How to Check the Auth0 Private Cloud’s Release Number and Deployment Date を参照してください。

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

1. Auth0 Dashboard > Tenant Settings > Advanced に移動します。
2. Migrations で、Legacy Management of Connection’s Enabled Clients toggle を確認します。
   • トグルが on: 接続の取得および更新時に、テナントでは非推奨のフィールドへのアクセスが許可されています。期限までに移行する必要があります。
   • トグルが off: 追加の対応は必要ありません。

​

影響を受ける統合を特定する

• Public Cloud テナントでは、2026 年 2 月前半からこれらの非推奨通知が送信されるようになりました。
• Private Cloud テナントでは、Private Cloud のデプロイメントが v202608 バージョンに達した時点から、これらの非推奨通知が送信されるようになりました。

どのアプリケーションと統合で非推奨のエンドポイントが使用されているかを確認するには、テナントのログで非推奨通知を確認してください。詳しくは、Check for Deprecation Errorsを参照してください。

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

type:depnote AND description:Legacy\ Management\ of\ Connection's\ Enabled\ Clients*

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

一部の Auth0 プラットフォームサービスおよび拡張機能により、テナントログに非推奨通知が記録されることがあります。

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

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

​

拡張機能の使用状況を確認する

次の拡張機能では、テナントログに非推奨に関する通知が表示されることがあります。

• User Import/Export: この拡張機能は、非推奨の機能に依存していません。これらの通知は、拡張機能が接続情報を取得した際に発生する誤検知です。
• Custom Social Connections: この拡張機能は、非推奨の機能に依存しているため、問題が発生します。
• Delegated Administration Dashboard: この拡張機能の古いバージョンは、非推奨の機能に依存している可能性があり、問題が発生することがあります。Auth0 Dashboard からバージョン 4.8 以降に更新してください。

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

• 一括ユーザーインポート / エクスポート の Dashboard 機能を使用して、User Import/Export 拡張機能を置き換えてください。
• ソーシャル ID プロバイダー の Dashboard 機能を使用して、Custom Social Connections 拡張機能を置き換えてください。

​

統合を更新する

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

• 読み取り: Get enabled clients for a connection.
• 書き込み: Update enabled clients for a connection.

​

SDK とツールを更新する

次の SDK とツールのバージョンで、新しい endpoint がサポートされます。

• node-auth0: 4.25.0+
• go-auth0: 1.21.0+
• auth0-java: 2.21.0+
• auth0-python: 5.1.0+
• auth0.net: 7.38.0+
• Auth0 Deploy CLI: 8.27.0+
• Auth0 Terraform Provider: 1.29.0+

Auth0 Deploy CLI / Auth0 Terraform Provider では、データモデル内での接続およびそれぞれのクライアントの表現方法を変更する必要はありません。ツールで専用の endpoint を確実に使用するには、利用可能な最新バージョンを使用する必要があります。

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

​

オプトアウト (移行の完了)

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

• なぜ早めにオプトアウトするのですか？ これにより、対象のテナントが新しい動作に切り替わるタイミングを正確に制御できます。想定外の事態が発生した場合でも、トグルをすぐに元に戻して、元の動作を復元できます。
• オプトアウトする方法: Auth0 Dashboard > Tenant Settings > Advanced に移動します。Migrations で、Legacy Management of Connection’s Enabled Clients オプションをオフにします。