View a markdown version of this page

X - Amazon Bedrock AgentCore
アウトバウンド

X

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

アウトバウンド

注記

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

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

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

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

  1. X 開発者ポータルを開きます。

  2. 左側のナビゲーションバーで、プロジェクトとアプリを選択します。

  3. アプリケーション用に作成した X プロジェクトで を選択します。

  4. Apps ヘッダーで、Add an App を選択します。

  5. [新規作成] を選択します。

  6. アプリケーションの名前と説明を入力します。

  7. 左側のナビゲーションバーで、先ほど生成されたアプリケーションを選択します。

  8. 新しいアプリのアプリの詳細ページで、ユーザー認証設定で編集を選択します。

  9. アプリケーションに必要なアプリのアクセス許可を選択します。

  10. アプリのタイプ ウェブアプリ、自動アプリ、またはボットを選択します。

  11. アプリ情報 で、現時点ではコールバック URL フィールドを空のままにしておきます。ステップ 3 で一意のコールバック URL を追加します。

  12. ウェブサイト URL には、アプリケーションの URL を入力します。

  13. [保存] を選択します。

  14. アプリケーションのキーとトークンタブで、OAuth 2.0 クライアント ID とクライアントシークレットに移動します。

  15. AgentCore Identity で X リソースプロバイダーを設定するには、この情報が必要なときに生成されるクライアント ID とシークレットを生成して書き留めます。

注記

X は、クライアントシークレットの生成時にのみ完全なクライアントシークレットを表示します。この情報が失われた場合は、X デベロッパーポータルでクライアントシークレットを再生成する必要があります。

詳細については、X の OAuth 2.0 ドキュメントを参照してください。

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

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

{
  "name": "X",
  "credentialProviderVendor": "XOauth2",
  "oauth2ProviderConfigInput" : {
    "includedOauth2ProviderConfig": {
      "clientId": "your-client-id",
      "clientSecret": "your-client-secret"
    }
  }
}

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

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

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

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

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

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