Amazon Bedrock AgentCore에 대한 리소스 기반 정책

Amazon Bedrock AgentCore의 리소스 기반 정책을 사용하면 Amazon Bedrock AgentCore 리소스(현재 런타임, 게이트웨이 및 메모리에 지원됨)를 호출하고 관리할 수 있는 보안 주체(AWS 계정, IAM 사용자 또는 IAM 역할)를 제어할 수 있습니다. IAM 스타일 정책을 리소스에 직접 연결하여 런타임 세션을 시작하거나, 게이트웨이를 호출하거나, 메모리에 액세스하거나, 기타 관리 및 호출 작업을 수행할 수 있는 사용자에 대한 규칙을 정의할 수 있습니다.

리소스 기반 정책은 자격 증명 기반 IAM 정책과 함께 작동하여 Amazon Bedrock AgentCore 리소스에 대한 액세스 제어를 제공합니다. 자격 증명 기반 정책은 IAM 자격 증명에 연결되고 수행할 수 있는 작업을 지정하지만 리소스 기반 정책은 리소스에 직접 연결되고 리소스에 액세스할 수 있는 사용자를 지정합니다.

지원되는 리소스

Amazon Bedrock AgentCore는 다음 리소스에 대한 리소스 기반 정책을 지원합니다.

리소스 기반 정책 작동 방식

자격 증명 기반 정책과 리소스 기반 정책

정책 평가

Amazon Bedrock AgentCore 리소스에 대한 요청이 이루어지면는 자격 증명 기반 정책과 리소스 기반 정책을 모두 AWS 평가합니다. 다음 표는 다양한 정책 조합이 액세스에 미치는 영향을 보여줍니다.

주요 원칙:

에이전트 런타임 및 엔드포인트에 대한 계층적 권한 부여

에이전트 엔드포인트는 에이전트 런타임의 특정 버전에 대한 주소 지정 가능한 액세스 포인트입니다. 각 엔드포인트는 런타임 구성의 특정 버전을 가리키며 DEFAULT 엔드포인트는 자동으로 최신 버전으로 라우팅됩니다. InvokeAgentRuntime 및와 같은 런타임 API 작업을 승인할 때 InvokeAgentRuntimeCommand는 호출 중인 에이전트 런타임 및 에이전트 엔드포인트 모두에 대한 자격 증명 기반 정책 및 리소스 기반 정책을 모두 AWS 평가합니다.

요청을 승인하려면 다음 조건을 충족해야 합니다.

예: 교차 계정 액세스 권한을 부여하려면 두 리소스 모두에 대한 정책이 필요합니다.

// Policy for Agent Runtime (attached to
// arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID)
{
"Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:role/CrossAccountRole"
            },
            "Action": "bedrock-agentcore:InvokeAgentRuntime",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID"
        }
    ]
}

// Policy for Agent Endpoint (attached to
// arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID/endpoint/ENDPOINTID)
{
"Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:role/CrossAccountRole"
            },
            "Action": "bedrock-agentcore:InvokeAgentRuntime",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID/endpoint/ENDPOINTID"
        }
    ]
}

인증 유형 고려 사항

리소스 기반 정책을 작성하는 방법은 에이전트 런타임 또는 게이트웨이에 대해 구성된 인증 유형에 따라 달라집니다.

정책 구조

리소스 기반 정책은 다음 구조의 JSON 문서입니다.

{
"Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "StatementId",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::account-id:role/role-name"
            },
            "Action": "bedrock-agentcore:ActionName",
            "Resource": "arn:aws:bedrock-agentcore:region:account-id:resource-type/resource-id",
            "Condition": {
                "ConditionOperator": {
                    "ConditionKey": "ConditionValue"
                }
            }
        }
    ]
}

지원되는 작업

에이전트 런타임 작업

게이트웨이 작업

메모리 작업

조건 키

조건 키를 사용하여 정책에서 액세스 제어를 더욱 구체화할 수 있습니다. 사용 가능한 조건 키의 전체 목록은 Bedrock AgentCore 조건 키 및 AWS 전역 조건 컨텍스트 키를 참조하세요.

일반적인 사용 사례 및 예제

이 섹션에서는 일반적인 시나리오에 대한 리소스 기반 정책의 실제 예를 제공합니다. 각 예제의 Resource 필드에는 정책이 연결된 리소스의 정확한 ARN이 포함되어야 합니다. 예제 ARNs 실제 리소스 ARNs.

다른 AWS 계정에서 역할 허용

API에 다른 AWS 계정의 특정 역할에 대한 액세스 권한을 부여합니다.

// Policy attached to arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID
{
"Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": [
                    "arn:aws:iam::123456789012:role/DeveloperRole",
                    "arn:aws:iam::123456789012:role/AdminRole"
                ]
            },
            "Action": "bedrock-agentcore:InvokeAgentRuntime",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID"
        }
    ]
}

소스 IP 주소를 기반으로 트래픽 거부

특정 IP 주소 범위에서 들어오는 트래픽 차단:

// Policy attached to arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID
{
"Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:role/ApplicationRole"
            },
            "Action": "bedrock-agentcore:InvokeAgentRuntime",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID"
        },
        {
            "Effect": "Deny",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:role/ApplicationRole"
            },
            "Action": "bedrock-agentcore:InvokeAgentRuntime",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID",
            "Condition": {
                "IpAddress": {
                    "aws:SourceIp": [
                        "192.0.2.0/24",
                        "198.51.100.0/24"
                    ]
                }
            }
        }
    ]
}

특정 VPC의 트래픽만 허용

특정 VPC의 요청에 대한 액세스를 제한합니다.

// Policy attached to arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID
{
"Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:role/ApplicationRole"
            },
            "Action": "bedrock-agentcore:InvokeAgentRuntime",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID"
        },
        {
            "Effect": "Deny",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:role/ApplicationRole"
            },
            "Action": "bedrock-agentcore:InvokeAgentRuntime",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID",
            "Condition": {
                "StringNotEquals": {
                    "aws:SourceVpc": "vpc-1a2b3c4d"
                }
            }
        }
    ]
}

VPC 제한을 사용한 OAuth 인증

에이전트 런타임 또는 게이트웨이가 OAuth 인증으로 구성된 경우 와일드카드 보안 주체를 사용해야 합니다. 이 예제에서는 OAuth 인증 요청을 특정 VPC로 제한합니다.

// Policy attached to arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID
{
"Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowOAuthFromVPC",
            "Effect": "Allow",
            "Principal": "*",
            "Action": "bedrock-agentcore:InvokeAgentRuntime",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID",
            "Condition": {
                "StringEquals": {
                    "aws:SourceVpc": "vpc-1a2b3c4d"
                }
            }
        }
    ]
}

리소스 정책 관리

다음 방법 중 하나를 선택합니다.

보안 모범 사례

최소 권한 적용

사용 사례에 필요한 최소 권한만 부여합니다.

// Policy attached to arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID
{
"Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::111122223333:role/ApplicationRole"
            },
            "Action": "bedrock-agentcore:InvokeAgentRuntime",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID"
        }
    ]
}

혼동된 대리자 방지

AWS 서비스에 대한 액세스 권한을 부여할 때는 항상 조건 키를 사용합니다.

// Policy attached to arn:aws:bedrock-agentcore:us-west-2:111122223333:gateway/GATEWAYID
{
"Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "lambda.amazonaws.com"
            },
            "Action": "bedrock-agentcore:InvokeGateway",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:gateway/GATEWAYID",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "111122223333"
                },
                "ArnEquals": {
                    "aws:SourceArn": "arn:aws:lambda:us-west-2:111122223333:function/SpecificFunction"
                }
            }
        }
    ]
}

중요한 제어에 명시적 거부 사용

보안에 중요한 제한 사항에 대해 명시적 거부 문을 사용합니다.

// Policy attached to arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID
{
"Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "DenyAllExceptVPC",
            "Effect": "Deny",
            "Principal": "*",
            "Action": "bedrock-agentcore:InvokeAgentRuntime",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID",
            "Condition": {
                "StringNotEquals": {
                    "aws:SourceVpc": "vpc-12345678"
                },
                "Bool": {
                    "aws:ViaAWSService": "false"
                }
            }
        }
    ]
}

문제 해결

액세스 거부 오류

“액세스 거부됨” 오류가 표시되는 경우:

정책 검증 오류

일반적인 정책 검증 오류: