

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# X
<a name="identity-idp-x"></a>

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

## 出站
<a name="identity-idp-x-outbound"></a>

**注意**  
AgentCore Identity 会为您创建的每个凭证提供商颁发唯一的 OAuth2 回调 URL。独特的回调 URL 支持会话绑定，通过确保授权响应只能针对发起该请求的特定凭证提供商进行兑换，从而保护 OAuth2 授权码交换免受跨提供商重放和 CSRF-style 攻击。由于每个提供商的网址都是唯一的，所以你要等到打电话**之后才**会知道`CreateOauth2CredentialProvider`。首先创建您的 X OAuth2 客户端，然后在 Ident AgentCore ity 发布回调网址后返回 X 开发者控制台注册回调 URL。

 **第 1 步：创建 X OAuth2 客户端 ** 

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

 **配置 X OAuth2 应用程序 ** 

1. 打开 X 开发者门户。

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

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

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

1. 选择 **新建**。

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

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

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

1. 选择**应用程序**所需的应用程序权限。

1. 对于 ** “应用程序**类型”，选择 “**Web 应用程序”、“自动应用程序” 或 “机器人” **。

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

1. 对于**网站 URL，**输入您的应用程序的 URL。

1. 选择**保存**。

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

1. 选择 G ** enerate ** 并记下生成的客户端 ID 和密钥，因为您需要这些信息才能在 I AgentCore dentity 中配置 X 资源提供商。

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

有关更多详细信息，请参阅 [ X 的 OAuth 2.0 文档。](https://docs.x.com/fundamentals/authentication/oauth-2-0/overview)

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

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

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

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

 **第 3 步：使用 X 注册唯一的回调 URL ** 

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

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

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

1. 保存更改。