メインコンテンツへスキップ
​Auth0 では、接続オプション向けに 2 つの新しい Management API scopes、read:connections_options と update:connections_options を導入します。 また、適切なスコープなしで options フィールドにアクセスまたは更新できる機能を非推奨とするため、以下の破壊的変更が発生します。
  • 呼び出し元に read:connections_options スコープがない場合、Get All Connections および Get Connection by Id エンドポイントのレスポンスには options フィールドが含まれません。
  • Update a Connection エンドポイントへのリクエストは、リクエストボディに options フィールドが含まれており、呼び出し元に update:connections_options スコープがない場合は失敗します。また、成功レスポンスにも、呼び出し元に read:connections_options スコープがない場合、options フィールドは含まれません。
options フィールドを引き続き使用するには、新しいスコープが含まれるようにアプリケーショングラントを更新する必要があります。以下の手順に従って、テナントやインテグレーションが影響を受けるかどうかを確認し、接続オプション専用のスコープへ移行したうえで、最後に非推奨の動作をオプトアウトしてください。

​
影響を受けるテナントを特定する

Auth0 Dashboard を使用して、テナントが新しいスコープなしで接続オプションにアクセスできる状態かどうか、および移行が必要かどうかを確認します。
  1. Auth0 Dashboard > Tenant Settings > Advanced に移動します。
  2. Migrations セクションまでスクロールします。
  3. Allow Connections Management without Options Scopes トグルを確認します。 A. トグルが オン の場合、テナントは引き続き新しいスコープなしで接続オプションにアクセスできるため、期限までに移行する必要があります。 B. トグルが表示されない、または オフ の場合は、追加の対応は不要です。

​
影響を受けるインテグレーションを特定する

depnote テナントログを確認し、どのアプリケーションやインテグレーションが影響を受けるエンドポイントを使用しているかを特定します。次のサンプルクエリは、この廃止に関連する非推奨通知のテナントログを検索する方法を示しています。 
type:depnote AND description:Allow\ Connections\ Management\ without\ Options\ Scopes*
詳しくは、Log Search Query Syntaxを参照してください。 クエリ結果を取得したら、client_id フィールドを確認し、影響を受ける可能性のある各アプリケーションを特定します。変更の性質上、特定のクライアントアプリケーションに非推奨通知があるからといって、そのアプリケーションが実際に影響を受けているとは限りません。 ​client_id フィールドの値が空の場合は、影響を受けるエンドポイントへのリクエストが拡張機能から送信されたことを意味します。一部の Auth0 拡張機能では、誤検知による非推奨通知のテナントログが生成されることがあります。Update extensions セクションに記載されている拡張機能固有の手順を完了したら、クライアント識別子が空の非推奨通知は無視できます。

​
アプリケーションのグラントを更新する

影響を受けるエンドポイントを使用して options フィールドを取得または更新するアプリケーションでは、必要なスコープが含まれるように Management API のグラントを更新してください。
  1. Auth0 Dashboard > Applications > APIs に移動します。
  2. Auth0 Management API を選択し、Machine to Machine Applications タブを開きます。
  3. 更新が必要なアプリケーションの横にある下向き矢印アイコンを選択して、セクションを展開します。
  4. Permissions セクションで “connections_options” を検索します。新しいスコープのいずれか、または両方を有効にします。次に、変更を保存するため Update を選択します。
    Management API の権限を更新する

​
拡張機能を更新する

Delegated Administration Dashboard 拡張機能を最新バージョンに更新してください。この更新は、拡張機能が正しく機能するために接続オプション フィールドへのアクセスを必要とするため、必須です。この拡張機能を使用している場合は、引き続き利用できるよう必ず更新してください。

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

インテグレーションが非推奨の動作に依存しなくなったら、オプションスコープなしでのコネクション管理を許可しないよう、テナントで明示的にオプトアウトを設定することをお勧めします。これにより、テナントで新しい動作をいつ採用するかを正確に選べるようになり、移行プロセスをより細かく制御できます。
  1. Auth0 Dashboard > Tenant Settings > Advanced に移動します。
  2. Migrations セクションで、Allow Connections Management without Options Scopes オプションをオフにします。
問題が発生した場合は、同じトグルを元に戻すことで、問題に対処している間、一時的に以前の動作を復元できます。