게이트웨이에 대한 인바운드 권한 부여 설정

게이트웨이를 생성하기 전에 인바운드 권한 부여를 설정해야 합니다. 인바운드 권한 부여는 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 웹 토큰(JWT) 기반 인바운드 권한 부여

JSON 웹 토큰(JWT)은 권한 부여에 사용되는 안전하고 컴팩트한 토큰입니다. 지원되는 자격 증명 공급자를 사용하여 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는 모든 자격 증명 공급자의 JWTs 지원합니다. 공급자 설정 및 구성에서 몇 가지 예를 볼 수 있습니다.

JWT를 생성하는 과정에서 다음 값을 기록해 둡니다.이 값은 사용 사례에 해당하는 경우 게이트웨이를 생성할 때 CustomJWTAuthorizerConfiguration에서 작성합니다.

다음을 수행하려면 이러한 값이 필요합니다.

인증 과제의 범위 광고

클라이언트가 유효한 액세스 토큰 없이 JWT 인증 게이트웨이에 요청을 보내면 게이트웨이는 필요한 OAuth 범위를 알리는 WWW-Authenticate 헤더와 함께 오류 응답을 반환합니다. 이는 RFC 6750 베어러 토큰 챌린지 형식을 따르며 MCP 호환 클라이언트가 토큰 획득에 필요한 범위를 자동으로 검색할 수 있도록 합니다.

게이트웨이는 오류에 따라 다음 응답을 반환합니다.

scope 값에는 게이트웨이의 CustomJWTAuthorizerConfiguration에서 허용 범위로 구성된 공백으로 구분된 범위가 포함됩니다. resource_metadata 값은 클라이언트가 권한 부여 서버 및 지원되는 범위를 검색하기 위해 가져올 수 /.well-known/oauth-protected-resource있는에서 게이트웨이의 OAuth 보호 리소스 메타데이터 문서를 가리킵니다.

프라이빗(VPC 호스팅) 자격 증명 공급자 사용

AgentCore Gateway는 VPC 내에서 호스팅되는 자격 증명 공급자를 통한 JWT 기반 인바운드 권한 부여를 지원합니다. AgentCore가 퍼블릭 인터넷privateEndpoint에 노출되지 않고 프라이빗 OIDC 검색, 토큰 및 JWKS 엔드포인트에 도달할 수 customJWTAuthorizer 있도록에서를 구성할 수 있습니다.

IAM 보안 주체는에 대한 iam:CreateServiceLinkedRole 권한이 있어야 AgentCore 자격 증명identity-network.bedrock-agentcore.amazonaws.com이 아직 존재하지 않는 경우 사용자를 대신하여 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)를 사용하면 게이트웨이는 호출자의 서명 버전 4(SigV4) 서명을 확인하여 자격 증명을 확인하지만 자체 권한 부여는 결정하지 않습니다. 인증된 모든 IAM 보안 주체는 권한에 관계없이 게이트웨이를 호출할 수 있으며 요청은 대상으로 전달됩니다. 권한 부여는 다운스트림 대상 서비스 또는 게이트웨이에 연결된 정책 엔진에 위임됩니다.

권한 없음

를 사용하여 권한 부여 없이 구성된 게이트웨이를 생성할 수 있습니다authorizerType=NONE. 게이트웨이는 수신 게이트웨이 요청에 대해 어떠한 권한 부여도 수행하지 않으며 요청을 인증할 수 없습니다.

보안 모범 사례

인증을 변경하지 않고 기존 런타임 온보딩

오프로드된 인바운드 유형을 발신자의 자격 증명을 런타임으로 전달하는 일치하는 아웃바운드 권한 부여 유형과 페어링하는 경우 게이트웨이에 대한 온보딩은 기존 클라이언트에서 엔드포인트 재정의를 설정하는 것만큼 간단할 수 있습니다. 인증 변경은 필요하지 않습니다.