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

为您的网关设置入站授权

在创建网关之前，必须设置入站授权。入站授权会验证尝试通过您的 AgentCore 网关访问目标的用户。 AgentCore 支持以下类型的入站授权：

如果您不打算使用 Amazon Cognito 使用默认授权配置，请选择与您计划使用的授权类型相对应的主题来学习如何进行设置：

IAM-based 入站授权

IAM-based 入站授权允许您使用网关调用者的 IAM 证书进行授权。如果您想创建一个 IAM 身份，通过该身份可以对调用您的网关的用户进行身份验证，则可以使用此选项。

设置 IAM-based 入站授权

示例策略

以下示例显示了您可以附加到身份以允许其调用带有 ID 的网关的策略 my-gateway-12345

{
"Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowGatewayInvocation",
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:InvokeGateway"
      ],
      "Resource": [
        "arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/my-gateway-12345"
      ]
    }
  ]
}

资源

基于 JSON Web 令牌 (JWT) 的入站授权

JSON 网络令牌 (JWT) 是一种安全且紧凑的令牌，用于授权。您可以使用支持的身份提供商创建 JWT。创建 JWT 后，您可以检索它并在创建网关时将其指定为授权配置。

您可以使用 AgentCore CLI 使用现有 JWT 身份提供商配置网关。要了解有关 JWT 配置方法的更多信息，请从以下主题中进行选择：

配置 JWT 授权器

使用支持的身份提供商创建应用程序和客户端。有关亚马逊 Cognito 的示例，请参阅亚马逊 Cogn ito 入门。记下 OIDC 发现 URL 和客户端 ID。

在 AgentCore 项目目录中运行以下命令：

agentcore add gateway \
  --name MyGateway \
  --protocol-type MCP \
  --authorizer-type CUSTOM_JWT \
  --discovery-url <OIDC_DISCOVERY_URL> \
  --allowed-clients <CLIENT_ID>

AgentCore CLI 使用现有的 OIDC 配置；它不创建身份提供者资源。要调用网关，请从您的提供商处获取访问令牌。对于亚马逊 Cognito，请参阅亚马逊 Cognito 开发者指南中的代币发行者终端节点。

手动设置 JWT

亚马逊 Bedrock AgentCore 支持来自所有身份提供商的 JWT。您可以在提供商设置和配置中查看一些示例。

在创建 JWT 的过程中，请注意以下值，如果这些值适用于您的用例，您将在创建网关CustomJWTAuthorizerConfiguration时填写这些值：

你需要这些值来执行以下操作：

身份验证质询中的范围广告

当客户端向没有有效访问令牌的 JWT-authorized 网关发送请求时，网关会返回带有标头的错误响应，WWW-Authenticate标头会通告所需的 OAuth 范围。这遵循 RFC 6750 Bearer代币挑战赛格式，使 MCP-compliant 客户能够自动发现代币收购所需的范围。

网关根据错误返回以下响应：

该scope值包含网关中配置为允许范围的以空格分隔的范围。 CustomJWTAuthorizerConfiguration 该resource_metadata值指向网关的 OAuth 受保护资源元数据文档/.well-known/oauth-protected-resource，客户端可以获取该文档以发现授权服务器和支持的范围。

使用私有 (VPC-hosted) 身份提供商

AgentCore 网关支持向您的 VPC 内托管的身份提供商进行 JWT-based 入站授权。您可以在privateEndpoint上进行配置，使其customJWTAuthorizer AgentCore 能够访问您的私有 OIDC 发现、令牌和 JWKS 终端节点，而无需将其暴露给公共互联网。

您的 IAM 委托人必须具有iam:CreateServiceLinkedRole权限identity-network.bedrock-agentcore.amazonaws.com，这样，如果AWSServiceRoleForBedrockAgentCoreIdentity服务相关角色尚不存在，Id AgentCore entity 可以代表您创建该角色。

privateEndpoint适用于中的域discoveryUrl。如果您的身份提供商为其他终端节点使用不同的域（例如，令牌或 JWKS 端点解析到与发现 URL 不同的域），则使用privateEndpointOverrides为每个附加域指定单独的私有端点配置。

以下示例使用托管莱迪思使用私有身份提供商创建网关：

{
  "name": "my-private-idp-gateway",
  "protocolType": "MCP",
  "roleArn": "arn:aws:iam::123456789012:role/my-gateway-role",
  "authorizerType": "CUSTOM_JWT",
  "authorizerConfiguration": {
    "customJWTAuthorizer": {
      "allowedAudience": [
        "my-audience"
      ],
      "discoveryUrl": "https://my-idp.internal.example.com/.well-known/openid-configuration",
      "privateEndpoint": {
        "managedVpcResource": {
          "vpcIdentifier": "vpc-0abc123def456",
          "subnetIds": ["subnet-0abc123", "subnet-0def456"],
          "endpointIpAddressType": "IPV4",
          "securityGroupIds": ["sg-0abc123def"]
        }
      }
    }
  }
}

如果您的令牌或 JWKS 终端节点使用与发现 URL 不同的域，请为每个其他域添加一个privateEndpointOverrides条目。目前，privateEndpointOverrides仅支持自管理的莱迪思资源：

{
  ...
  "authorizerConfiguration": {
    "customJWTAuthorizer": {
      "allowedAudience": ["my-audience"],
      "discoveryUrl": "https://my-idp.internal.example.com/.well-known/openid-configuration",
      "privateEndpoint": {
        "selfManagedLatticeResource": {
          "resourceConfigurationIdentifier": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-abc123"
        }
      },
      "privateEndpointOverrides": [
        {
          "domain": "my-token-server.internal.example.com",
          "privateEndpoint": {
            "selfManagedLatticeResource": {
              "resourceConfigurationIdentifier": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-def456"
            }
          }
        }
      ]
    }
  }
}

有关自我管理的莱迪思、跨账户设置和高级配置，请参阅使用 VPC Lattice 连接您的 VPC 中的私有资源。有关涵盖入站和出站私有 IdP 场景的综合指南，请参阅连接私有身份提供商。

已卸载的入站授权

在卸载入站授权后，网关不会自行做出任何授权决定。相反，它将授权转移到另一个组件：

AgentCore 提供两种卸载类型：

无论使用哪种类型，您都可以决定授权的实际执行地点：

Authenticate-only 授权

使用仅限身份验证的授权 (AUTHENTICATE_ONLY)，网关会验证呼叫者的签名版本 4 (SigV4) 签名以确认其身份，但不会自行做出任何授权决定。任何经过身份验证的 IAM 委托人无论权限如何都可以调用网关，并且请求会转发到目标。授权委托给下游目标服务或连接到网关的策略引擎。

没有授权

您可以使用创建未经授权配置的网关authorizerType=NONE。网关不会对传入的网关请求执行任何授权，并且该请求可以未经身份验证。

安全最佳实践

在不更改其身份验证的情况下启动现有运行时

当您将卸载的入站类型与匹配的出站授权类型配对（将呼叫者的身份转发到运行时）时，网关的入门可以像在现有客户端上设置终端节点覆盖一样简单，无需更改身份验证：