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.
Cómo AgentCore funciona Amazon Bedrock con IAM
Antes de utilizar IAM para gestionar el acceso AgentCore, infórmese sobre las funciones de IAM disponibles para su uso. AgentCore
| Característica de IAM | AgentCore soporte |
|---|---|
|
Sí |
|
|
Parcial |
|
|
Sí |
|
|
Sí |
|
|
Sí |
|
|
No |
|
|
Parcial |
|
|
Sí |
|
|
Sí |
|
|
Sí |
|
|
Sí |
Para obtener una visión general de cómo AgentCore funcionan otros AWS servicios con la mayoría de las funciones de IAM, consulte AWS los servicios que funcionan con IAM en la Guía del usuario de IAM.
Identity-based políticas para AgentCore
Compatibilidad con las políticas basadas en identidad: sí
Identity-based las políticas son documentos de política de permisos de JSON que puedes adjuntar a una identidad, como un usuario, un grupo de usuarios o un rol de IAM. Estas políticas controlan qué acciones pueden realizar los usuarios y los roles, en qué recursos y en qué condiciones. Para obtener más información sobre cómo crear una política basada en la identidad, consulte Definición de permisos de IAM personalizados con políticas administradas por el cliente en la Guía del usuario de IAM.
Con las políticas basadas en identidades de IAM, puede especificar las acciones y los recursos permitidos o denegados, así como las condiciones en las que se permiten o deniegan las acciones. Para obtener más información sobre los elementos que puede utilizar en una política de JSON, consulte Referencia de los elementos de la política de JSON de IAM en la Guía del usuario de IAM.
Identity-based ejemplos de políticas para AgentCore
Para ver ejemplos de políticas AgentCore basadas en la identidad, consulte los ejemplos de políticas Identity-based de Amazon Bedrock. AgentCore
Resource-based políticas dentro AgentCore
Compatibilidad con las políticas basadas en recursos: parcial
Resource-based las políticas son documentos de políticas JSON que se adjuntan a un recurso. Los ejemplos de políticas basadas en recursos son las políticas de confianza de roles de IAM y las políticas de bucket de Amazon S3. En los servicios que admiten políticas basadas en recursos, los administradores de servicios pueden utilizarlos para controlar el acceso a un recurso específico. Para el recurso al que se asocia la política, la política define qué acciones puede realizar una entidad principal especificada en ese recurso y en qué condiciones. Debe especificar una entidad principal en una política basada en recursos. Los principales pueden incluir cuentas, usuarios, roles, usuarios federados o AWS servicios.
Para habilitar el acceso entre cuentas, puede especificar toda una cuenta o entidades de IAM de otra cuenta como la entidad principal de una política en función de recursos. Para obtener más información, consulte Acceso a recursos entre cuentas en IAM en la Guía del usuario de IAM.
Amazon Bedrock AgentCore admite políticas basadas en recursos para los recursos de Agent Runtime y Gateway. Estas políticas se adjuntan directamente a sus recursos y definen qué directores pueden realizar acciones en relación con ellos.
Para obtener información sobre cómo crear y administrar políticas basadas en recursos para los AgentCore recursos de Amazon Bedrock, consulte las Resource-based políticas de Amazon Bedrock. AgentCore
Resource-based ejemplos de políticas en AgentCore
Para ver ejemplos de políticas AgentCore basadas en recursos, consulta Casos de uso y ejemplos comunes.
Acciones políticas para AgentCore
Compatibilidad con las acciones de políticas: sí
Los administradores pueden usar las políticas de AWS JSON para especificar quién tiene acceso a qué. Es decir, qué director puede realizar acciones sobre qué recursos y en qué condiciones.
El elemento Action de una política JSON describe las acciones que puede utilizar para conceder o denegar el acceso en una política. Incluya acciones en una política para conceder permisos y así llevar a cabo la operación asociada.
Para ver una lista de AgentCore acciones, consulte Acciones definidas por Amazon Bedrock AgentCore en la referencia de autorización del servicio.
Las acciones políticas en vigor AgentCore utilizan el siguiente prefijo antes de la acción:
bedrock-agentcore
Para especificar varias acciones en una única instrucción, sepárelas con comas.
"Action": [ "bedrock-agentcore:action1", "bedrock-agentcore:action2" ]
Para ver ejemplos de políticas AgentCore basadas en la identidad, consulte los ejemplos de políticas Identity-based de Amazon Bedrock. AgentCore
Recursos de políticas para AgentCore
Compatibilidad con los recursos de políticas: sí
Los administradores pueden usar las políticas de AWS JSON para especificar quién tiene acceso a qué. Es decir, qué director puede realizar acciones sobre qué recursos y en qué condiciones.
El elemento Resource de la política JSON especifica el objeto u objetos a los que se aplica la acción. Como práctica recomendada, especifique un recurso utilizando el Nombre de recurso de Amazon (ARN). En el caso de las acciones que no admiten permisos a nivel de recursos, utilice un comodín (*) para indicar que la sentencia se aplica a todos los recursos.
"Resource": "*"
Para ver una lista de los tipos de AgentCore recursos y sus ARN, consulte Recursos definidos por Amazon Bedrock AgentCore en la referencia de autorización del servicio. Para saber con qué acciones puede especificar el ARN de cada recurso, consulte Actions Defined by Amazon Bedrock. AgentCore
Para ver ejemplos de políticas AgentCore basadas en la identidad, consulte los ejemplos de políticas de Amazon Identity-based Bedrock. AgentCore
Claves de condiciones de política para AgentCore
Compatibilidad con claves de condición de políticas específicas del servicio: sí
Los administradores pueden usar las políticas de AWS JSON para especificar quién tiene acceso a qué. Es decir, qué director puede realizar acciones sobre qué recursos y en qué condiciones.
El elemento Condition especifica cuándo se ejecutan las instrucciones en función de criterios definidos. Puedes crear expresiones condicionales que usen operadores de condición, como igual o menor que, para hacer coincidir la condición de la política con los valores de la solicitud. Para ver todas las claves de condiciones AWS globales, consulte las claves de contexto de condiciones AWS globales en la Guía del usuario de IAM.
Para ver una lista de las claves de AgentCore estado, consulte las claves de estado de Amazon Bedrock AgentCore en la referencia de autorización de servicio. Para saber con qué acciones y recursos puede usar una clave de condición, consulte Actions Defined by Amazon Bedrock AgentCore.
Las siguientes claves de condición son especialmente útiles cuando se trabaja con Amazon Bedrock AgentCore:
-
bedrock-agentcore:InboundJwtClaim/iss- Puede usar esta clave de condición para restringir el acceso a las API que aceptan un JWT que represente a un usuario final para trabajar con valores de reclamación de emisores específicos presentes en el JWT incluido en la solicitud. Puedes aplicar esta clave de condición a las operaciones y.GetWorkloadAccessTokenForJwtCompleteResourceTokenAuth -
bedrock-agentcore:InboundJwtClaim/sub- Puedes usar esta clave de condición para restringir el acceso a las API que aceptan un JWT para que funcionen con valores de (sub) afirmación específicos presentes en el JWT incluido en la solicitud. Puedes aplicar esta clave de condición a las operacionesGetWorkloadAccessTokenForJwtyCompleteResourceTokenAuth. -
bedrock-agentcore:InboundJwtClaim/aud- Puedes usar esta clave de condición para restringir el acceso a las API que aceptan un JWT para que funcionen con valores de notificación de audiencia específicos (aud) presentes en el JWT incluido en la solicitud. Puedes aplicar esta clave de condición a las operacionesGetWorkloadAccessTokenForJwtyCompleteResourceTokenAuth. -
bedrock-agentcore:userid- Puedes usar esta clave de condición para restringir el acceso a las API que aceptan un ID de usuario estático para que solo funcionen con los valores de ID de usuario definidos en tu declaración de política. Puede aplicar esta clave de condición a lasCompleteResourceTokenAuthoperacionesGetWorkloadAccessTokenForUserIdy. -
bedrock-agentcore:InboundJwtClaim/scope- Puedes usar esta clave de condición para restringir el acceso en función del alcance del JWT incluido en la solicitud. -
bedrock-agentcore:InboundJwtClaim/client_id- Puedes usar esta clave de condición para restringir el acceso a las API que aceptan un JWT para que funcionen con valores declient_idnotificación específicos presentes en el JWT incluido en la solicitud. Esta clave solo está disponible cuando el JWT tiene laclient_idreclamación exacta y no está disponible cuando la información se comunica en otras reclamaciones similares. Puede aplicar esta clave de condición a lasCompleteResourceTokenAuthoperacionesGetWorkloadAccessTokenForJwty.
Para ver ejemplos de políticas AgentCore basadas en la identidad, consulte los ejemplos de políticas Identity-based de Amazon Bedrock. AgentCore
Para obtener información detallada sobre las claves de condición para AgentCore funciones específicas, consulte los siguientes temas:
-
Utilice las claves de condición de IAM con Amazon Bedrock AgentCore Gateway: claves de condición para las
CreateGatewayoperacionesUpdateGatewayCreateGatewayTarget, y de laUpdateGatewayTargetAPI. -
Utilice las claves de condición de IAM con la configuración de la AgentCore VPC: claves de VPC-related condición para el tiempo de AgentCore ejecución, herramientas integradas y objetivos de puerta de enlace.
Las ACL están en AgentCore
Compatibilidad con ACL: no
Las listas de control de acceso (ACL) controlan qué entidades principales (miembros de cuentas, usuarios o roles) tienen permisos para acceder a un recurso. Las ACL son similares a las políticas basadas en recursos, aunque no utilizan el formato de documento de políticas JSON.
ABAC con AgentCore
Compatibilidad con ABAC (etiquetas en las políticas): parcial
Attribute-based el control de acceso (ABAC) es una estrategia de autorización que define los permisos en función de atributos denominados etiquetas. Puede adjuntar etiquetas a las entidades y AWS los recursos de IAM y, a continuación, diseñar políticas de ABAC para permitir las operaciones cuando la etiqueta del principal coincida con la etiqueta del recurso.
Para controlar el acceso en función de las etiquetas, debes proporcionar la información de las etiquetas en el elemento de condición de una política mediante las claves aws:ResourceTag/key-nameaws:RequestTag/key-name, o de aws:TagKeys condición.
Si un servicio admite las tres claves de condición para cada tipo de recurso, el valor es Sí para el servicio. Si un servicio admite las tres claves de condición solo para algunos tipos de recursos, el valor es Parcial.
Para obtener más información sobre ABAC, consulte Definición de permisos con la autorización de ABAC en la Guía del usuario de IAM. Para ver un tutorial con los pasos para configurar ABAC, consulte Uso del control de acceso basado en atributos (ABAC) en la Guía del usuario de IAM.
Uso de credenciales temporales con AgentCore
Compatibilidad con credenciales temporales: sí
Las credenciales temporales proporcionan acceso a corto plazo a AWS los recursos y se crean automáticamente al usar la federación o al cambiar de rol. AWS recomienda generar credenciales temporales de forma dinámica en lugar de utilizar claves de acceso a largo plazo. Para obtener más información, consulte las credenciales de seguridad temporales en IAM y AWS los servicios que funcionan con IAM en la Guía del usuario de IAM.
Cross-service permisos principales para AgentCore
Admite sesiones de acceso directo (FAS): sí
Las sesiones de acceso directo (FAS) utilizan los permisos del principal que llama a un AWS servicio, combinados con los del AWS servicio solicitante, para realizar solicitudes a los servicios descendentes. Para obtener información sobre las políticas a la hora de realizar solicitudes de FAS, consulte Sesiones de acceso directo.
Funciones de servicio para AgentCore
Compatible con roles de servicio: sí
Un rol de servicio es un rol de IAM que asume un servicio para realizar acciones en su nombre. Un administrador de IAM puedes crear, modificar y eliminar un rol de servicio desde IAM. Para obtener más información, consulte Crear un rol para delegar permisos a un AWS servicio en la Guía del usuario de IAM.
aviso
Cambiar los permisos de un rol de servicio puede interrumpir la AgentCore funcionalidad. Edite los roles de servicio solo cuando AgentCore proporcione instrucciones para hacerlo.
Service-linked roles para AgentCore
Compatible con roles vinculados al servicio: sí
Un rol vinculado a un servicio es un tipo de rol de servicio que está vinculado a un AWS servicio. El servicio puede asumir la función de realizar una acción en su nombre. Service-linked las funciones aparecen en tu AWS cuenta y son propiedad del servicio. Un administrador de IAM puede ver, pero no editar, los permisos de los roles vinculados a servicios.
Para más información sobre cómo crear o administrar roles vinculados a servicios, consulta Servicios de AWS que funcionan con IAM. Busque un servicio en la tabla que incluya un servicio Yes en la columna de Service-linked funciones. Seleccione el vínculo Sí para ver la documentación acerca del rol vinculado a servicios para ese servicio.
