View a markdown version of this page

GitHub - Amazon Bedrock AgentCore
出站

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

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. 保存更改。