為您的閘道設定傳入授權

建立閘道之前，您必須設定傳入授權。傳入授權會驗證嘗試透過 AgentCore 閘道存取目標的使用者。AgentCore 支援以下類型的傳入授權：

如果您不打算使用 Amazon Cognito 使用預設授權組態，請選取與您計劃使用的授權類型對應的主題，以了解如何設定它：

IAM 型傳入授權

IAM 型傳入授權可讓您使用閘道發起人的 IAM 憑證進行授權。如果您想要建立 IAM 身分，呼叫閘道的使用者可以透過該身分進行身分驗證，您可以使用此選項。

設定以 IAM 為基礎的傳入授權

範例政策

下列範例顯示您可以連接到身分的政策，以允許它使用 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 Token (JWT) 型傳入授權

JSON Web 權杖 (JWT) 是用於授權的安全精簡權杖。您可以使用支援的身分提供者建立 JWT。建立 JWT 之後，您可以在建立閘道時擷取它，並將其指定為授權組態。

您可以使用 AgentCore CLI 來設定預設 JWT，或使用支援的身分提供者手動建立 JWT。若要進一步了解設定 JWT 的不同方法，請從下列主題中選取 ：

設定預設 JWT

AgentCore CLI 可讓您使用 Amazon Cognito 輕鬆建立預設授權組態，然後在建立閘道時使用。當您執行 agentcore create 時，CLI 會提示您設定傳入授權，並可以自動為您設定 Amazon Cognito 使用者集區。

agentcore create

命令完成後，AgentCore CLI 會提供身分驗證和授權資訊：

手動設定 JWT

Amazon Bedrock AgentCore 支援來自所有身分提供者JWTs。您可以在提供者設定和組態中查看一些範例。

在建立 JWT 的過程中，請注意下列值，如果適用於您的使用案例，您會在建立閘道時填寫 CustomJWTAuthorizerConfiguration：

您需要這些值才能執行下列動作：

身分驗證挑戰中的範圍公告

當用戶端將請求傳送至沒有有效存取權杖的 JWT 授權閘道時，閘道會傳回錯誤回應，其中包含公告所需 OAuth 範圍的WWW-Authenticate標頭。這遵循 RFC 6750 承載權杖挑戰格式，並讓 MCP 相容用戶端自動探索權杖擷取所需的範圍。

閘道會根據錯誤傳回下列回應：

scope 值包含閘道 CustomJWTAuthorizerConfiguration 中設定為允許範圍的空間分隔範圍。resource_metadata 值指向閘道的 OAuth Protected Resource Metadata 文件/.well-known/oauth-protected-resource，用戶端可以擷取這些文件來探索授權伺服器和支援的範圍。

使用私有 (VPC 託管） 身分提供者

AgentCore Gateway 支援使用 VPC 內託管的身分提供者進行 JWT 型傳入授權。您可以在 privateEndpoint上設定 customJWTAuthorizer，讓 AgentCore 能夠到達您的私有 OIDC 探索、字符和 JWKS 端點，而不會將其公開至公有網際網路。

您的 IAM 主體必須擁有 的 iam:CreateServiceLinkedRole 許可identity-network.bedrock-agentcore.amazonaws.com，以便 AgentCore Identity 可以在服務AWSServiceRoleForBedrockAgentCoreIdentity連結角色不存在時代表您建立該角色。

privateEndpoint 適用於 中的網域discoveryUrl。如果您的身分提供者對其他端點使用不同的網域 （例如，字符或 JWKS 端點解析為與探索 URL 不同的網域），請使用 privateEndpointOverrides為每個額外的網域指定單獨的私有端點組態。

下列範例使用 受管 Lattice 建立具有私有身分提供者的閘道：

{
  "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僅支援自我管理的 Lattice 資源：

{
  ...
  "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"
            }
          }
        }
      ]
    }
  }
}

如需自我管理的 Lattice、跨帳戶設定和進階組態，請參閱使用 VPC Lattice 連線至 VPC 中的私有資源。如需涵蓋傳入和傳出私有 IdP 案例的完整指南，請參閱連線至私有身分提供者。

卸載傳入授權

透過卸載傳入授權，閘道不會自行做出任何授權決策。相反地，它會將授權卸載至另一個元件：

AgentCore 提供兩種卸載類型：

使用任一類型時，您可以決定授權實際強制執行的位置：

驗證限定授權

透過僅驗證授權 (AUTHENTICATE_ONLY)，閘道會驗證發起人的 Signature 第 4 版 (SigV4) 簽章，以確認其身分，但不會自行做出任何授權決定。任何已驗證的 IAM 主體都可以叫用閘道，無論其許可為何，而且請求會轉送到目標。授權會委派給下游目標服務或連接到閘道的政策引擎。

無授權

您可以使用 建立在未經授權的情況下設定的閘道authorizerType=NONE。閘道不會對傳入的閘道請求執行任何授權，而且請求可以未經驗證。

安全最佳實務

加入現有的執行時間而不變更其身分驗證

當您將卸載的傳入類型與將發起人身分轉送至執行期的相符傳出授權類型配對時，加入至閘道就像在現有用戶端上設定端點覆寫一樣簡單，不需要驗證變更：