Resource-based políticas para Amazon Bedrock AgentCore

Resource-based as políticas no Amazon Bedrock AgentCore permitem que você controle quais diretores (AWS contas, usuários do IAM ou funções do IAM) podem invocar e gerenciar seus AgentCore recursos do Amazon Bedrock (atualmente compatíveis com Runtime, Gateway e Memory). Você pode anexar IAM-style políticas diretamente aos seus recursos para definir regras sobre quem pode iniciar sessões de tempo de execução, invocar um gateway, acessar a memória ou realizar outras ações de gerenciamento e invocação.

Resource-based as políticas funcionam em conjunto com as políticas do IAM baseadas em identidade para fornecer controle de acesso aos seus recursos do Amazon Bedrock. AgentCore Enquanto as políticas baseadas em identidade são anexadas às identidades do IAM e especificam quais ações elas podem realizar, as políticas baseadas em recursos são anexadas diretamente aos recursos e especificam quem pode acessá-los.

Recursos compatíveis

O Amazon Bedrock AgentCore oferece suporte a políticas baseadas em recursos para os seguintes recursos:

Como as políticas baseadas em recursos funcionam

Identity-based versus políticas baseadas em recursos

Avaliação de políticas

Quando uma solicitação é feita a um AgentCore recurso do Amazon Bedrock, AWS avalia as políticas baseadas em identidade e em recursos. A tabela a seguir mostra como diferentes combinações de políticas afetam o acesso:

Princípios fundamentais:

Autorização hierárquica para tempo de execução e endpoint do agente

Os endpoints do agente são pontos de acesso endereçáveis para versões específicas do tempo de execução de um agente. Cada endpoint aponta para uma versão específica da configuração de tempo de execução, com um endpoint DEFAULT roteando automaticamente para a versão mais recente. Ao autorizar operações de API de tempo de execução, como InvokeAgentRuntime eInvokeAgentRuntimeCommand, AWS avalia as políticas baseadas em identidade e em recursos para o tempo de execução do agente e o endpoint do agente que está sendo invocado.

Para que uma solicitação seja autorizada, as seguintes condições devem ser atendidas:

Exemplo: a concessão de acesso entre contas exige políticas em ambos os recursos:

// 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"
        }
    ]
}

Considerações sobre o tipo de autenticação

A maneira como você escreve políticas baseadas em recursos depende do tipo de autenticação configurado para seu Agent Runtime ou Gateway:

Estrutura da política

Uma política baseada em recursos é um documento JSON com a seguinte estrutura:

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

Ações compatíveis

ações do Agent Runtime

Ações do gateway

Ações de memória

Chaves de condição

Você pode usar chaves de condição para refinar ainda mais o controle de acesso em suas políticas. Para obter uma lista completa das chaves de condição disponíveis, consulte Chaves de AgentCore condição Bedrock e Chaves de contexto de condição AWS global.

Casos de uso e exemplos comuns

Esta seção fornece exemplos práticos de políticas baseadas em recursos para cenários comuns. O Resource campo em cada exemplo deve conter o ARN exato do recurso ao qual a política está anexada. Substitua os ARNs de exemplo pelos ARNs de seus recursos reais.

Permitir funções em outra AWS account

Conceda acesso à API a funções específicas em uma AWS conta diferente:

// 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"
        }
    ]
}

Negar tráfego com base no endereço IP de origem

Bloqueie o tráfego de entrada de intervalos específicos de endereços 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"
                    ]
                }
            }
        }
    ]
}

Permitir tráfego somente de uma VPC específica

Restrinja o acesso às solicitações de uma VPC específica:

// 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"
                }
            }
        }
    ]
}

Autenticação OAuth com restrição de VPC

Quando seu Agent Runtime ou Gateway é configurado com a autenticação OAuth, você deve usar um principal curinga. Este exemplo restringe as OAuth-authenticated solicitações a uma VPC específica:

// 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"
                }
            }
        }
    ]
}

Gerenciar políticas de recursos

Selecione um dos seguintes métodos:

Práticas recomendadas de segurança

Conceder privilégio mínimo

Conceda somente as permissões mínimas necessárias para seu caso de uso:

// 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"
        }
    ]
}

Evite confusões, delegado

Sempre use chaves de condição ao conceder acesso aos AWS serviços:

// 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"
                }
            }
        }
    ]
}

Use negação explícita para controles críticos

Use declarações de negação explícitas para restrições críticas de segurança:

// 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"
                }
            }
        }
    ]
}

Solução de problemas

Erros de acesso negado

Se você receber um erro de “Acesso negado”:

Erros de validação de políticas

Erros comuns de validação de políticas: