View a markdown version of this page

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

Facebook

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

アウトバウンド

注記

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

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

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

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

  1. Facebook の開発者アカウントを作成します。

  2. Facebook 認証情報を使用してサインインします。

  3. [My Apps] (マイアプリ) メニューから、[新しいアプリを作成] (新しいアプリを作成) を選択します。

    注記

    既存の Facebook アプリがない場合は、別のオプションが表示されます。[Create App (アプリの作成)] を選択します。

  4. [アプリの作成] ページで、アプリのユースケースを選択し、[次へ] を選択します。

  5. Facebook アプリケーションに名前を入力して、[アプリの作成] を選択します。

  6. ナビゲーションバーで、アプリ設定 を選択し、基本 を選択します。

  7. アプリ ID とアプリシークレット を記録します。AgentCore Identity で Facebook プロバイダーを設定する際に使用します。

  8. プラットフォームの追加 を選択します。

  9. [プラットフォームの選択] 画面で、プラットフォームを選択し、[次へ] を選択します。

  10. [Save changes] (変更の保存) をクリックします。

  11. App Domains には、アプリケーションのドメイン と を入力しますbedrock-agentcore.region.amazonaws.com。

  12. [Save changes] (変更の保存) をクリックします。

  13. ナビゲーションバーから製品 を選択し、Facebook ログインから設定 を選択します。

  14. [Facebook でログイン] の [設定] メニューから [設定] を選択します。

  15. 現時点では、有効な OAuth リダイレクト URIs フィールドを空のままにしておきます。ステップ 3 で一意のコールバック URL を追加します。

  16. [Save changes] (変更の保存) をクリックします。

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

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

{
  "name": "Facebook",
  "credentialProviderVendor": "FacebookOauth2",
  "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 を Facebook に登録する

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

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

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

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