Cómo funciona Amazon Elastic Container Registry con IAM - Amazon ECR

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 funciona Amazon Elastic Container Registry con IAM

Antes de gestionar el acceso a AmazonECR, debes saber qué IAM funciones están disponibles para su uso con AmazonECR. IAM Para obtener una visión general de cómo funcionan Amazon ECR y otros AWS serviciosIAM, consulta AWS Servicios con los que funcionan IAM en la Guía del IAM usuario.

Políticas basadas en Amazon ECR Identity

Con las políticas IAM basadas en la identidad, puede especificar las acciones y los recursos permitidos o denegados, así como las condiciones en las que se permiten o deniegan las acciones. Amazon ECR admite acciones, recursos y claves de condición específicos. Para obtener más información sobre todos los elementos que utilizas en una JSON política, consulta la Referencia sobre los elementos de la IAM JSON política en la Guía del IAM usuario.

Acciones

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

El Action elemento de una JSON política describe las acciones que puede utilizar para permitir o denegar el acceso en una política. Las acciones de política suelen tener el mismo nombre que la AWS API operación asociada. Hay algunas excepciones, como las acciones que solo permiten permisos y que no tienen una operación coincidente. API 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.

Las acciones políticas en Amazon ECR utilizan el siguiente prefijo antes de la acción:ecr:. Por ejemplo, para conceder permiso a alguien para crear un ECR repositorio de Amazon con la ECR CreateRepository API operación Amazon, debes incluir la ecr:CreateRepository acción en su política. Las instrucciones de la política deben incluir un elemento Action o un elemento NotAction. Amazon ECR define su propio conjunto de acciones que describen las tareas que puedes realizar con este servicio.

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

"Action": [ "ecr:action1", "ecr:action2"

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

"Action": "ecr:Describe*"

Para ver una lista de ECR las acciones de Amazon, consulte Acciones, recursos y claves de condición de Amazon Elastic Container Registry en la Guía del IAM usuario.

Recursos

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

El elemento Resource JSON de política especifica el objeto o los 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 mediante su nombre de recurso de Amazon (ARN). Puede 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, utilice un carácter comodín (*) para indicar que la instrucción se aplica a todos los recursos.

"Resource": "*"

Un recurso de ECR repositorio de Amazon tiene lo siguienteARN:

arn:${Partition}:ecr:${Region}:${Account}:repository/${Repository-name}

Para obtener más información sobre el formato deARNs, consulte Amazon Resource Names (ARNs) y AWS Service Namespaces.

Por ejemplo, para especificar el my-repo repositorio de la us-east-1 región en su declaración, utilice lo siguiente: ARN

"Resource": "arn:aws:ecr:us-east-1:123456789012:repository/my-repo"

Para especificar todos los repositorios que pertenecen a una cuenta específica, utilice el carácter comodín (*):

"Resource": "arn:aws:ecr:us-east-1:123456789012:repository/*"

Para especificar varios recursos en una sola sentencia, sepárelos ARNs con comas.

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

Para ver una lista de los tipos de ECR recursos de Amazon y sus tiposARNs, consulte Recursos definidos por Amazon Elastic Container Registry en la Guía del IAM usuario. Para saber con qué acciones puede especificar cada recurso, consulte Acciones definidas por Amazon Elastic Container Registry. ARN

Claves de condición

Los administradores pueden usar AWS JSON políticas para especificar quién tiene acceso a qué. Es decir, qué entidad principal puede 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. Puede crear expresiones condicionales que utilicen 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 puede utilizar variables de marcador de posición al especificar condiciones. Por ejemplo, puede conceder a un IAM usuario permiso para acceder a un recurso solo si está etiquetado con su nombre de IAM usuario. Para obtener más información, consulte los elementos de IAM política: variables y etiquetas en la Guía del IAM usuario.

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 IAMusuario.

Amazon ECR define su propio conjunto de claves de condición y también admite el uso de algunas claves de condición globales. Para ver todas las claves de condición AWS globales, consulta las claves de contexto de condición AWS globales en la Guía del IAM usuario.

La mayoría de ECR las acciones de Amazon admiten las claves de ecr:ResourceTag condición aws:ResourceTag y. Para obtener más información, consulte Uso del control de acceso basado en etiquetas.

Para ver una lista de las claves de ECR condición de Amazon, consulte Claves de condición definidas por Amazon Elastic Container Registry en la Guía del IAM usuario. Para obtener más información acerca de las acciones y los recursos con los que puede utilizar una clave de condición, consulte Acciones definidas por Amazon Elastic Container Registry.

Ejemplos

Para ver ejemplos de políticas de Amazon ECR basadas en la identidad, consulta. Ejemplos de políticas basadas en identidad de Amazon Elastic Container Registry

Políticas de Amazon ECR basadas en recursos

Las políticas basadas en recursos son documentos JSON de políticas que especifican qué acciones puede realizar un director específico en un ECR recurso de Amazon y en qué condiciones. Amazon ECR admite políticas de permisos basadas en recursos para los repositorios de AmazonECR. Las políticas basadas en recursos le permiten otorgar permiso de uso a otras cuentas por recurso. También puedes usar una política basada en recursos para permitir que un AWS servicio acceda a tus repositorios de AmazonECR.

Para habilitar el acceso entre cuentas, puedes especificar una cuenta completa o IAM entidades de otra cuenta como principales en una política basada en 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 están en AWS cuentas diferentes, también debes conceder permiso a la entidad principal para acceder al recurso. Conceda permiso asociando a la entidad una política basada en identidades. Sin embargo, si la política basada en recursos concede el 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 en qué se diferencian IAM los roles de las políticas basadas en recursos en la Guía del IAMusuario.

El ECR servicio de Amazon solo admite un tipo de política basada en recursos denominada política de repositorio, que se adjunta a un repositorio. Esta política indica las entidades principales (cuentas, usuarios, roles y usuarios federados) que pueden realizar acciones en el repositorio. Para obtener información sobre cómo asociar una política basada en recursos a un repositorio, consulte Políticas de repositorios privados en Amazon ECR.

nota

En una política de ECR repositorios de Amazon, el elemento de política Sid admite caracteres adicionales y espacios no admitidos en IAM las políticas.

Ejemplos

Para ver ejemplos de políticas ECR basadas en recursos de Amazon, consulta: Ejemplos de políticas de repositorios privados en Amazon ECR

Autorización basada en ECR etiquetas de Amazon

Puedes adjuntar etiquetas a ECR los recursos de Amazon o pasarlas en una solicitud a AmazonECR. 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 ecr:ResourceTag/key-name, aws:RequestTag/key-name o aws:TagKeys. Para obtener más información sobre el etiquetado de ECR los recursos de Amazon, consulteEtiquetar un repositorio privado en Amazon ECR.

Para consultar un ejemplo de política basada en la identidad para limitar el acceso a un recurso en función de las etiquetas de ese recurso, consulte Uso del control de acceso basado en etiquetas.

ECRIAMFunciones en Amazon

Un IAMrol es una entidad de tu AWS cuenta que tiene permisos específicos.

Uso de credenciales temporales con Amazon ECR

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

Amazon ECR admite el uso de credenciales temporales.

Roles vinculados al servicio

Los roles vinculados a un servicio permiten a AWS los servicios acceder a los recursos de otros servicios para completar una acción en tu nombre. Los roles vinculados al servicio aparecen en tu IAM cuenta y son propiedad del servicio. Un IAM administrador puede ver los permisos de los roles vinculados al servicio, pero no editarlos.

Amazon ECR admite funciones vinculadas a servicios. Para obtener más información, consulte Uso de roles vinculados a servicios para Amazon ECR.