Configurar permissões para o AgentCore Gateway

Para usar o Amazon Bedrock AgentCore Gateway e seus recursos, você precisará considerar as seguintes permissões:

Escolha um tópico para saber mais:

Construtor de gateway e permissões de usuário

Para que uma identidade possa criar, gerenciar ou usar gateways, você precisa anexar uma política baseada em identidade à identidade do IAM para permitir que ela execute ações do Amazon Bedrock. AgentCore-related Para obter permissões abrangentes, você pode usar a política BedrockAgentCoreFullAccessgerenciada.

Para maior segurança e controle, você pode criar sua própria política personalizada reduzindo as permissões na política de acesso total. Por exemplo, a política a seguir permite que uma identidade execute ações relacionadas ao AgentCore Gateway, mas não a outros AgentCore serviços, como AgentCore Runtime ou AgentCore Browser:

{
"Version":"2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:*Gateway*",
        "bedrock-agentcore:*WorkloadIdentity",
        "bedrock-agentcore:*CredentialProvider",
        "bedrock-agentcore:*Token*",
        "bedrock-agentcore:*Access*"
      ],
      "Resource": "arn:aws:bedrock-agentcore:*:*:*gateway*"
    }
  ]
}

{
"Version":"2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:ListGateways",
        "bedrock-agentcore:GetGateway",
        "bedrock-agentcore:ListGatewayTargets",
        "bedrock-agentcore:GetGatewayTarget"
      ],
      "Resource": "arn:aws:bedrock-agentcore:*:*:*gateway*"
    }
  ]
}

Permissões de acesso ao gateway (autorização de entrada)

Além das permissões relacionadas ao gateway, você também precisará configurar permissões para que as identidades possam acessar o gateway durante a invocação. Você configurará essas permissões ao configurar a autorização de entrada.

AgentCore Permissões da função de serviço do gateway

Ao criar um gateway, você precisa de uma função de serviço que tenha permissões para assumir uma função do IAM e acessar AWS recursos e serviços externos em nome da função do IAM. Você pode criar a função de serviço das seguintes formas:

As permissões necessárias para uma função de serviço estão nos seguintes tópicos:

Permissões de confiança

Uma função de serviço deve ter uma política de confiança anexada que permita ao AgentCore serviço assumir uma identidade do IAM e realizar ações em seu nome.

Veja a seguir um exemplo de uma política de confiança que você pode usar.

{
"Version":"2012-10-17",
  "Statement": [
    {
      "Sid": "GatewayAssumeRolePolicy",
      "Effect": "Allow",
      "Principal": {
        "Service": "bedrock-agentcore.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "111122223333"
        },
        "ArnLike": {
          "aws:SourceArn": "arn:aws:bedrock-agentcore:us-east-1:111122223333:gateway/gateway-name-*"
        }
      }
    }
  ]
}

Permissões de autorização de saída

Dependendo do tipo de autorização de saída que você usa para seus destinos de gateway, você precisa adicionar permissões à função de serviço para permitir que ela invoque o destino. Essas permissões permitem que a função de serviço do gateway recupere as credenciais de autorização para invocar o destino. Você pode fazer isso no processo de configuração da autorização de saída.

Permissões para acessar AWS recursos

Dependendo da configuração do gateway ou dos destinos que você escolher adicionar ao gateway, talvez seja necessário adicionar permissões à função de serviço do gateway para permitir que ele acesse AWS recursos. Os tópicos a seguir abrangem alguns recursos aos quais sua função de serviço de gateway pode precisar acessar:

{
"Version": "2012-10-17",
    "Statement": [{
        "Sid": "AmazonBedrockAgentCoreGatewayLambdaProd",
        "Effect": "Allow",
        "Action": [
            "lambda:InvokeFunction"
        ],
        "Resource": [
            "arn:aws:lambda:us-east-1:123456789012:function:FunctionName"
        ]
    }]
}

{
"Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "LambdaAllowGatewayServiceRoleMyFunction",
            "Effect": "Allow",
            "Principal": {
              "AWS": "arn:aws:iam::123456789012:role/MyGatewayExecutionRole"
            },
            "Action": "lambda:InvokeFunction",
            "Resource":  "arn:aws:lambda:us-east-1:123456789012:function:MyFunction"
        }
     ]
}

{
"Version":"2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:GetItem",
        "dynamodb:PutItem",
        "dynamodb:UpdateItem",
        "dynamodb:DeleteItem",
        "dynamodb:Query",
        "dynamodb:Scan"
      ],
      "Resource": "arn:aws:dynamodb:*:*:table/*"
    }
  ]
}

Práticas recomendadas para permissões de gateway