View a markdown version of this page

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

Zoom

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

アウトバウンド

注記

Zoom OAuth2 アプリケーションはユーザーフェデレーションまたは M2M OAuth2 クライアントとしてのみ設定できますが、両方として設定することはできません。

注記

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

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

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

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

  1. Zoom App Marketplace にサインインします。

  2. [開発]、[アプリの構築] の順で選択します。

  3. ユーザーフェデレーションアプリの場合は、一般アプリを選択し、作成を選択します。

    • アプリケーションの詳細ページで、アプリケーションの名前を追加し、アプリケーションの管理方法を選択します。

    • OAuth 情報セクションで、OAuth リダイレクト URL と OAuth 許可リストを空のままにします。ステップ 3 で一意のコールバック URL を追加します。

  4. M2M アプリの場合は、Server to Server OAuth App を選択し、Create を選択します。

    • アプリケーションの名前を追加します。

    • アプリケーションの詳細ページで、スコープを選択し、アプリケーションに必要なスコープを追加します。

    • 情報を開き、会社名と開発者の連絡先情報を入力します。

  5. アプリケーション用に生成されたクライアント ID とクライアントシークレットを記録します。AgentCore Identity で Zoom 認証情報プロバイダーを設定するには、これらの値が必要です。

詳細については、Zoom の統合ドキュメントを参照してください。

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

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

{
  "name": "Zoom",
  "credentialProviderVendor": "ZoomOauth2",
  "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: Zoom に一意のコールバック URL を登録する

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

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

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

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