Uso de roles vinculados a servicios para Amazon Bedrock AgentCore

Amazon Bedrock AgentCore utiliza funciones vinculadas al servicio AWS Identity and Access Management (IAM). Un rol vinculado a un servicio es un tipo único de rol de IAM al que se vincula directamente. AgentCore Service-linked Los roles están predefinidos AgentCore e incluyen todos los permisos que el servicio necesita para llamar a otros AWS servicios en su nombre.

Un rol vinculado a un servicio facilita su uso AgentCore , ya que no es necesario añadir manualmente los permisos necesarios. AgentCore define los permisos de sus funciones vinculadas al servicio y, a menos que se defina lo contrario, solo AgentCore puede asumir sus funciones. Los permisos definidos incluyen las políticas de confianza y de permisos, y que la política de permisos no se pueda asociar a ninguna otra entidad de IAM.

Las funciones se pueden eliminar únicamente después de eliminar primero sus recursos relacionados. Esto protege sus AgentCore recursos porque no puede eliminar inadvertidamente el permiso de acceso a los recursos.

AgentCore usa las siguientes funciones vinculadas a un servicio:

AgentCore permisos de roles vinculados al servicio

rol vinculado a un servicio de red

AgentCore usa el rol vinculado al servicio denominado AWSServiceRoleForBedrockAgentCoreNetwork para permitir AgentCore crear y administrar interfaces de red en su VPC en su nombre.

El rol vinculado al servicio AWSServiceRoleForBedrockAgentCoreNetwork depende de los siguientes servicios para asumir el rol:

La política de permisos de roles permite AgentCore realizar las siguientes acciones en los recursos especificados:

Puede ver la política completa en BedrockAgentCoreNetworkServiceRolePolicy.

{
"Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowCreateEniInAnySubnet",
            "Effect": "Allow",
            "Action": "ec2:CreateNetworkInterface",
            "Resource": "arn:aws:ec2:*:*:subnet/*"
        },
        {
            "Sid": "AllowCreateEniWithSecurityGroups",
            "Effect": "Allow",
            "Action": "ec2:CreateNetworkInterface",
            "Resource": "arn:aws:ec2:*:*:security-group/*"
        },
        {
            "Sid": "AllowCreateEniWithBedrockManagedRequestTag",
            "Effect": "Allow",
            "Action": "ec2:CreateNetworkInterface",
            "Resource": "arn:aws:ec2:*:*:network-interface/*",
            "Condition": {
                "ForAllValues:StringEquals": {
                    "aws:TagKeys": [
                        "AmazonBedrockAgentCoreManaged"
                    ]
                },
                "StringEquals": {
                    "aws:RequestTag/AmazonBedrockAgentCoreManaged": "true"
                }
            }
        },
        {
            "Sid": "AllowTagEniOnCreate",
            "Effect": "Allow",
            "Action": "ec2:CreateTags",
            "Resource": "arn:aws:ec2:*:*:network-interface/*",
            "Condition": {
                "StringEquals": {
                    "ec2:CreateAction": "CreateNetworkInterface"
                }
            }
        },
        {
            "Sid": "AllowManageEniWhenBedrockManaged",
            "Effect": "Allow",
            "Action": [
                "ec2:DeleteNetworkInterface",
                "ec2:AssignPrivateIpAddresses",
                "ec2:UnassignPrivateIpAddresses",
                "ec2:CreateNetworkInterfacePermission"
            ],
            "Resource": "arn:aws:ec2:*:*:network-interface/*",
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/AmazonBedrockAgentCoreManaged": "true"
                }
            }
        },
        {
            "Sid": "AllowGetSecurityGroupsForVpc",
            "Effect": "Allow",
            "Action": [
                "ec2:GetSecurityGroupsForVPC"
            ],
            "Resource": "arn:aws:ec2:*:*:vpc/*"
        },
        {
            "Sid": "AllowDescribeNetworkingResources",
            "Effect": "Allow",
            "Action": [
                "ec2:DescribeNetworkInterfaces",
                "ec2:DescribeSecurityGroups",
                "ec2:DescribeSubnets",
                "ec2:DescribeVpcs"
            ],
            "Resource": "*"
        }
    ]
}

Función vinculada al servicio de identidad

AgentCore utiliza el rol vinculado al servicio denominado AWSServiceRoleForBedrockAgentCoreRuntimeIdentity para permitir gestionar la carga de trabajo, los tokens de acceso AgentCore a la identidad y las credenciales de OAuth en su nombre.

El rol vinculado al servicio AWSServiceRoleForBedrockAgentCoreRuntimeIdentity depende de los siguientes servicios para asumir el rol:

La política de permisos del rol permite AgentCore realizar estas acciones en los recursos especificados.

Puede ver la política completa en BedrockAgentCoreRuntimeIdentityServiceRolePolicy.

{
"Version": "2012-10-17",
    "Statement": {
        "Sid": "AllowWorkloadIdentityAccess",
        "Effect": "Allow",
        "Action": [
            "bedrock-agentcore:GetWorkloadAccessToken",
            "bedrock-agentcore:GetWorkloadAccessTokenForJWT",
            "bedrock-agentcore:GetWorkloadAccessTokenForUserId"
        ],
        "Resource": [
            "arn:aws:bedrock-agentcore:*:*:workload-identity-directory/default",
            "arn:aws:bedrock-agentcore:*:*:workload-identity-directory/default/workload-identity/*"
        ]
    }
}

Para obtener información sobre los cambios en esta política, consulte AgentCore las actualizaciones de las políticas AWS gestionadas.

Comprensión de la función de identidad

La función vinculada al servicio se utiliza para admitir la autenticación de OAuth y las funciones de token portador JWT para los recursos de Runtime. AgentCore Esta función permite a los agentes gestionar de forma segura las identidades de las cargas de trabajo y acceder a proveedores de OAuth externos en nombre de los usuarios.

Ventajas clave de la gestión de identidades

Cómo funciona la gestión de identidades

Al invocar un AgentCore Runtime con autenticación OAuth o tokens portadores JWT:

Migración desde un enfoque tradicional

La función vinculada al servicio garantiza que solo AgentCore pueda acceder a los recursos de identidad de la carga de trabajo que estén asociados explícitamente a los tiempos de ejecución de sus agentes, manteniendo un aislamiento seguro y una atribución clara de los recursos.

Para obtener información detallada sobre la implementación, consulte Autenticar y autorizar con autenticación entrante y autenticación saliente.

Función vinculada al servicio Gateway

AgentCore utiliza el rol vinculado al servicio denominado AWSServiceRoleForBedrockAgentCoreGatewayNetwork para permitir a AgentCore Gateway crear y gestionar los recursos de Amazon VPC Lattice en su cuenta en su nombre. Esta función se utiliza cuando se configura un destino de puerta de enlace con un punto de enlace privado administrado, lo que permite a AgentCore Gateway configurar las puertas de enlace de recursos de VPC Lattice necesarias para la conectividad privada con los recursos de su VPC.

El rol vinculado al servicio AWSServiceRoleForBedrockAgentCoreGatewayNetwork depende de los siguientes servicios para asumir el rol:

La política de permisos de roles permite AgentCore realizar las siguientes acciones en los recursos especificados:

Puede ver la política completa en BedrockAgentCoreGatewayNetworkServiceRolePolicy.

{
"Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowSLRActionsForLattice",
            "Effect": "Allow",
            "Action": [
                "iam:CreateServiceLinkedRole"
            ],
            "Resource": [
                "arn:aws:iam::*:role/aws-service-role/vpc-lattice.amazonaws.com/AWSServiceRoleForVpcLattice"
            ],
            "Condition": {
                "StringEquals": {
                    "iam:AWSServiceName": "vpc-lattice.amazonaws.com"
                }
            }
        },
        {
            "Sid": "AllowResourceGatewayCreate",
            "Effect": "Allow",
            "Action": [
                "vpc-lattice:CreateResourceGateway",
                "vpc-lattice:TagResource"
            ],
            "Resource": [
                "arn:aws:vpc-lattice:*:*:resourcegateway/*"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:RequestTag/BedrockAgentCoreGatewayManaged": "true",
                    "aws:ResourceTag/BedrockAgentCoreGatewayManaged": "true"
                }
            }
        },
        {
            "Sid": "AllowEC2PermissionsForResourceGatewayCreate",
            "Effect": "Allow",
            "Action": [
                "ec2:DescribeSubnets",
                "ec2:DescribeVpcs",
                "ec2:DescribeSecurityGroups"
            ],
            "Resource": [
                "*"
            ]
        },
        {
            "Sid": "AllowResourceGatewayDelete",
            "Effect": "Allow",
            "Action": [
                "vpc-lattice:DeleteResourceGateway",
                "vpc-lattice:GetResourceGateway"
            ],
            "Resource": [
                "*"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/BedrockAgentCoreGatewayManaged": "true"
                }
            }
        }
    ]
}

Comprensión de la función Gateway Managed Lattice

La función vinculada al servicio se utiliza para respaldar la función de punto final privado administrado para AgentCore los objetivos de Gateway. Cuando crea un destino de puerta de enlace con un punto de enlace privado administrado, AgentCore utiliza este rol para crear y administrar las puertas de enlace de recursos de VPC Lattice en su cuenta en su nombre. Estas puertas de enlace de recursos gestionadas permiten la conectividad privada entre la AgentCore puerta de enlace y los recursos de su VPC sin necesidad de configurar los recursos de VPC Lattice de forma manual.

Ventajas clave de los recursos de Managed Lattice

¿Cómo funcionan los recursos de Managed Lattice

Al crear un destino de puerta de enlace con un punto final privado gestionado:

Función vinculada al servicio de Identity Network

AgentCore utiliza el rol vinculado al servicio denominado AWSServiceRoleForBedrockAgentCoreIdentity para permitir que AgentCore Identity cree y gestione los recursos de Amazon VPC Lattice en su cuenta en su nombre. Esta función se utiliza cuando se configura un punto final privado para un proveedor de identidades privado, lo que permite a AgentCore Identity configurar las pasarelas de recursos de VPC Lattice necesarias para la conectividad privada con los proveedores de identidad de su VPC.

El rol vinculado al servicio AWSServiceRoleForBedrockAgentCoreIdentity depende de los siguientes servicios para asumir el rol:

La política de permisos de roles permite AgentCore realizar las siguientes acciones en los recursos especificados:

Puede ver la política completa en AWSBedrockAgentCoreIdentityNetworkServiceRolePolicy.

{
  "Version" : "2012-10-17",
  "Statement" : [
    {
      "Sid" : "AllowSLRActionsForLattice",
      "Effect" : "Allow",
      "Action" : [
        "iam:CreateServiceLinkedRole"
      ],
      "Resource" : [
        "arn:aws:iam::*:role/aws-service-role/vpc-lattice.amazonaws.com/AWSServiceRoleForVpcLattice"
      ],
      "Condition" : {
        "StringEquals" : {
          "iam:AWSServiceName" : "vpc-lattice.amazonaws.com"
        }
      }
    },
    {
      "Sid" : "AllowResourceGatewayCreate",
      "Effect" : "Allow",
      "Action" : [
        "vpc-lattice:CreateResourceGateway",
        "vpc-lattice:TagResource"
      ],
      "Resource" : [
        "arn:aws:vpc-lattice:*:*:resourcegateway/*"
      ],
      "Condition" : {
        "StringEquals" : {
          "aws:RequestTag/BedrockAgentCoreIdentityManaged" : "true",
          "aws:ResourceTag/BedrockAgentCoreIdentityManaged" : "true"
        }
      }
    },
    {
      "Sid" : "AllowEC2PermissionsForResourceGatewayCreate",
      "Effect" : "Allow",
      "Action" : [
        "ec2:DescribeSubnets",
        "ec2:DescribeVpcs",
        "ec2:DescribeSecurityGroups"
      ],
      "Resource" : [
        "*"
      ]
    },
    {
      "Sid" : "AllowResourceGatewayDelete",
      "Effect" : "Allow",
      "Action" : [
        "vpc-lattice:DeleteResourceGateway",
        "vpc-lattice:GetResourceGateway"
      ],
      "Resource" : [
        "*"
      ],
      "Condition" : {
        "StringEquals" : {
          "aws:ResourceTag/BedrockAgentCoreIdentityManaged" : "true"
        }
      }
    }
  ]
}

Comprensión de la función Identity Network

La función vinculada al servicio se utiliza para respaldar la función de punto final privado administrado de Identity. AgentCore Cuando configura un punto final privado para un proveedor de identidades privadas, AgentCore utiliza este rol para crear y administrar las puertas de enlace de recursos de VPC Lattice en su cuenta en su nombre. Estas pasarelas de recursos gestionados permiten la conectividad privada entre la AgentCore identidad y los proveedores de identidad de su VPC, como Keycloak autohospedado, u OIDC-compliant otros servidores de autorización PingFederate, sin necesidad de configurar los recursos de VPC Lattice de forma manual.

Cómo funcionan los recursos de Managed Lattice para Identity

Al configurar un punto final privado para un proveedor de identidades privadas:

Para obtener más información sobre la configuración de proveedores de identidad privados, consulte Conectarse a proveedores de identidad privados en su VPC.

Crear un rol vinculado a un servicio para AgentCore

No es necesario crear manualmente los roles vinculados al servicio. AgentCore los crea automáticamente cuando es necesario:

Si eliminas un rol vinculado a un servicio y luego necesitas volver a crearlo, puedes usar el mismo proceso para volver a crear el rol en tu cuenta. Al crear los AgentCore recursos adecuados, vuelve a crear el AgentCore rol vinculado al servicio para usted.

Permisos necesarios para crear un rol vinculado a un servicio

Debe configurar permisos para permitir a una entidad de IAM (como un usuario, grupo o rol) crear, editar o eliminar un rol vinculado a servicios. La entidad de IAM debe tener los siguientes permisos:

Para la función vinculada al servicio de red

{
    "Action": "iam:CreateServiceLinkedRole",
    "Effect": "Allow",
    "Resource": "arn:aws:iam::*:role/aws-service-role/network.bedrock-agentcore.amazonaws.com/AWSServiceRoleForBedrockAgentCoreNetwork",
    "Condition": {
        "StringLike": {
            "iam:AWSServiceName": "network.bedrock-agentcore.amazonaws.com"
        }
    }
}

Para el rol vinculado al servicio de identidad

{
    "Sid": "CreateBedrockAgentCoreRuntimeIdentityServiceLinkedRolePermissions",
    "Effect": "Allow",
    "Action": "iam:CreateServiceLinkedRole",
    "Resource": "arn:aws:iam::*:role/aws-service-role/runtime-identity.bedrock-agentcore.amazonaws.com/AWSServiceRoleForBedrockAgentCoreRuntimeIdentity",
    "Condition": {
        "StringEquals": {
            "iam:AWSServiceName": "runtime-identity.bedrock-agentcore.amazonaws.com"
        }
    }
}

Para el rol vinculado al servicio Gateway

{
    "Effect": "Allow",
    "Action": "iam:CreateServiceLinkedRole",
    "Resource": "arn:aws:iam::*:role/aws-service-role/bedrock-agentcore.amazonaws.com/AWSServiceRoleForBedrockAgentCoreGatewayNetwork",
    "Condition": {
        "StringEquals": {
            "iam:AWSServiceName": "bedrock-agentcore.amazonaws.com"
        }
    }
}

Para el rol vinculado al servicio de Identity Network

{
    "Effect": "Allow",
    "Action": "iam:CreateServiceLinkedRole",
    "Resource": "arn:aws:iam::*:role/aws-service-role/identity-network.bedrock-agentcore.amazonaws.com/AWSServiceRoleForBedrockAgentCoreIdentity",
    "Condition": {
        "StringEquals": {
            "iam:AWSServiceName": "identity-network.bedrock-agentcore.amazonaws.com"
        }
    }
}

Estos permisos ya están incluidos en la política AWS administrada. BedrockAgentCoreFullAccess

Edición de un rol vinculado a un servicio para AgentCore

AgentCore no permite editar los rolesAWSServiceRoleForBedrockAgentCoreNetwork, AWSServiceRoleForBedrockAgentCoreRuntimeIdentityAWSServiceRoleForBedrockAgentCoreGatewayNetwork, o vinculados al AWSServiceRoleForBedrockAgentCoreIdentity servicio. Después de crear un rol vinculado al servicio, no podrá cambiar el nombre del rol, ya que varias entidades podrían hacer referencia al rol. Sin embargo, sí puede editar la descripción del rol con IAM. Para obtener más información, consulte Edición de un rol vinculado a un servicio.

Eliminar un rol vinculado a un servicio para AgentCore

Si ya no necesita usar una característica o servicio que requieran un rol vinculado a un servicio, le recomendamos que elimine dicho rol. Así no tendrá una entidad no utilizada que no se supervise ni mantenga de forma activa. Sin embargo, debe eliminar todos los AgentCore recursos que utilizan el rol vinculado al servicio antes de poder eliminar el rol:

Limpiar un rol vinculado a servicios

Antes de poder utilizar IAM para eliminar un rol vinculado a un servicio, primero debe confirmar que dicho rol no tiene sesiones activas y eliminar los recursos que utiliza.

Para comprobar si el rol vinculado al servicio tiene una sesión activa en la consola de IAM

Si desea eliminar un rol vinculado a un servicio, primero debe eliminar los recursos correspondientes: AgentCore

Eliminación manual de un rol vinculado a servicios

Utilice la consola de IAM, la AWS CLI o la API de IAM para eliminar las funciones vinculadas al servicio. Para obtener más información, consulte Eliminar un rol vinculado a un servicio.