View a markdown version of this page

Zoom - Amazon Bedrock AgentCore
出站

Zoom

可以将 Zoom 配置为出站资源访问的 AgentCore 身份凭证提供商。这样，您的代理就可以通过 Zoom 的 OAuth2 服务对用户进行身份验证，并获取 Zoom API 资源的访问令牌。

出站

注意

您只能将 Zoom OAuth2 应用程序配置为用户联盟或 M2M OAuth2 客户端，但不能同时配置两者。

注意

AgentCore Identity 会为您创建的每个凭据提供商发出唯一的 OAuth2 回调 URL。唯一的回调 URL 支持会话绑定，通过确保授权响应只能针对启动它的特定凭据提供商兑换，从而保护 OAuth2 授权码交换免受跨提供商重播和 CSRF-style 攻击。由于每个提供商的网址是唯一的，因此您要等到致电后才能知道CreateOauth2CredentialProvider。首先创建您的 Zoom OAuth2 客户端，然后在 Ident AgentCore ity 发布回传网址后返回 Zoom 开发者控制台注册回传网址。

第 1 步：创建 Zoom OAuth2 客户端

使用以下步骤设置 Zoom OAuth2 应用程序并获取身份所需的客户端凭证。 AgentCore 在 Ident AgentCore ity 发出唯一回调 URL 之后，您将在步骤 3 中注册重定向 URI。

配置 Zoom OAuth2 应用程序

  1. 登录 Zoom App Marketplace。

  2. 选择开发 > 构建应用程序。

  3. 对于用户联合应用程序，请选择常规应用程序，然后选择创建。

    • 在应用程序详细信息页面上，为您的应用程序添加一个名称，然后选择如何管理您的应用程序。

    • 在 OAuth 信息部分，暂时将 OAuth 重定向网址和 OAuth 允许列表留空，您将在步骤 3 中添加唯一的回传网址。

  4. 对于 M2M 应用程序，选择 “服务器到服务器 OAuth 应用程序”，然后选择 “创建”。

    • 为您的应用程序添加一个名称。

    • 在应用程序详细信息页面上，选择范围，然后为您的应用程序添加必要的范围。

    • 打开 “信息” 并提供公司名称和开发者联系信息。

  5. 记录为您的应用程序生成的客户端 ID 和客户端密钥。您需要使用这些值来配置 Ident AgentCore ity 中的 Zoom 凭证提供商。

如需了解更多详情，请参阅 Zoom 的集成文档。

步骤 2：创建 AgentCore 身份凭证提供商

要将 Zoom 配置为出站资源提供商，请使用以下方法：

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

CreateOauth2CredentialProvider响应中包含一个callbackUrl字段。此网址是该凭证提供商所独有的，看起来像:https://bedrock-agentcore.us-east-1.amazonaws.com/identities/oauth2/callback/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. 保存此值以供下一步使用。

第 3 步：在 Zoom 中注册唯一的回传网址

返回 Zoom 开发者控制台，将唯一的回调网址添加到 OAuth2 应用程序的重定向 URI 列表中。

  1. 登录 Zoom 开发者控制台，打开您在步骤 1 中创建的 OAuth2 应用程序。

  2. 将返回的callbackUrl值添加到应用程序的重定向 URI 配置中。CreateOauth2CredentialProvider

  3. 保存更改。