Amazon Bedrock AgentCore Gateway에서 IAM 조건 키 사용

Amazon Bedrock AgentCore 관련 조건 키를 사용하여 조직에서 게이트웨이 및 게이트웨이 대상을 생성하고 구성하는 방법을 제어할 수 있습니다. 이러한 조건 키는 컨트롤 플레인 작업에 적용됩니다. 이는 조직 보안 요구 사항을 적용하기 위해 서비스 제어 정책(SCPs)에서 특히 유용합니다.

예를 들어, 다음을 수행할 수 있습니다.

게이트웨이 조건 키

다음 조건 키는 CreateGateway 및 UpdateGateway 작업에 적용됩니다.

게이트웨이 대상 조건 키

다음 조건 키는 CreateGatewayTarget 및 UpdateGatewayTarget 작업에 적용됩니다.

정책 예제

다음 예제에서는 IAM 정책 및 SCPs에서 조건 키를 사용하여 게이트웨이 구성에 대한 조직 제어를 적용하는 방법을 보여줍니다.

게이트웨이가 특정 자격 증명 공급자를 사용하도록 요구

게이트웨이가 조직의 승인된 자격 증명 공급자 검색 URL을 사용하지 않는 경우 다음 SCP를 사용하여 게이트웨이 생성 또는 업데이트를 거부합니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "EnforceGatewayIdP",
            "Effect": "Deny",
            "Action": [
                "bedrock-agentcore:CreateGateway",
                "bedrock-agentcore:UpdateGateway"
            ],
            "Resource": "*",
            "Condition": {
                "StringNotEquals": {
                    "bedrock-agentcore:DiscoveryUrl": "https://login.example.com/.well-known/openid-configuration"
                }
            }
        }
    ]
}

대상에 대한 자격 증명 공급자 유형 제한

다음 SCP를 사용하여 게이트웨이 대상을 승인된 자격 증명 공급자 유형으로 제한합니다. 이 예제에서는 게이트웨이의 IAM 역할 또는 호출자 IAM 자격 증명만 사용하도록 게이트웨이 대상을 제한합니다. 대상은 외부 관리형 API 키 또는 OAuth 토큰을 사용할 수 없습니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "RestrictTargetCredentialTypes",
            "Effect": "Deny",
            "Action": [
                "bedrock-agentcore:CreateGatewayTarget",
                "bedrock-agentcore:UpdateGatewayTarget"
            ],
            "Resource": "*",
            "Condition": {
                "StringNotEquals": {
                    "bedrock-agentcore:CredentialProviderType": [
                        "GATEWAY_IAM_ROLE",
                        "CALLER_IAM_CREDENTIALS"
                    ]
                }
            }
        }
    ]
}

생성할 수 있는 MCP 대상 유형 제한

다음 정책을 사용하여 특정 구성 유형을 사용하는 MCP 대상의 생성을 거부합니다. 이 예제에서는 대상이 직접 MCP 서버 URLs 사용하지 못하도록 합니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "DenyDirectMcpServerTargets",
            "Effect": "Deny",
            "Action": [
                "bedrock-agentcore:CreateGatewayTarget",
                "bedrock-agentcore:UpdateGatewayTarget"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "bedrock-agentcore:McpTargetConfigurationType": "mcpServer"
                }
            }
        }
    ]
}

대상이 프라이빗 엔드포인트를 사용하도록 요구

프라이빗 엔드포인트 유형을 지정하지 않는 대상의 생성을 거부하려면 다음 SCP를 사용합니다. 이렇게 하면 모든 대상 트래픽이 프라이빗 네트워크 내에 유지됩니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "EnforcePrivateEndpoints",
            "Effect": "Deny",
            "Action": [
                "bedrock-agentcore:CreateGatewayTarget",
                "bedrock-agentcore:UpdateGatewayTarget"
            ],
            "Resource": "*",
            "Condition": {
                "Null": {
                    "bedrock-agentcore:PrivateEndpointType": "true"
                }
            }
        }
    ]
}

게이트웨이가 고객 관리형 KMS 키를 사용하도록 요구

이 SCP를 사용하여 모든 게이트웨이가 서비스 기본값 대신 암호화에 고객 관리형 KMS 키를 사용하도록 요구합니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "EnforceCustomerManagedKey",
            "Effect": "Deny",
            "Action": [
                "bedrock-agentcore:CreateGateway",
                "bedrock-agentcore:UpdateGateway"
            ],
            "Resource": "*",
            "Condition": {
                "Null": {
                    "bedrock-agentcore:KmsKeyArn": "true"
                }
            }
        }
    ]
}

게이트웨이 대상에 대해 승인된 서브넷 적용

다음 정책을 사용하여 게이트웨이 대상을 승인된 서브넷으로 제한합니다. 자세한 내용은 AgentCore VPC 설정에서 IAM 조건 키 사용을 참조하세요.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "EnforceApprovedSubnets",
            "Effect": "Deny",
            "Action": [
                "bedrock-agentcore:CreateGatewayTarget",
                "bedrock-agentcore:UpdateGatewayTarget"
            ],
            "Resource": "*",
            "Condition": {
                "ForAnyValue:StringNotEquals": {
                    "bedrock-agentcore:subnets": [
                        "subnet-0123456789abcdef0",
                        "subnet-0123456789abcdef1"
                    ]
                }
            }
        }
    ]
}