

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Permissões do IAM para AgentCore Tempo de execução

A seguir estão as permissões do IAM necessárias para criar um agente em um AgentCore O tempo de execução e as permissões da função de execução que um agente precisa para executar em um AgentCore Tempo de execução. Você também pode usar políticas baseadas em recursos para controlar o acesso aos seus recursos de tempo de execução.

Para obter informações sobre o uso de políticas baseadas em recursos para controlar o acesso ao AgentCore Recursos de tempo de execução, consulte [Resource-based políticas para Amazon Bedrock AgentCore](resource-based-policies.md).

**Topics**
+ [Use o Amazon Bedrock AgentCore](#runtime-permissions-use-agentcore)
+ [Use o AgentCore CLI](#runtime-permissions-cli)
+ [Permissões de usuário para Amazon Bedrock AgentCore Console](#runtime-permissions-console)
+ [Função de execução para executar um agente em AgentCore Tempo de execução](#runtime-permissions-execution)

## Use o Amazon Bedrock AgentCore
<a name="runtime-permissions-use-agentcore"></a>

Para usar o Amazon Bedrock AgentCore, você pode anexar o [BedrockAgentCoreFullAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/BedrockAgentCoreFullAccess.html) AWS política gerenciada para seu usuário do IAM ou função do IAM. Isso AWS a política gerenciada concede amplas permissões, incluindo `GetWorkloadAccessTokenForUserId`, que permite emitir tokens de acesso à carga de trabalho usando cadeias de caracteres identificadoras de usuário fornecidas pelo chamador sem a verificação do token IdP. Recomendamos criar uma política personalizada com apenas as permissões que seu aplicativo exige, copiando as declarações relevantes e restringindo os recursos ao seu caso de uso específico. Para implantações de produção em que seu aplicativo tem tokens JWT disponíveis, negue explicitamente `GetWorkloadAccessTokenForUserId` e conceder somente `GetWorkloadAccessTokenForJWT`. Para obter mais informações, consulte [Obtenha o token de acesso à carga de trabalho](get-workload-access-token.md). Para usar o AgentCore CLI, você precisa [adicional](#runtime-permissions-cli) permissões.

## Use o AgentCore CLI
<a name="runtime-permissions-cli"></a>

O AgentCore Usos da CLI AWS CDK e AWS CloudFormation para implantar projetos. As permissões exigidas por uma implantação dependem do tempo de execução, do aproveitamento, da memória, do gateway e de outros recursos do projeto, portanto, não há uma política de privilégios mínima que se aplique a todos os projetos.

A identidade do IAM que é executada `agentcore deploy` precisa de permissão para:
+ Ligue `sts:GetCallerIdentity` e leia o `CDKToolkit` e `AgentCore-<project-name>-<target-name>` CloudFormation pilhas.
+ Inicialize a conta e a região de destino se `CDKToolkit` a pilha está ausente ou desatualizada. Se o ambiente já estiver inicializado, a identidade deverá ser capaz de assumir as funções de implantação e publicação de arquivos do CDK.
+ Crie, atualize e exclua o CloudFormation empilhe e provisione o AWS recursos declarados pelo projeto. Isso pode incluir a aprovação ou criação de funções do IAM e o uso do Amazon S3, Amazon ECR, AWS CodeBuild, CloudWatch Logs e Amazon Bedrock AgentCore.
+ Habilitar CloudWatch Pesquisa de transações. `agentcore deploy` ativa a Pesquisa de transações na conta e na região de destino, caso ainda não esteja ativa. Se a identidade não tiver as seguintes permissões, a implantação ignora essa etapa e continua. Para desativar essa etapa, execute `agentcore config transactionSearch false`.
  +  `xray:GetTraceSegmentDestination` 
  +  `xray:UpdateTraceSegmentDestination` 
  +  `xray:UpdateIndexingRule` 
  +  `logs:DescribeResourcePolicies` 
  +  `logs:PutResourcePolicy` 
  +  `application-signals:StartDiscovery` 

Para obter informações sobre as funções e os recursos criados durante o bootstrap, consulte [Inicializando seu ambiente para uso com o AWS CDK](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping-env.html).

**Importante**  
Use permissões amplas de implantação somente para desenvolvimento e teste. Para implantações de produção, pré-inicialize o ambiente e crie políticas personalizadas para as funções do CDK e os recursos do projeto que sigam o princípio do menor privilégio. Para obter orientações completas de segurança do IAM, consulte [Práticas recomendadas de segurança para AgentCore Tempo de execução](runtime-security-best-practices.md).

## Permissões de usuário para Amazon Bedrock AgentCore Console
<a name="runtime-permissions-console"></a>

Anexe o [BedrockAgentCoreFullAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/BedrockAgentCoreFullAccess.html) política para a função do console. Além disso, adicione as seguintes permissões para o IAM se quiser que o console de serviço crie automaticamente a função de execução.

```json
{
"Version": "2012-10-17",		 	 	 
  "Statement": [{
    "Sid": "IAMRoleAccess",
    "Effect": "Allow",
    "Action": ["iam:CreateRole"],
    "Resource": ["arn:aws:iam::*:role/service-role/AmazonBedrockAgentCoreRuntimeDefaultServiceRole-*"]
  }, {
    "Sid": "IAMPolicyAccess",
    "Effect": "Allow",
    "Action": ["iam:CreatePolicy"],
    "Resource": ["arn:aws:iam::*:policy/service-role/AmazonBedrockAgentCoreRuntimeExecutionPolicy_*"]
  }, {
    "Sid": "IAMRolePolicyAccess",
    "Effect": "Allow",
    "Action": ["iam:AttachRolePolicy"],
    "Resource": ["arn:aws:iam::*:role/service-role/AmazonBedrockAgentCoreRuntimeDefaultServiceRole-*"],
    "Condition": {
      "ArnLike": {
        "iam:PolicyARN": "arn:aws:iam::*:policy/service-role/AmazonBedrockAgentCoreRuntimeExecutionPolicy_*"
      }
    }
  }]
}
```

## Função de execução para executar um agente em AgentCore Tempo de execução
<a name="runtime-permissions-execution"></a>

Para executar o agente ou a ferramenta no AgentCore Tempo de execução: você precisa de um AWS Função de execução do gerenciamento de identidade e acesso. Para obter informações sobre como criar uma função do IAM, consulte [Criação de funções do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html).

**nota**  
Se o gerente de funções estiver habilitado em sua conta, AgentCore atribui a função para você, e a etapa de seleção de função descrita aqui é substituída por uma **Personalizar** opção. Para usar um perfil diferente, escolha **Personalizar**. Para saber mais informações, consulte [Criação do perfil do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) no *Guia do usuário do IAM*.

### Base da Amazônia AgentCore função de execução de implantação direta
<a name="runtime-permissions-direct-deploy-execution"></a>

O alicerce da Amazônia AgentCore A função de execução de implantação direta é uma função do IAM que a Amazon Bedrock AgentCore presume dirigir um agente. Substitua o seguinte:
+  `us-east-1` com o AWS Região que você está usando
+  `123456789012` com o seu AWS ID da conta
+  {{agentName}} com o nome do seu agente. Você precisará decidir o nome do agente antes de criar a função e AgentCore Tempo de execução.

```json
{
"Version": "2012-10-17",		 	 	 
  "Statement": [{
    "Effect": "Allow",
    "Action": [
      "logs:DescribeLogStreams",
      "logs:CreateLogGroup"
    ],
    "Resource": [
      "arn:aws:logs:us-east-1:123456789012:log-group:/aws/bedrock-agentcore/runtimes/*"
    ]
  }, {
    "Effect": "Allow",
    "Action": [
      "logs:PutResourcePolicy"
    ],
    "Resource": [
      "arn:aws:logs:us-east-1:123456789012:log-group:/aws/bedrock-agentcore/runtimes/agentName-*"
    ]
  }, {
    "Effect": "Allow",
    "Action": ["logs:DescribeLogGroups"],
    "Resource": ["arn:aws:logs:us-east-1:123456789012:log-group:*"]
  }, {
    "Effect": "Allow",
    "Action": [
      "logs:CreateLogStream",
      "logs:PutLogEvents"
    ],
    "Resource": [
      "arn:aws:logs:us-east-1:123456789012:log-group:/aws/bedrock-agentcore/runtimes/*:log-stream:*"
    ]
  }, {
    "Effect": "Allow",
    "Action": [
      "xray:PutTraceSegments",
      "xray:PutTelemetryRecords",
      "xray:GetSamplingRules",
      "xray:GetSamplingTargets"
    ],
    "Resource": ["*"]
  }, {
    "Effect": "Allow",
    "Resource": "*",
    "Action": "cloudwatch:PutMetricData",
    "Condition": {
      "StringEquals": {
        "cloudwatch:namespace": "bedrock-agentcore"
      }
    }
  }, {
    "Sid": "BedrockModelInvocation",
    "Effect": "Allow",
    "Action": [
      "bedrock:InvokeModel",
      "bedrock:InvokeModelWithResponseStream"
    ],
    "Resource": [
      "arn:aws:bedrock:*::foundation-model/*",
      "arn:aws:bedrock:us-east-1:123456789012:*"
    ]
  }]
}
```

### AgentCore Função de execução de tempo de
<a name="runtime-permissions-execution-role"></a>

O AgentCore A função de execução de tempo de execução é uma função do IAM que AgentCore O tempo de execução pressupõe a execução de um agente. Substitua o seguinte:
+  `us-east-1` com o AWS Região que você está usando
+  `123456789012` com o seu AWS ID da conta
+  {{agentName}} com o nome do seu agente. Você precisará decidir o nome do agente antes de criar a função e AgentCore Tempo de execução.

```json
{
"Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "ECRImageAccess",
            "Effect": "Allow",
            "Action": [
                "ecr:BatchGetImage",
                "ecr:GetDownloadUrlForLayer"
            ],
            "Resource": [
                "arn:aws:ecr:us-east-1:123456789012:repository/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "logs:DescribeLogStreams",
                "logs:CreateLogGroup"
            ],
            "Resource": [
                "arn:aws:logs:us-east-1:123456789012:log-group:/aws/bedrock-agentcore/runtimes/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "logs:PutResourcePolicy"
            ],
            "Resource": [
                "arn:aws:logs:us-east-1:123456789012:log-group:/aws/bedrock-agentcore/runtimes/agentName-*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "logs:DescribeLogGroups"
            ],
            "Resource": [
                "arn:aws:logs:us-east-1:123456789012:log-group:*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "logs:CreateLogStream",
                "logs:PutLogEvents"
            ],
            "Resource": [
                "arn:aws:logs:us-east-1:123456789012:log-group:/aws/bedrock-agentcore/runtimes/*:log-stream:*"
            ]
        },
        {
            "Sid": "ECRTokenAccess",
            "Effect": "Allow",
            "Action": [
                "ecr:GetAuthorizationToken"
            ],
            "Resource": "*"
        },
        {
        "Effect": "Allow",
        "Action": [
            "xray:PutTraceSegments",
            "xray:PutTelemetryRecords",
            "xray:GetSamplingRules",
            "xray:GetSamplingTargets"
            ],
         "Resource": [ "*" ]
         },
         {
            "Effect": "Allow",
            "Resource": "*",
            "Action": "cloudwatch:PutMetricData",
            "Condition": {
                "StringEquals": {
                    "cloudwatch:namespace": "bedrock-agentcore"
                }
            }
        },
        {
            "Sid": "GetAgentAccessToken",
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:GetWorkloadAccessToken",
                "bedrock-agentcore:GetWorkloadAccessTokenForJWT",
                "bedrock-agentcore:GetWorkloadAccessTokenForUserId"
            ],
            "Resource": [
              "arn:aws:bedrock-agentcore:us-east-1:123456789012:workload-identity-directory/default",
              "arn:aws:bedrock-agentcore:us-east-1:123456789012:workload-identity-directory/default/workload-identity/agentName-*"
            ]
        },
         {"Sid": "BedrockModelInvocation",
         "Effect": "Allow",
         "Action": [
                "bedrock:InvokeModel",
                "bedrock:InvokeModelWithResponseStream"
              ],
        "Resource": [
            "arn:aws:bedrock:*::foundation-model/*",
            "arn:aws:bedrock:us-east-1:123456789012:*"
        ]
        }
    ]
}
```

### AgentCore Política de confiança em tempo de execução
<a name="runtime-permissions-trust-policy"></a>

O AgentCore A função de execução de tempo de execução deve incluir a seguinte política de confiança, que permite a AgentCore Tempo de execução para assumir a função.

Na política, substitua:
+  `us-east-1` com o AWS Região que você está usando
+  `123456789012` com o seu AWS ID da conta

Para adicionar a política de confiança ao AgentCore Função de execução de tempo de execução, acesse a AWS Console de gerenciamento, navegue até a função, escolha a **Relações de confiança** aba e escolha **Editar política de confiança**.

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