As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Como o Amazon Elastic Container Registry funciona com IAM

Antes de usar IAM para gerenciar o acesso à AmazonECR, você deve entender quais IAM recursos estão disponíveis para uso com a AmazonECR. Para obter uma visão de alto nível de como a Amazon ECR e outros AWS serviços funcionam comIAM, consulte AWS Serviços que funcionam com IAM no Guia do IAM usuário.

Políticas baseadas na Amazon ECR Identity

Com as políticas baseadas em identidade do IAM, é possível especificar ações ou recursos permitidos ou negados, bem como as condições sob as quais as ações são permitidas ou negadas. A Amazon ECR oferece suporte a ações, recursos e chaves de condição específicos. Para saber mais sobre todos os elementos que você usa em uma JSON política, consulte Referência IAM JSON de elementos de política no Guia do IAM usuário.

Ações

Os administradores podem usar AWS JSON políticas para especificar quem tem acesso ao quê. Ou seja, qual entidade principal pode executar ações em quais recursos e em que condições.

O Action elemento de uma JSON política descreve as ações que você pode usar para permitir ou negar acesso em uma política. As ações de política geralmente têm o mesmo nome da AWS API operação associada. Há algumas exceções, como ações somente com permissão que não têm uma operação correspondente. API Algumas operações também exigem várias ações em uma política. Essas ações adicionais são chamadas de ações dependentes.

Incluem ações em uma política para conceder permissões para executar a operação associada.

As ações políticas na Amazon ECR usam o seguinte prefixo antes da ação:ecr:. Por exemplo, para conceder permissão a alguém para criar um ECR repositório da Amazon com a ECR CreateRepository API operação da Amazon, você inclui a ecr:CreateRepository ação na política dessa pessoa. As instruções de política devem incluir um elemento Action ou NotAction. A Amazon ECR define seu próprio conjunto de ações que descrevem tarefas que você pode realizar com esse serviço.

Para especificar várias ações em uma única instrução, separe-as com vírgulas, como segue:

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

Você também pode especificar várias ações usando caracteres curinga (*). Por exemplo, para especificar todas as ações que começam com a palavra Describe, inclua a seguinte ação:

"Action": "ecr:Describe*"

Para ver uma lista de ECR ações da Amazon, consulte Ações, recursos e chaves de condição para o Amazon Elastic Container Registry no Guia IAM do usuário.

Recursos

Os administradores podem usar AWS JSON políticas para especificar quem tem acesso ao quê. Ou seja, qual entidade principal pode executar ações em quais recursos e em que condições.

O elemento Resource JSON de política especifica o objeto ou objetos aos quais a ação se aplica. As instruções devem incluir um elemento Resource ou NotResource. Como prática recomendada, especifique um recurso usando seu Amazon Resource Name (ARN). Isso pode ser feito para ações que oferecem compatibilidade com um tipo de recurso específico, conhecido como permissões em nível de recurso.

Para ações que não oferecem compatibilidade com permissões em nível de recurso, como operações de listagem, use um curinga (*) para indicar que a instrução se aplica a todos os recursos.

"Resource": "*"

Um recurso de ECR repositório da Amazon tem o seguinte: ARN

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

Para obter mais informações sobre o formato deARNs, consulte Amazon Resource Names (ARNs) e AWS Service Namespaces.

Por exemplo, para especificar o my-repo repositório na us-east-1 Região em sua declaração, use o seguinte: ARN

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

Para especificar todos os repositórios que pertencem a uma conta específica, use o caractere curinga (*):

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

Para especificar vários recursos em uma única instrução, separe-os ARNs com vírgulas.

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

Para ver uma lista dos tipos de ECR recursos da Amazon e seusARNs, consulte Recursos definidos pelo Amazon Elastic Container Registry no Guia IAM do usuário. Para saber com quais ações você pode especificar cada recurso, consulte Ações definidas pelo Amazon Elastic Container Registry. ARN

Chaves de condição

Os administradores podem usar AWS JSON políticas para especificar quem tem acesso ao quê. Ou seja, qual entidade principal pode executar ações em quais recursos e em que condições.

O elemento Condition (ou bloco de Condition) permite que você especifique condições nas quais uma declaração está em vigor. O elemento Condition é opcional. É possível criar expressões de condição que usam operadores de condição, como igual a ou menor que, para corresponder a condição na política aos valores na solicitação.

Se você especificar vários elementos de Condition em uma declaração ou várias chaves em um único elemento de Condition, a AWS os avaliará usando uma operação lógica AND. Se você especificar vários valores para uma única chave de condição, AWS avalia a condição usando uma OR operação lógica. Todas as condições devem ser atendidas antes que as permissões da instrução sejam concedidas.

Você também pode usar variáveis de espaço reservado ao especificar condições. Por exemplo, você pode conceder a um usuário do IAM permissão para acessar um recurso somente se ele estiver marcado com seu nome de usuário do IAM. Para obter mais informações, consulte Elementos de política do IAM: variáveis e tags no Guia do usuário do IAM.

AWS suporta chaves de condição globais e chaves de condição específicas do serviço. Para ver todas as chaves de condição AWS globais, consulte as chaves de contexto de condição AWS global no Guia IAM do usuário.

A Amazon ECR define seu próprio conjunto de chaves de condição e também oferece suporte ao uso de algumas chaves de condição globais. Para ver todas as chaves de condição AWS globais, consulte Chaves de contexto de condição AWS global no Guia IAM do usuário.

A maioria das ECR ações da Amazon suporta as chaves de ecr:ResourceTag condição aws:ResourceTag e de condição. Para obter mais informações, consulte Usar controle de acesso baseado em tags.

Para ver uma lista das chaves de ECR condição da Amazon, consulte Chaves de condição definidas pelo Amazon Elastic Container Registry no Guia IAM do usuário. Para saber com quais ações e recursos você pode usar a chave de condição, consulte Ações definidas pelo Amazon Elastic Container Registry.

Exemplos

Para ver exemplos de políticas ECR baseadas em identidade da Amazon, consulte. Exemplos de políticas baseadas em identidade do Amazon Elastic Container Registry

Políticas baseadas em ECR recursos da Amazon

Políticas baseadas em recursos são documentos JSON de política que especificam quais ações um determinado diretor pode realizar em um ECR recurso da Amazon e sob quais condições. A Amazon ECR oferece suporte a políticas de permissões baseadas em recursos para repositórios da AmazonECR. As políticas baseadas em recursos permitem conceder permissão de uso a outras contas especificada por recurso. Você também pode usar uma política baseada em recursos para permitir que um AWS serviço acesse seus repositórios da AmazonECR.

Para permitir o acesso entre contas, você pode especificar uma conta inteira ou as entidades do IAM em outra conta como o principal em uma política baseada em recurso. Adicionar uma entidade principal entre contas à política baseada em recurso é apenas metade da tarefa de estabelecimento da relação de confiança. Quando o principal e o recurso estão em AWS contas diferentes, você também deve conceder permissão à entidade principal para acessar o recurso. Conceda permissão anexando uma política baseada em identidade para a entidade. No entanto, se uma política baseada em recurso conceder acesso a uma entidade principal na mesma conta, nenhuma política baseada em identidade adicional será necessária. Para obter mais informações, consulte Como as IAM funções diferem das políticas baseadas em recursos no Guia do IAMusuário.

O ECR serviço da Amazon oferece suporte a apenas um tipo de política baseada em recursos chamada política de repositório, que é anexada a um repositório. Essa política define quais entidades principais (contas, usuários, funções e usuários federados) podem realizar ações no repositório. Para saber como anexar uma política baseada em recurso a um repositório, consulte Políticas de repositório privado no Amazon ECR.

Exemplos

Para ver exemplos de políticas ECR baseadas em recursos da Amazon, consulte Exemplos de políticas de repositório privado no Amazon ECR

Autorização baseada em ECR tags da Amazon

Você pode anexar tags aos ECR recursos da Amazon ou passar tags em uma solicitação para a AmazonECR. Para controlar o acesso baseado em tags, forneça informações sobre as tags no elemento de condição de uma política usando as ecr:ResourceTag/key-name, aws:RequestTag/key-name ou chaves de condição aws:TagKeys. Para obter mais informações sobre a marcação de ECR recursos da Amazon, consulteMarcar um repositório privado no Amazon ECR.

Para visualizar um exemplo de política baseada em identidade para limitar o acesso a um recurso baseado em tags desse recurso, consulte Usar controle de acesso baseado em tags.

ECRIAMFunções na Amazon

Uma IAMfunção é uma entidade dentro da sua AWS conta que tem permissões específicas.

Usando credenciais temporárias com a Amazon ECR

Você pode usar credenciais temporárias para fazer login com federação, assumir uma função do IAM ou assumir uma função entre contas. Você obtém credenciais de segurança temporárias ligando para AWS STS API operações como AssumeRoleou GetFederationToken.

A Amazon ECR oferece suporte ao uso de credenciais temporárias.

Perfis vinculados ao serviço

As funções vinculadas ao serviço permitem que AWS os serviços acessem recursos em outros serviços para concluir uma ação em seu nome. Os Perfis vinculados a serviços aparecem em sua conta da IAM e são de propriedade do serviço. Um administrador do IAM pode visualizar, mas não pode editar as permissões para funções vinculadas ao serviço.

A Amazon ECR oferece suporte a funções vinculadas a serviços. Para obter mais informações, consulte Usando funções vinculadas a serviços para a Amazon ECR.