View a markdown version of this page

GitHub - Amazon Bedrock AgentCore
出站
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

GitHub

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

出站

注意

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

第 1 步：创建 GitHub OAuth2 客户端

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

配置 GitHub OAuth2 应用程序

  1. 选择你的 github 账户的头像，然后选择 “设置” 。

  2. 选择开发者设置。

  3. 选择 OAuth 应用程序。

  4. 在 OAuth2 应用程序页面上，选择新建 OAuth 应用程序。

  5. 输入特定于您的应用程序的必要详细信息。暂时将授权回调 URL 字段留空——您将在步骤 3 中添加唯一的回传 URL。

  6. 选择注册应用程序来创建你的 Github OAuth 应用程序。

  7. 在 Github 的 OAuth 应用程序页面上，转到您新创建的提供商。

  8. 在 “客户端密钥” 部分下，选择 “生成新的客户端密钥” 。

  9. 记下新创建的客户端密钥。你需要这个来使用 AgentCore 身份配置你的 Github 应用程序。

    注意

    Github 仅在创建时返回完整机密。如果您忘记了它，则需要重新创建客户端密钥以在 I AgentCore dentity 中配置提供商。

有关更多详细信息，请参阅 Github 的文档创建 OAuth 应用程序。

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

要配置出站 GitHub 资源提供商，请使用以下命令：

{
        "name": "NAME",
        "credentialProviderVendor": "GithubOauth2",
        "oauth2ProviderConfigInput": {
            "GithubOauth2ProviderConfigInput": {
                "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 步：使用注册唯一的回传 URL GitHub

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

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

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

  3. 保存更改。