为您的网关设置入站授权

在创建网关之前，必须设置入站授权。入站授权对尝试通过您的 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 网络令牌 (JWT) 的入站授权

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

您可以使用 AgentCore CLI 来设置默认 JWT，也可以使用支持的身份提供商手动创建一个。要了解有关设置 JWT 的不同方法的更多信息，请从以下主题中进行选择：

设置默认 JWT

通过 AgentCore CLI，您可以使用 Amazon Cognito 轻松创建默认授权配置，然后可以在创建网关时使用该配置。运行时agentcore create，CLI 会提示您配置入站授权，并且可以自动为您设置 Amazon Cognito 用户池。

agentcore create

命令完成后， AgentCore CLI 将提供身份验证和授权信息：

手动设置 JWT

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

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

您需要使用这些值来执行以下操作：

身份验证挑战中的范围广告

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

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

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

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

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

您的 IAM 委托人必须拥有的iam:CreateServiceLinkedRole权限identity-network.bedrock-agentcore.amazonaws.com，这样 Ident AgentCore ity 才能代表您创建AWSServiceRoleForBedrockAgentCoreIdentity服务相关角色（如果该角色尚不存在）。

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 场景的全面指南，请参阅 Conn ect to 私有身份提供商。

已卸载的入站授权

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

AgentCore 提供两种卸载类型：

无论哪种类型，您都可以决定实际在何处强制执行授权：

Authenticate-only 授权

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

没有授权

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

安全最佳实践

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

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