# Dropbox
<a name="identity-idp-dropbox"></a>

Dropbox は、アウトバウンドリソースアクセス用の AgentCore Identity 認証情報プロバイダーとして設定できます。これにより、エージェントは Dropbox の OAuth2 サービスを通じてユーザーを認証し、Dropbox API リソースのアクセストークンを取得できます。

**注記**  
Dropbox は M2M/クライアント認証情報フローをサポートしていません。

## アウトバウンド
<a name="identity-idp-dropbox-outbound"></a>

**注記**  
AgentCore Identity は、作成する認証情報プロバイダーごとに一意の OAuth2 コールバック URL を発行します。一意のコールバック URL により、セッションバインディングが有効になります。これにより、OAuth2 認可コード交換をクロスプロバイダーリプレイや CSRF 形式の攻撃から保護できます。これにより、認可レスポンスは、それを開始した特定の認証情報プロバイダーに対してのみ引き換えることができます。URL はプロバイダーごとに一意であるため、 を呼び出す**まで**わかりません`CreateOauth2CredentialProvider`。最初に Dropbox OAuth2 クライアントを作成し、AgentCore Identity がコールバック URL を発行したら、Dropbox 開発者コンソールに戻ってコールバック URL を登録します。

 **ステップ 1: Dropbox OAuth2 クライアントを作成する** 

次の手順を使用して Dropbox OAuth2 アプリケーションをセットアップし、AgentCore Identity に必要なクライアント認証情報を取得します。AgentCore Identity が一意のコールバック URL を発行した後、ステップ 3 でリダイレクト URI を登録します。

 **Dropbox OAuth2 アプリケーションを設定するには** 

1. Dropbox のデベロッパー**アプリコンソール**を開きます。

1. **[アプリの作成]** を選択します。

1. **スコープ付きアクセス**を選択します。

1. アクセスタイプで、アプリケーションに適したアクセスタイプを選択します。

1. アプリケーションの名前を入力します。

1. **[アプリの作成]** を選択します。

1. アプリの概要ページで、OAuth2 セクションを開きます。現時点ではリダイレクト URI リストを空のままにしておきます。ステップ 3 で一意のコールバック URL を追加します。

1. 同じセクションで、**パブリッククライアントを許可する (暗黙的な付与と PKCE)** の下のドロップダウンを選択し、オプションで**許可しない**を選択します。

1. AgentCore Identity で Dropbox リソースプロバイダーを設定するための情報が必要になるため、アプリキーとアプリシークレットを記録します。

1. アプリケーションの**アクセス許可**タブで、アプリケーションに必要なスコープを選択します。

詳細については、[Dropbox の OAuth 実装ガイド](https://developers.dropbox.com/oauth-guide#implementing-oauth)を参照してください。

 **ステップ 2: AgentCore Identity 認証情報プロバイダーを作成する** 

Dropbox をアウトバウンドリソースプロバイダーとして設定するには、以下を使用します。

```
{
  "name": "DropBox",
  "credentialProviderVendor": "DropboxOauth2",
  "oauth2ProviderConfigInput" : {
    "includedOauth2ProviderConfig": {
      "clientId": "your-client-id",
      "clientSecret": "your-client-secret"
    }
  }
}
```

[CreateOauth2CredentialProvider](https://docs.aws.amazon.com/bedrock-agentcore-control/latest/APIReference/API_CreateOauth2CredentialProvider.html) レスポンスには `callbackUrl`フィールドが含まれます。この URL はこの認証情報プロバイダーに固有であり、 のようになります`https://bedrock-agentcore.us-east-1.amazonaws.com/identities/oauth2/callback/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX`。次のステップでこの値を保存します。

 **ステップ 3: 一意のコールバック URL を Dropbox に登録する** 

Dropbox 開発者コンソールに戻り、OAuth2 アプリケーションのリダイレクト URI リストに一意のコールバック URL を追加します。

1. Dropbox 開発者コンソールにサインインし、ステップ 1 で作成した OAuth2 アプリケーションを開きます。

1. によって返された`callbackUrl`値をアプリケーションのリダイレクト URI 設定`CreateOauth2CredentialProvider`に追加します。

1. 変更内容を保存します。