

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Permisos de IAM para AgentCore Tiempo de ejecución

Los siguientes son los permisos de IAM que necesita para crear un agente en un AgentCore Los permisos de ejecución y rol de ejecución que un agente necesita para ejecutarse en un AgentCore Tiempo de ejecución. También puedes usar políticas basadas en recursos para controlar el acceso a tus recursos de tiempo de ejecución.

Para obtener información sobre el uso de políticas basadas en recursos para controlar el acceso a sus AgentCore Recursos de tiempo de ejecución, consulte [Resource-based políticas de Amazon Bedrock AgentCore](resource-based-policies.md).

**Topics**
+ [Usa Amazon Bedrock AgentCore](#runtime-permissions-use-agentcore)
+ [Usa el AgentCore CLI](#runtime-permissions-cli)
+ [Permisos de usuario para Amazon Bedrock AgentCore Consola](#runtime-permissions-console)
+ [Función de ejecución para ejecutar un agente en AgentCore Tiempo de ejecución](#runtime-permissions-execution)

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

Para usar Amazon Bedrock AgentCore, puede adjuntar el [BedrockAgentCoreFullAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/BedrockAgentCoreFullAccess.html) AWS política administrada a su usuario o rol de IAM. Esto AWS la política gestionada otorga amplios permisos, que incluyen `GetWorkloadAccessTokenForUserId`, que permite emitir tokens de acceso a la carga de trabajo mediante cadenas de identificación de usuario suministradas por la persona que llama sin verificar el token de IdP. Te recomendamos crear una política personalizada con solo los permisos que requiere tu aplicación, copiando las declaraciones pertinentes y restringiendo los recursos a tu caso de uso específico. En el caso de las implementaciones de producción en las que tu aplicación tenga disponibles los tokens de JWT, denégalos de forma explícita `GetWorkloadAccessTokenForUserId` y solo conceder `GetWorkloadAccessTokenForJWT`. Para obtener más información, consulte [Consiga el token de acceso a la carga](get-workload-access-token.md). Para usar el AgentCore CLI, necesita [adicional](#runtime-permissions-cli) permisos.

## Usa el AgentCore CLI
<a name="runtime-permissions-cli"></a>

El AgentCore La CLI utiliza AWS CDK y AWS CloudFormation para implementar proyectos. Los permisos que requiere una implementación dependen del tiempo de ejecución, el arnés, la memoria, la puerta de enlace y otros recursos del proyecto, por lo que no hay una política de privilegios mínimos que se aplique a todos los proyectos.

La identidad de IAM que se ejecuta `agentcore deploy` necesita permiso para:
+ Llamar `sts:GetCallerIdentity` y lee el `CDKToolkit` y `AgentCore-<project-name>-<target-name>` CloudFormation pilas.
+ Arranque la cuenta de destino y la región si `CDKToolkit` falta la pila o está desactualizada. Si el entorno ya se ha iniciado, la identidad debe poder asumir las funciones de implementación y publicación de archivos del CDK.
+ Cree, actualice y elimine el CloudFormation apile y aprovisione el AWS recursos declarados por el proyecto. Esto puede incluir la transferencia o la creación de funciones de IAM y el uso de Amazon S3, Amazon ECR, AWS CodeBuild, CloudWatch Logs y Amazon Bedrock AgentCore.
+ Habilitar CloudWatch Búsqueda de transacciones. `agentcore deploy` activa la búsqueda de transacciones en la cuenta y región de destino si aún no está activa. Si la identidad carece de los siguientes permisos, la implementación omite este paso y continúa. Para desactivar este paso, ejecute `agentcore config transactionSearch false`.
  +  `xray:GetTraceSegmentDestination` 
  +  `xray:UpdateTraceSegmentDestination` 
  +  `xray:UpdateIndexingRule` 
  +  `logs:DescribeResourcePolicies` 
  +  `logs:PutResourcePolicy` 
  +  `application-signals:StartDiscovery` 

Para obtener información sobre las funciones y los recursos creados durante el arranque, consulte [Arrancar su entorno para usarlo con el AWS CDK](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping-env.html).

**importante**  
Utilice permisos de implementación amplios solo para el desarrollo y las pruebas. Para las implementaciones de producción, inicie previamente el entorno y cree políticas personalizadas para las funciones del CDK y los recursos del proyecto que sigan el principio de privilegios mínimos. Para obtener una guía completa de seguridad de IAM, consulte [Mejores prácticas de seguridad para AgentCore Tiempo de ejecución](runtime-security-best-practices.md).

## Permisos de usuario para Amazon Bedrock AgentCore Consola
<a name="runtime-permissions-console"></a>

Adjunte el [BedrockAgentCoreFullAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/BedrockAgentCoreFullAccess.html) la política a la función de consola. Además, añada los siguientes permisos para IAM si desea que la consola de servicio cree automáticamente el rol de ejecución.

```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_*"
      }
    }
  }]
}
```

## Función de ejecución para ejecutar un agente en AgentCore Tiempo de ejecución
<a name="runtime-permissions-execution"></a>

Para ejecutar un agente o una herramienta en AgentCore En tiempo de ejecución, necesita un AWS Función de ejecución de la administración de identidades y accesos. Para obtener información sobre la creación de un rol de IAM, consulte [Creación de roles de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html).

**nota**  
Si el administrador de funciones está habilitado en su cuenta, AgentCore asigna el rol en su nombre y el paso de selección del rol que se describe aquí se sustituye por un **Personaliza** opción. Para usar un rol diferente, elija **Personalizar**. Para obtener más información, consulte [Creación de roles de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) en la *Guía del usuario de IAM*.

### Amazon Bedrock AgentCore rol de ejecución de implementación directa
<a name="runtime-permissions-direct-deploy-execution"></a>

El lecho rocoso de Amazon AgentCore La función de ejecución de implementación directa es una función de IAM de Amazon Bedrock AgentCore asume que ejecuta un agente. Sustituya lo siguiente:
+  `us-east-1` con el AWS Región que está utilizando
+  `123456789012` con tu AWS ID de cuenta
+  {{agentName}} con el nombre de tu agente. Deberás decidir el nombre del agente antes de crear el rol y AgentCore Tiempo de ejecución.

```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 Función de ejecución en tiempo de ejecución
<a name="runtime-permissions-execution-role"></a>

El AgentCore La función de ejecución en tiempo de ejecución es una función de IAM que AgentCore Runtime asume la ejecución de un agente. Sustituya lo siguiente:
+  `us-east-1` con el AWS Región que está utilizando
+  `123456789012` con tu AWS ID de cuenta
+  {{agentName}} con el nombre de tu agente. Deberás decidir el nombre del agente antes de crear el rol y AgentCore Tiempo de ejecución.

```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 confianza en tiempo de ejecución
<a name="runtime-permissions-trust-policy"></a>

La AgentCore La función de ejecución en tiempo de ejecución debe incluir la siguiente política de confianza, que permite AgentCore Runtime para asumir la función.

En la política, sustituya:
+  `us-east-1` con el AWS Región que está utilizando
+  `123456789012` con tu AWS ID de cuenta

Para agregar la política de confianza a la AgentCore Función de ejecución en tiempo de ejecución, vaya a AWS Consola de administración, navegue hasta el rol, elija **Relaciones de confianza** tabular y elegir **Editar la política de confianza**.

```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:*"
            }
       }
    }
  ]
}
```