> ## 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.

> Auth0の連携を更新して、接続オプションをオプション固有のスコープで管理する方法を学びます。

# Management API Connection Options Scopes への移行

​Auth0 では、接続オプション用の 2 つの新しい Management API [スコープ](/docs/ja-jp/get-started/apis/scopes) `read:connections_options` と `update:connections_options` が導入されます。

また、適切なスコープなしで `options` フィールドにアクセスまたは更新する機能は非推奨となり、これにより次の 互換性のない変更 が発生します。

* [Get All Connections](/docs/ja-jp/api/management/v2/connections/get-connections) エンドポイントおよび [Get Connection by Id](/docs/ja-jp/api/management/v2/connections/get-connections-by-id) エンドポイントのレスポンスには、呼び出し元が `read:connections_options` スコープを持っていない限り、`options` フィールドは含まれません。
* [Update a connection](/docs/ja-jp/api/management/v2/connections/patch-connections-by-id) エンドポイントへのリクエストは、request body に `options` フィールドが含まれており、呼び出し元が `update:connections_options` スコープを持っていない場合、失敗します。成功時のレスポンスにも、呼び出し元が `read:connections_options` スコープを持っていない限り、`options` フィールドは含まれません。

`options` フィールドを引き続き使用するには、新しいスコープが含まれるように application grants を更新する必要があります。以下の手順に従って、テナントと連携が影響を受けるかどうかを確認し、オプション固有のスコープへ移行したうえで、最後に非推奨の動作をオプトアウトしてください。

<div id="identify-affected-tenants">
  ## 影響を受けるテナントを特定する
</div>

Auth0 Dashboard を使用して、テナントが新しいスコープなしで接続オプションにアクセスできるかどうか、また移行が必要かどうかを確認します。

1. [Auth0 Dashboard > Tenant Settings > Advanced](https://manage.auth0.com/dashboard/#/tenant/advanced) に移動します。
2. **Migrations** セクションまでスクロールします。
3. **Allow Connections Management** without Options Scopes トグルを確認します。
   A. トグルが **on** の場合、テナントは引き続き新しいスコープなしで接続オプションにアクセスできるため、期限までに移行する必要があります。
   B. トグルが表示されない、または **off** の場合は、それ以上の対応は不要です。

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

影響を受けるエンドポイントを使用しているアプリケーションと連携を特定するには、`depnote` テナントのログを確認します。次のサンプルクエリは、この非推奨化に関連する非推奨通知のテナントログを検索する方法を示しています。

```
type:depnote AND description:Allow\ Connections\ Management\ without\ Options\ Scopes*
```

詳細については、[ログ検索クエリ構文](docs/deploy-monitor/logs/log-search-query-syntax)を参照してください。

クエリ結果を取得したら、`client_id` フィールドを確認し、影響を受ける可能性のある各アプリケーションを特定します。変更の性質上、特定のクライアントアプリケーションに対する非推奨通知が存在していても、そのアプリケーションが実際に影響を受けているとは限りません。

​`client_id` フィールドの値が空の場合、影響を受けるエンドポイントへのリクエストは拡張機能から送信されたことを意味します。Auth0 の複数の拡張機能によって、実際には影響がないにもかかわらず、テナントログに非推奨通知が記録されることがあります。Update extensions セクションに記載されている拡張機能固有の手順を完了したら、`client_id` が空の非推奨通知は無視できます。

<div id="update-application-grants">
  ## application grants を更新する
</div>

影響を受けるエンドポイントを使用して `options` フィールドを取得または更新するアプリケーションでは、必要なスコープが含まれるように Management API grants を更新してください。

1. [Auth0 Dashboard > アプリケーション > APIs](https://manage.auth0.com/dashboard/#/apis) に移動します。
2. **Auth0 Management API** を選択し、**Machine to Machine Applications** タブを開きます。
3. 更新が必要なアプリケーションの横にある下向き矢印アイコンを選択して、セクションを展開します。
4. **Permissions** セクションで `“connections_options”` を検索します。新しいスコープのいずれか、または両方を有効にします。次に、**Update** を選択して変更を保存します。
   <Frame>
     <img src="https://mintcdn.com/translations/xwVvTWJUElMm5YAK/docs/images/cdy7uua7fh8z/update-connections-permissions.png?fit=max&auto=format&n=xwVvTWJUElMm5YAK&q=85&s=43285257ee0fe487de85877010636fda" alt="Management API の権限を更新する" width="600" height="206" data-path="docs/images/cdy7uua7fh8z/update-connections-permissions.png" />
   </Frame>

<div id="update-extensions">
  ## 拡張機能を更新する
</div>

[Delegated Administration Dashboard](/docs/ja-jp/customize/extensions/delegated-administration-extension/install-delegated-admin-extension) 拡張機能を最新バージョンに更新してください。拡張機能が正しく機能するには接続オプション フィールドへのアクセスが必要なため、この更新は必須です。この拡張機能を使用している場合は、機能を維持できるよう更新されていることを確認してください。

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

連携が非推奨の動作に依存しなくなったら、Options Scopes なしでの接続管理を許可しないように、テナントで明示的にオプトアウトを設定することをお勧めします。これにより、テナントで新しい動作をいつ有効にするかを正確に選択でき、移行プロセスをより細かく管理できます。

1. [Auth0 Dashboard > Tenant Settings > Advanced](https://manage.auth0.com/dashboard/#/tenant/advanced) に移動します。
2. Migrations セクションで、**Allow Connections Management without Options Scopes** オプションをオフにします。

問題が発生した場合は、同じトグルを元に戻すことで、問題に対処している間は以前の動作を一時的に復元できます。