View a markdown version of this page

Okta 的 Auth0 - Amazon Bedrock AgentCore
入站出站

Okta 的 Auth0

可以将 Auth0 配置为用于访问 AgentCore 网关和运行时的身份提供商，也可以配置为用于出站资源访问的 AgentCore 身份凭证提供商。这允许您的代理使用 Auth0 作为身份提供者和授权服务器对代理用户进行身份验证和授权，或者您的代理获取凭据以访问由 Auth0 授权的资源。

入站

要将 Auth0 添加为身份提供商和授权服务器以访问 AgentCore 网关和运行时，您必须：

  • 从 IDP 目录配置发现 URL。这有助于 AgentCore Identity 获取与您的 OAuth 授权服务器和令牌验证密钥相关的元数据。

  • 输入令牌的有效aud声明。这有助于验证来自您的 IDP 的代币，并允许访问包含预期声明的代币。

使用以下过程设置 Auth0 并获取网关身份验证所需的配置值。

配置 Auth0 以进行入站身份验证

  1. 在 Auth0 中创建一个 API：

    1. 登录到你的 Auth0 控制面板。

    2. 打开 API，然后选择创建 API。

    3. 输入您的 API 的名称和标识符（例如，“gateway-api”）。

    4. 选择签名算法（推荐 RS256）。

    5. 选择创建。

  2. 配置 API 范围：

    1. 在 API 设置中，转到 “范围” 选项卡。

    2. 添加诸如 “invoke: gateway” 和 “read: gateway” 之类的范围。

  3. 创建应用程序：

    1. 打开应用程序，然后选择创建应用程序。

    2. 选择 “计算机对计算机应用程序”。

    3. 选择您在步骤 1 中创建的 API。

    4. 根据您创建的范围对应用程序进行授权。

    5. 选择创建。

  4. 记录应用程序设置中的客户端 ID 和客户端密钥。您需要这些值才能在 Ident AgentCore ity 中配置 Auth0 提供程序。

  5. 为您的 Auth0 租户构建发现网址：

    https://your-domain/.well-known/openid-configuration

    你your-domain的 Auth0 租户域在哪里（例如，“dev-example.us.auth0.com”）。

  6. 使用以下值配置入站身份验证：

    1. 发现 URL：在上一步中构造的 URL

    2. 允许的受众：您在步骤 1 中创建的 API 标识符

出站

注意

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

步骤 1：创建 Auth0 应用程序

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

配置 Auth0 OAuth2 应用程序

  1. 登录到你的 Auth0 控制面板。

  2. 打开应用程序，然后选择创建应用程序。

  3. 输入应用程序的名称，然后选择常规 Web 应用程序作为应用程序类型。

  4. 选择创建。

  5. 在应用程序的 “设置” 选项卡上，暂时将 “允许的回调 URL” 留空 — 您将在步骤 3 中添加唯一的回传 URL。

  6. 配置应用程序所需的所有连接、范围和权限。

  7. 记录应用程序设置中的客户端 ID 和客户端密钥。您需要这些值才能在 Ident AgentCore ity 中配置 Auth0 提供程序。

  8. 记下你的 Auth0 租户域（例如dev-example.us.auth0.com）。在步骤 2 中，您将使用它来构造授权、令牌和颁发者端点。

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

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

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

{
  "name": "NAME",
  "credentialProviderVendor": "Auth0Oauth2",
  "oauth2ProviderConfigInput" : {
    "includedOauth2ProviderConfig": {
      "clientId": "your-client-id",
      "clientSecret": "your-client-secret",
      "authorizationEndpoint": "https://your-auth0-tenant.auth0.com/authorize",
      "tokenEndpoint": "https://your-auth0-tenant.auth0.com/oauth/token",
      "issuer": "https://your-auth0-tenant.auth0.com"
    }
  }
}

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

第 3 步：向 Auth0 注册唯一的回传网址

返回 Auth0 控制面板，将唯一的回调 URL 添加到应用程序允许的回调中。

  1. 登录 Auth0 控制面板并打开您在步骤 1 中创建的应用程序。

  2. 在 “设置” 选项卡上，将返回的callbackUrl值粘贴到 “允许的回调 URL” CreateOauth2CredentialProvider 中。

  3. 选择保存更改。