View a markdown version of this page

X - Amazon Bedrock AgentCore
出站

X

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

出站

注意

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

步骤 1：创建 X OAuth2 客户端

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

配置 X OAuth2 应用程序

  1. 打开 X 开发者门户。

  2. 在左侧导航栏中，选择 “项目和应用程序”。

  3. 选择您为应用程序创建的 X 项目。

  4. 在 “应用程序” 标题下，选择 “添加应用程序”。

  5. 选择 新建。

  6. 为您的应用程序提供名称和描述。

  7. 在左侧导航栏中，选择刚刚生成的应用程序。

  8. 在新应用程序的应用程序详细信息页面上，在用户身份验证设置中选择编辑。

  9. 选择您的应用程序所需的应用程序权限。

  10. 在 “应用程序类型” 中，选择 “Web 应用程序”、“自动应用程序” 或 “机器人”。

  11. 在 “应用程序信息” 下，暂时将回传 URL 字段留空 — 您将在步骤 3 中添加唯一的回传网址。

  12. 对于网站网址，请输入您的应用程序的网址。

  13. 选择保存。

  14. 在应用程序的密钥和令牌选项卡下，转到 OAuth 2.0 客户端 ID 和客户端密钥。

  15. 选择 Generate 并记下生成的客户端 ID 和密钥，因为您需要这些信息才能在 Ident AgentCore ity 中配置 X 资源提供者。

注意

X 仅在生成时显示完整的客户端密钥，如果您丢失了这些信息，则需要在 X 开发者门户中重新生成客户端密钥。

有关更多详细信息，请参阅 X 的 OAuth 2.0 文档。

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

要将 X 配置为出站资源提供者，请使用以下命令：

{
  "name": "X",
  "credentialProviderVendor": "XOauth2",
  "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 步：向 X 注册唯一的回传网址

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

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

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

  3. 保存更改。