Funcionamiento del Generador de imágenes con las políticas y roles de IAM - EC2 Image Builder

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.

Funcionamiento del Generador de imágenes con las políticas y roles de IAM

Antes de utilizar IAM para administrar el acceso a Generador de Imágenes, conozca qué características de IAM se pueden utilizar con Generador de Imágenes.

Para obtener una visión general de cómo funcionan Image Builder y 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.

Políticas basadas en identidad para Generador de Imágenes

Compatibilidad con las políticas basadas en identidad:

Las políticas basadas en identidad son documentos de políticas de permisos JSON que puede asociar a una identidad, como un usuario de IAM, un grupo de usuarios o un rol. 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 identidad, consulte Creación de políticas de IAM 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. No es posible especificar la entidad principal en una política basada en identidad porque se aplica al usuario o rol al que está asociada. Para obtener más información sobre los elementos que puede utilizar en una política de JSON, consulte Referencia de los elementos de las políticas de JSON de IAM en la Guía del usuario de IAM.

Ejemplos de políticas basadas en identidad para Generador de Imágenes

Para ver ejemplos de políticas basadas en identidad de Generador de Imágenes, consulte Políticas basadas en identidades de Generador de Imágenes.

Políticas basadas en recursos dentro de Generador de Imágenes

Compatibilidad con las políticas basadas en recursos:

Las políticas basadas en recursos son documentos de política JSON que se asocian 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 puedes 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 puedes realizar una entidad principal especificada en ese recurso y en qué condiciones. Debe especificar una entidad principal en una política en función de recursos. Los principales pueden incluir cuentas, usuarios, roles, usuarios federados o. Servicios de AWS

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. Añadir a una política en función de recursos una entidad principal entre cuentas es solo una parte del establecimiento de una relación de confianza. Cuando el principal y el recurso son diferentes Cuentas de AWS, el administrador de IAM de la cuenta de confianza también debe conceder a la entidad principal (usuario o rol) permiso para acceder al recurso. Para conceder el permiso, adjunte la entidad a una política basada en identidad. Sin embargo, si la política basada en recursos concede acceso a una entidad principal de la misma cuenta, no es necesaria una política basada en identidad adicional. Para obtener más información, consulte Cross account resource access in IAM en la Guía del usuario de IAM.

Acciones de política para Generador de Imágenes

Compatibilidad con las acciones de políticas:

Los administradores pueden usar las políticas de AWS JSON para especificar quién tiene acceso a qué. Es decir, qué entidad principal puedes realizar acciones en qué recursos y en qué condiciones.

El elemento Action de una política JSON describe las acciones que puedes utilizar para conceder o denegar el acceso en una política. Las acciones políticas suelen tener el mismo nombre que la operación de AWS API asociada. Hay algunas excepciones, como acciones de solo permiso que no tienen una operación de API coincidente. También hay algunas operaciones que requieren varias acciones en una política. Estas acciones adicionales se denominan acciones dependientes.

Incluya acciones en una política para conceder permisos y así llevar a cabo la operación asociada.

Para ver una lista de las acciones de Image Builder, consulte Acciones definidas por EC2 Image Builder en la Referencia de autorización de servicios.

Las acciones de política de Generador de Imágenes utilizan el siguiente prefijo antes de la acción:

imagebuilder

Para especificar varias acciones en una única instrucción, sepárelas con comas.

"Action": [ "imagebuilder:action1", "imagebuilder:action2" ]

Para ver ejemplos de políticas basadas en identidad de Generador de Imágenes, consulte Políticas basadas en identidades de Generador de Imágenes.

Recursos de políticas para Generador de Imágenes

Compatibilidad con los recursos de políticas:

Los administradores pueden usar las políticas de AWS JSON para especificar quién tiene acceso a qué. Es decir, qué entidad principal puedes realizar acciones en 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. Las instrucciones deben contener un elemento Resource o NotResource. Como práctica recomendada, especifique un recurso utilizando el Nombre de recurso de Amazon (ARN). Puedes hacerlo para acciones que admitan un tipo de recurso específico, conocido como permisos de nivel de recurso.

Para las acciones que no admiten permisos de nivel de recurso, como las operaciones de descripción, utiliza un carácter comodín (*) para indicar que la instrucción se aplica a todos los recursos.

"Resource": "*"

Para ver una lista de los tipos de recursos de Image Builder y sus tipos ARNs, consulte Recursos definidos por EC2 Image Builder en la Referencia de autorización de servicio. Para saber con qué acciones puede especificar el ARN de cada recurso, consulte Acciones definidas por EC2 Image Builder.

Para ver ejemplos de políticas basadas en identidad de Generador de Imágenes, consulte Políticas basadas en identidades de Generador de Imágenes.

Claves de condición de política para Generador de Imágenes

Compatibilidad con claves de condición de políticas específicas del servicio:

Los administradores pueden usar las políticas de AWS JSON para especificar quién tiene acceso a qué. Es decir, qué entidad principal puedes realizar acciones en qué recursos y en qué condiciones.

El elemento Condition (o bloque de Condition) permite especificar condiciones en las que entra en vigor una instrucción. El elemento Condition es opcional. Puedes crear expresiones condicionales que utilizan operadores de condición, tales como igual o menor que, para que la condición de la política coincida con los valores de la solicitud.

Si especifica varios elementos de Condition en una instrucción o varias claves en un único elemento de Condition, AWS las evalúa mediante una operación AND lógica. Si especifica varios valores para una única clave de condición, AWS evalúa la condición mediante una OR operación lógica. Se deben cumplir todas las condiciones antes de que se concedan los permisos de la instrucción.

También puedes utilizar variables de marcador de posición al especificar condiciones. Por ejemplo, puedes conceder un permiso de usuario de IAM para acceder a un recurso solo si está etiquetado con su nombre de usuario de IAM. Para más información, consulta Elementos de la política de IAM: variables y etiquetas en la Guía del usuario de IAM.

AWS admite claves de condición globales y claves de condición específicas del servicio. Para ver todas las claves de condición AWS globales, consulte las claves de contexto de condición AWS globales en la Guía del usuario de IAM.

Para ver una lista de claves de condición de Image Builder, consulte Claves de condición de EC2 Image Builder en la Referencia de autorización de servicio. Para saber con qué acciones y recursos puede utilizar una clave de condición, consulte Acciones definidas por EC2 Image Builder.

Para ver ejemplos de políticas basadas en identidad de Generador de Imágenes, consulte Políticas basadas en identidades de Generador de Imágenes.

ACLs en Image Builder

Soportes ACLs: No

Las listas de control de acceso (ACLs) controlan qué directores (miembros de la cuenta, usuarios o roles) tienen permisos para acceder a un recurso. ACLs son similares a las políticas basadas en recursos, aunque no utilizan el formato de documento de políticas JSON.

ABAC con Generador de Imágenes

Compatibilidad con ABAC (etiquetas en las políticas): parcial

El control de acceso basado en atributos (ABAC) es una estrategia de autorización que define permisos en función de atributos. En AWS, estos atributos se denominan etiquetas. Puede adjuntar etiquetas a las entidades de IAM (usuarios o roles) y a muchos AWS recursos. El etiquetado de entidades y recursos es el primer paso de ABAC. A continuación, designa las políticas de ABAC para permitir operaciones cuando la etiqueta de la entidad principal coincida con la etiqueta del recurso al que se intenta acceder.

ABAC es útil en entornos que crecen con rapidez y ayuda en situaciones en las que la administración de las políticas resulta engorrosa.

Para controlar el acceso en función de etiquetas, debe proporcionar información de las etiquetas en el elemento de condición de una política utilizando las claves de condición aws:ResourceTag/key-name, aws:RequestTag/key-name o aws:TagKeys.

Si un servicio admite las tres claves de condición para cada tipo de recurso, el valor es 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, consulta Uso del control de acceso basado en atributos (ABAC) en la Guía del usuario de IAM.

Uso de credenciales temporales con Generador de Imágenes

Compatibilidad con credenciales temporales:

Algunas Servicios de AWS no funcionan cuando inicias sesión con credenciales temporales. Para obtener información adicional, incluidas las que Servicios de AWS funcionan con credenciales temporales, consulta Cómo Servicios de AWS funcionan con IAM en la Guía del usuario de IAM.

Utiliza credenciales temporales si inicia sesión en ellas AWS Management Console mediante cualquier método excepto un nombre de usuario y una contraseña. Por ejemplo, cuando accedes AWS mediante el enlace de inicio de sesión único (SSO) de tu empresa, ese proceso crea automáticamente credenciales temporales. También crea credenciales temporales de forma automática cuando inicia sesión en la consola como usuario y luego cambia de rol. Para obtener más información sobre el cambio de roles, consulte Cambio de un usuario a un rol de IAM (consola) en la Guía del usuario de IAM.

Puedes crear credenciales temporales manualmente mediante la AWS CLI API o. AWS A continuación, puede utilizar esas credenciales temporales para acceder AWS. 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 Credenciales de seguridad temporales en IAM.

Permisos de entidades principales entre servicios para Generador de Imágenes

Admite sesiones de acceso directo (FAS):

Cuando utilizas un usuario o un rol de IAM para realizar acciones en AWSél, se te considera director. Cuando utiliza algunos servicios, es posible que realice una acción que desencadene otra acción en un servicio diferente. FAS utiliza los permisos del principal que llama y los que solicita Servicio de AWS para realizar solicitudes a los servicios descendentes. Servicio de AWS Las solicitudes de FAS solo se realizan cuando un servicio recibe una solicitud que requiere interacciones con otros Servicios de AWS recursos para completarse. En este caso, debe tener permisos para realizar ambas acciones. Para obtener información sobre las políticas a la hora de realizar solicitudes de FAS, consulta Reenviar sesiones de acceso.

Roles de servicio para Generador de Imágenes

Compatibilidad con roles de servicio:

Un rol de servicio es un rol de IAM que asume un servicio para realizar acciones en su nombre. Un administrador de IAM puede crear, modificar y eliminar un rol de servicio desde IAM. Para obtener más información, consulte Creación de un rol para delegar permisos a un Servicio de AWS en la Guía del usuario de IAM.

aviso

Cambiar los permisos de un rol de servicio podría interrumpir la funcionalidad de Generador de Imágenes. Edite los roles de servicio solo cuando Generador de Imágenes proporcione orientación para hacerlo.

Roles vinculados a servicios para Generador de Imágenes

Admite roles vinculados a servicios:

Un rol vinculado a un servicio es un tipo de rol de servicio que está vinculado a un. Servicio de AWS El servicio puedes asumir el rol para realizar una acción en su nombre. Los roles vinculados al servicio aparecen en usted Cuenta de AWS y son propiedad del servicio. Un administrador de IAM puedes ver, pero no editar, los permisos de los roles vinculados a servicios.

Para ver detalles sobre el rol vinculado a servicios de Generador de Imágenes, consulte Uso de roles vinculados a servicios de IAM para Generador de imágenes.

Políticas basadas en identidades de Generador de Imágenes

Con las políticas basadas en identidades de IAM, puede especificar las acciones permitidas o denegadas, así como los recursos y también las condiciones en las que se permiten o deniegan las acciones. Generador de Imágenes admite acciones, recursos y claves de condición específicos. Para obtener información sobre todos los elementos que se utilizan en una política de JSON, consulte Acciones, recursos y claves de condición de Amazon EC2 Image Builder en la Guía del usuario de IAM.

Acciones

Las acciones de política de Generador de Imágenes utilizan el siguiente prefijo antes de la acción: imagebuilder:. Las instrucciones de la política deben incluir un elemento Action o un elemento NotAction. Generador de Imágenes define su propio conjunto de acciones que describen las tareas que se pueden realizar con este servicio.

Para especificar varias acciones en una única instrucción, sepárelas con comas del siguiente modo:

"Action": [ "imagebuilder:action1", "imagebuilder:action2" ]

Puede utilizar caracteres comodín para especificar varias acciones (*). Por ejemplo, para especificar todas las acciones que comiencen con la palabra List, incluya la siguiente acción:

"Action": "imagebuilder:List*"

Para ver una lista de acciones de Generador de Imágenes, consulte Acciones, recursos y claves de condición de Servicios de AWS en la Guía del usuario de IAM.

Administración de acceso mediante políticas

Para obtener información detallada sobre cómo gestionar el acceso AWS mediante la creación de políticas y su vinculación a las identidades o los AWS recursos de IAM, consulte Políticas y permisos en la Guía del usuario de IAM.

El rol de IAM que asocie a su perfil de instancia debe tener permisos para ejecutar los componentes de compilación y prueba incluidos en su imagen. Las siguientes políticas del rol de IAM se deben asociar al rol de IAM que está asociado al perfil de instancia:

  • EC2InstanceProfileForImageBuilder

  • EC2InstanceProfileForImageBuilderECRContainerBuilds

  • AmazonSSMManagedInstanceCore

Recursos

Los administradores pueden usar las políticas de AWS JSON para especificar quién tiene acceso a qué. Es decir, qué entidad principal puedes realizar acciones en 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. Las instrucciones deben contener un elemento Resource o NotResource. Como práctica recomendada, especifique un recurso utilizando el Nombre de recurso de Amazon (ARN). Puedes hacerlo para acciones que admitan un tipo de recurso específico, conocido como permisos de nivel de recurso.

Para las acciones que no admiten permisos de nivel de recurso, como las operaciones de descripción, utiliza un carácter comodín (*) para indicar que la instrucción se aplica a todos los recursos.

"Resource": "*"

El ARN se compone de varios nodos que ayudan a identificar el recurso y garantizar que el nombre sea único. Los últimos nodos del nombre incluyen varias variaciones de formato para el tipo, el nombre y el identificador del recurso. Cuando Image Builder crea un recurso, utiliza el siguiente formato:

arn:aws:imagebuilder:region:owner:resource-type/resource-name/version/build-version

nota

La versión de compilación no siempre se incluye en el ARN del recurso. Sin embargo, algunas operaciones de la API, por ejemplo GetComponent, necesitan la versión de compilación para identificar de forma exclusiva un recurso que se va a recuperar.

Para los recursos que Image Builder utiliza en sus recetas, como la imagen base o los componentes, el nodo propietario puede ser uno de los siguientes:

  • El número de cuenta del propietario del recurso

  • Para los recursos gestionados por Amazon: aws

  • Para AWS Marketplace recursos: aws-marketplace

El siguiente ejemplo muestra el ARN de un componente gestionado para instalar el CloudWatch agente de Amazon en Linux:

arn:aws:imagebuilder:us-east-1:aws:component:amazon-cloudwatch-agent-linux/1.0.1/1

En este ejemplo se muestra el ARN de un componente gestionado ficticio de: AWS Marketplace

arn:aws:imagebuilder:us-east-1:aws-marketplace:component:example-linux-software-component/1.0.1

Para obtener más información sobre cómo obtener una lista de componentes, incluido el uso de un filtro de propiedad, consulte. Enumeración de componentes de Generador de imágenes

Ejemplo ARNs

A continuación se muestran algunos ejemplos de recursos ARNs que puede especificar en una política de IAM:

  • ARN de instancia

    "Resource": "arn:aws:imagebuilder:us-east-1:111122223333:instance/i-1234567890abcdef0"
  • Ejemplo de comodín (*) para especificar todas las instancias de una cuenta determinada

    "Resource": "arn:aws:imagebuilder:us-east-1:111122223333:instance/*"
  • Ejemplo de comodín (*) para especificar todas las versiones de un flujo de trabajo de imágenes gestionadas

    "Resource": "arn:aws:imagebuilder:us-east-1:aws:workflow/build/build-image/*"
  • ARN de imagen gestionada

    "Resource": "arn:aws:imagebuilder:us-east-1:aws:image/amazon-linux-2-arm64/2024.12.17/1"
  • Ejemplo de comodín (*) para especificar todas las versiones de una imagen gestionada

    "Resource": "arn:aws:imagebuilder:us-east-1:aws:image/amazon-linux-2-arm64/x.x.x"

Muchas acciones de la API EC2 Image Builder implican varios recursos. Para especificar varios recursos en una sola sentencia, sepárelos ARNs con comas.

"Resource": [ "resource1", "resource2" ]

Claves de condición

Generador de Imágenes proporciona claves de condición específicas del servicio, y admite el uso de algunas claves de condición globales. Para ver todas las claves de condición AWS globales, consulte las claves de contexto de condición AWS globales en la Guía del usuario de IAM. Se proporcionan las siguientes claves de condición específicas del servicio.

generador de imágenes: CreatedResourceTagKeys

Funciona con operadores de cadena.

Utilice esta clave para filtrar el acceso en función de la presencia de claves de etiqueta en la solicitud. Esto le permite administrar los recursos que crea Generador de Imágenes.

Disponibilidad: esta clave solo está disponible para y. CreateInfrastrucutreConfiguration UpdateInfrastructureConfiguration APIs

generador de imágenes:/CreatedResourceTag<key>

Funciona con operadores de cadena.

Utilice esta clave para filtrar el acceso en función de los pares clave-valor de etiqueta adjuntados al recurso creado por Generador de Imágenes. Esto le permite administrar los recursos de Generador de Imágenes mediante etiquetas definidas.

Disponibilidad: esta clave solo está disponible para y. CreateInfrastrucutreConfiguration UpdateInfrastructureConfiguration APIs

Creador de imágenes: EC2 MetadataHttpTokens

Funciona con operadores de cadena.

Utilice esta clave para filtrar el acceso según el requisito del token HTTP de los metadatos de la EC2 instancia especificado en la solicitud.

El valor de esta clave puede ser optional o required.

Disponibilidad: esta clave solo está disponible para CreateInfrastrucutreConfiguration y UpdateInfrastructureConfiguration APIs.

generador de imágenes: StatusTopicArn

Funciona con operadores de cadena.

Utilice esta clave para filtrar el acceso por el ARN de tema SNS en la solicitud en la que se publicarán las notificaciones de estado del terminal.

Disponibilidad: esta clave solo está disponible para y. CreateInfrastrucutreConfiguration UpdateInfrastructureConfiguration APIs

Ejemplos

Para ver ejemplos de políticas basadas en identidad de Generador de Imágenes, consulte Políticas basadas en identidades de Generador de Imágenes.

Políticas basadas en recursos de Generador de Imágenes

Las políticas basadas en recursos especifican qué acciones puede realizar una entidad principal especificada en el recurso de Generador de imágenes y en qué condiciones. Generador de Imágenes admite políticas de permisos basadas en recursos para los componentes, imágenes y recetas de imágenes. Las políticas basadas en recursos le permiten otorgar permiso de uso a otras cuentas por recurso. También puede utilizar una política basada en recursos para permitir que un AWS servicio acceda a sus componentes, imágenes y recetas de imágenes.

Para obtener información sobre cómo asociar una política basada en recursos a un componente, imagen o receta de imágenes, consulte Comparta los recursos de Image Builder con AWS RAM.

nota

Al actualizar una política de recursos usando Generador de Imágenes, la actualización aparecerá en la consola de RAM.

Autorización basada en etiquetas de Generador de Imágenes

Puede adjuntar etiquetas a los recursos de Generador de Imágenes o transferirlas en una solicitud a Generador de Imágenes. Para controlar el acceso en función de etiquetas, debe proporcionar información de las etiquetas en el elemento de condición de una política utilizando las claves de condición imagebuilder:ResourceTag/key-name, aws:RequestTag/key-name o aws:TagKeys. Para obtener más información acerca del etiquetado de recursos de Generador de Imágenes, consulte Etiquete un recurso del AWS CLI.

Roles de IAM de Generador de Imágenes

Un rol de IAM es una entidad dentro de usted Cuenta de AWS que tiene permisos específicos.

Uso de credenciales temporales con Generador de Imágenes

Puede utilizar credenciales temporales para iniciar sesión con federación, asumir un rol de IAM o asumir un rol de acceso entre cuentas. Para obtener credenciales de seguridad temporales, puede llamar a operaciones de AWS STS API como AssumeRoleo GetFederationToken.

Roles vinculados a servicios

Los roles vinculados a un servicio permiten acceder Servicios de AWS a los recursos de otros servicios para completar una acción en tu nombre. Los roles vinculados a servicios aparecen en la cuenta de IAM y son propiedad del servicio. Un usuario con acceso administrativo puede ver, pero no editar, los permisos de los roles vinculados a servicios.

Generador de Imágenes admite roles vinculados a servicios. Para obtener información sobre cómo crear o administrar roles vinculados a servicios de Generador de Imágenes, consulte Uso de roles vinculados a servicios de IAM para Generador de imágenes.

Roles de servicio

Esta característica permite que un servicio asuma un rol de servicio en su nombre. Este rol permite que el servicio obtenga acceso a los recursos de otros servicios para completar una acción en su nombre. Los roles de servicio aparecen en su cuenta de IAM y son propiedad de la cuenta. Esto significa que un usuario con acceso administrativo puede cambiar los permisos de este rol. Sin embargo, hacerlo podría deteriorar la funcionalidad del servicio.