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 Image Builder utiliza políticas e perfis do IAM
Antes de usar o IAM para gerenciar o acesso ao Image Builder, saiba quais atributos do IAM estão disponíveis para uso com o Image Builder.
Para ter uma visão de alto nível de como o Image Builder e outros AWS serviços funcionam com a maioria dos recursos do IAM, consulte AWS os serviços que funcionam com o IAM no Guia do usuário do IAM.
Políticas baseadas em identidade para o Image Builder
Compatível com políticas baseadas em identidade: sim
As políticas baseadas em identidade são documentos de políticas de permissões JSON que você pode anexar a uma identidade, como usuário do IAM, grupo de usuários ou perfil. Essas políticas controlam quais ações os usuários e perfis podem realizar, em quais recursos e em que condições. Para saber como criar uma política baseada em identidade, consulte Definir permissões personalizadas do IAM com as políticas gerenciadas pelo cliente no Guia do Usuário do IAM.
Com as políticas baseadas em identidade do IAM, é possível especificar ações e recursos permitidos ou negados, assim como as condições sob as quais as ações são permitidas ou negadas. Você não pode especificar a entidade principal em uma política baseada em identidade porque ela se aplica ao usuário ou perfil ao qual ela está anexada. Para saber mais sobre todos os elementos que podem ser usados em uma política JSON, consulte Referência de elemento de política JSON do IAM no Guia do usuário do IAM.
Exemplos de políticas baseadas em identidade para o Image Builder
Para visualizar exemplos de políticas baseadas em identidade do Image Builder, consulte Políticas baseadas em identidade do Image Builder.
Políticas baseadas em recursos no Image Builder
Compatível com políticas baseadas em recursos: sim
Políticas baseadas em recursos são documentos de políticas JSON que você anexa a um recurso. São exemplos de políticas baseadas em recursos as políticas de confiança de perfil do IAM e as políticas de bucket do Amazon S3. Em serviços compatíveis com políticas baseadas em recursos, os administradores de serviço podem usá-las para controlar o acesso a um recurso específico. Para o atributo ao qual a política está anexada, a política define quais ações uma entidade principal especificado pode executar nesse atributo e em que condições. Você deve especificar uma entidade principal em uma política baseada em recursos. Os diretores podem incluir contas, usuários, funções, usuários federados ou. Serviços da AWS
Para permitir o acesso entre contas, você pode especificar uma conta inteira ou as entidades do IAM em outra conta como a entidade principal em uma política baseada em recursos. 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 são diferentes Contas da AWS, um administrador do IAM na conta confiável também deve conceder permissão à entidade principal (usuário ou função) para acessar o recurso. Eles concedem permissão ao anexar 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. Consulte mais informações em Acesso a recursos entre contas no IAM no Guia do usuário do IAM.
Ações de política para Image Builder
Compatível com ações de políticas: sim
Os administradores podem usar políticas AWS JSON 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 Action
de uma política JSON descreve as ações que podem ser usadas para permitir ou negar acesso em uma política. As ações de política geralmente têm o mesmo nome da operação de AWS API associada. Existem algumas exceções, como ações somente de permissão, que não têm uma operação de API correspondente. 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.
Para ver uma lista de ações do Image Builder, consulte Ações definidas pelo EC2 Image Builder na Referência de Autorização de Serviço.
As ações de políticas no Image Builder usam o seguinte prefixo antes da ação:
imagebuilder
Para especificar várias ações em uma única declaração, separe-as com vírgulas.
"Action": [ "imagebuilder:
action1
", "imagebuilder:action2
" ]
Para visualizar exemplos de políticas baseadas em identidade do Image Builder, consulte Políticas baseadas em identidade do Image Builder.
Recursos de política para Image Builder
Compatível com recursos de políticas: sim
Os administradores podem usar políticas AWS JSON 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 de política JSON Resource
especifica o objeto ou os 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 nome do recurso da Amazon (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": "*"
Para ver uma lista dos tipos de recursos do Image Builder e seus ARNs, consulte Recursos definidos pelo EC2 Image Builder na Referência de Autorização de Serviço. Para saber com quais ações você pode especificar o ARN de cada recurso, consulte Ações definidas pelo EC2 Image Builder.
Para visualizar exemplos de políticas baseadas em identidade do Image Builder, consulte Políticas baseadas em identidade do Image Builder.
Chaves de condição de políticas do Image Builder
Compatível com chaves de condição de política específicas de serviço: sim
Os administradores podem usar políticas AWS JSON 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 Condition
) permite que você especifique condições nas quais uma instrução estiver em vigor. O elemento Condition
é opcional. É possível criar expressões condicionais que usem agentes de condição, como “igual a” ou “menor que”, para fazer a condição da política corresponder 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, é possível 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 da 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 do usuário do IAM.
Para ver uma lista das chaves de condição do Image Builder, consulte Chaves de condição do EC2 Image Builder na Referência de Autorização de Serviço. Para saber com quais ações e recursos você pode usar uma chave de condição, consulte Ações definidas pelo EC2 Image Builder.
Para visualizar exemplos de políticas baseadas em identidade do Image Builder, consulte Políticas baseadas em identidade do Image Builder.
ACLs em Image Builder
Suportes ACLs: Não
As listas de controle de acesso (ACLs) controlam quais diretores (membros da conta, usuários ou funções) têm permissões para acessar um recurso. ACLs são semelhantes às políticas baseadas em recursos, embora não usem o formato de documento de política JSON.
ABAC com Image Builder
Compatível com ABAC (tags em políticas): parcial
O controle de acesso por atributo (ABAC) é uma estratégia de autorização que define as permissões com base em atributos. Em AWS, esses atributos são chamados de tags. Você pode anexar tags a entidades do IAM (usuários ou funções) e a vários AWS recursos. Marcar de entidades e atributos é a primeira etapa do ABAC. Em seguida, você cria políticas de ABAC para permitir operações quando a tag da entidade principal corresponder à tag do recurso que ela estiver tentando acessar.
O ABAC é útil em ambientes que estão crescendo rapidamente e ajuda em situações em que o gerenciamento de políticas se torna um problema.
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 aws:ResourceTag/
, key-name
aws:RequestTag/
ou chaves de condição key-name
aws:TagKeys
.
Se um serviço for compatível com as três chaves de condição para cada tipo de recurso, o valor será Sim para o serviço. Se um serviço for compatível com as três chaves de condição somente para alguns tipos de recursos, o valor será Parcial
Para obter mais informações sobre o ABAC, consulte Definir permissões com autorização do ABAC no Guia do usuário do IAM. Para visualizar um tutorial com etapas para configurar o ABAC, consulte Usar controle de acesso baseado em atributos (ABAC) no Guia do usuário do IAM.
Usar credenciais temporárias com o Image Builder
Compatível com credenciais temporárias: sim
Alguns Serviços da AWS não funcionam quando você faz login usando credenciais temporárias. Para obter informações adicionais, incluindo quais Serviços da AWS funcionam com credenciais temporárias, consulte Serviços da AWS “Trabalhe com o IAM” no Guia do usuário do IAM.
Você está usando credenciais temporárias se fizer login AWS Management Console usando qualquer método, exceto um nome de usuário e senha. Por exemplo, quando você acessa AWS usando o link de login único (SSO) da sua empresa, esse processo cria automaticamente credenciais temporárias. Você também cria automaticamente credenciais temporárias quando faz login no console como usuário e, em seguida, alterna perfis. Para obter mais informações sobre como alternar funções, consulte Alternar para um perfil do IAM (console) no Guia do usuário do IAM.
Você pode criar manualmente credenciais temporárias usando a AWS API AWS CLI ou. Em seguida, você pode usar essas credenciais temporárias para acessar AWS. AWS recomenda que você gere credenciais temporárias dinamicamente em vez de usar chaves de acesso de longo prazo. Para obter mais informações, consulte Credenciais de segurança temporárias no IAM.
Permissões de entidade principal entre serviços para o Image Builder
Compatibilidade com o recurso de encaminhamento de sessões de acesso (FAS): sim
Quando você usa um usuário ou uma função do IAM para realizar ações AWS, você é considerado um principal. Ao usar alguns serviços, você pode executar uma ação que inicia outra ação em um serviço diferente. O FAS usa as permissões do diretor chamando um AWS service (Serviço da AWS), combinadas com a solicitação AWS service (Serviço da AWS) para fazer solicitações aos serviços posteriores. As solicitações do FAS são feitas somente quando um serviço recebe uma solicitação que requer interações com outros Serviços da AWS ou com recursos para ser concluída. Nesse caso, você precisa ter permissões para executar ambas as ações. Para obter detalhes da política ao fazer solicitações de FAS, consulte Sessões de acesso direto.
Perfis de serviço para o Image Builder
Compatível com perfis de serviço: sim
O perfil de serviço é um perfil do IAM que um serviço assume para executar ações em seu nome. Um administrador do IAM pode criar, modificar e excluir um perfil de serviço do IAM. Para obter mais informações, consulte Criar um perfil para delegar permissões a um AWS service (Serviço da AWS) no Guia do Usuário do IAM.
Atenção
Alterar as permissões de um perfil de serviço pode prejudicar a funcionalidade do Image Builder. Edite os perfis de serviço somente quando o Image Builder orientar você a fazê-lo.
Funções vinculadas ao serviço para o Image Builder
Compatibilidade com perfis vinculados a serviços: sim
Uma função vinculada ao serviço é um tipo de função de serviço vinculada a um. AWS service (Serviço da AWS) O serviço pode presumir o perfil de executar uma ação em seu nome. As funções vinculadas ao serviço aparecem em você Conta da AWS e são de propriedade do serviço. Um administrador do IAM pode visualizar, mas não editar as permissões para perfis vinculados ao serviço.
Para detalhes sobre a função vinculada ao serviço para o Image Builder, consulte Usar perfis do IAM vinculados ao serviço para o Image Builder.
Políticas baseadas em identidade do Image Builder
Com as políticas baseadas em identidade do IAM, é possível especificar ações ou recursos permitidos ou negados, além das condições sob as quais as ações são permitidas ou negadas. O Image Builder oferece suporte a ações, recursos e chaves de condição específicos. Para obter informações sobre todos os elementos que você usa em uma política JSON, consulte Ações, recursos e chaves de condição para o Amazon EC2 Image Builder no Guia do usuário do IAM.
Ações
As ações de políticas no Image Builder usam o seguinte prefixo antes da ação: imagebuilder:
. As instruções de política devem incluir um elemento Action
ou NotAction
. O Image Builder define seu próprio conjunto de ações que descrevem as tarefas que você pode executar com esse serviço.
Para especificar várias ações em uma única instrução, separe-as com vírgulas, como segue:
"Action": [ "imagebuilder:
action1
", "imagebuilder: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 List
, inclua a seguinte ação:
"Action": "imagebuilder:List*"
Para ver uma lista de ações do Image Builder , consulte Serviços da AWSAções, recursos e chaves de condição para o no Manual do usuário do IAM.
Gerenciar o acesso usando políticas
Para obter informações detalhadas sobre como gerenciar o acesso criando políticas e anexando-as às identidades ou AWS recursos do IAM, consulte Políticas e permissões no Guia do usuário do IAM. AWS
O perfil do IAM que você associa ao seu perfil de instância precisa ter permissões para executar os componentes de criação e teste incluídos na sua imagem. As seguintes políticas de perfil do IAM devem ser anexadas à função do IAM associada ao perfil de instância:
-
EC2InstanceProfileForImageBuilder
-
EC2InstanceProfileForImageBuilderECRContainerBuilds
-
AmazonSSMManagedInstanceCore
Recursos
Os administradores podem usar políticas AWS JSON 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 de política JSON Resource
especifica o objeto ou os 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 nome do recurso da Amazon (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": "*"
O ARN é composto por vários nós que ajudam a identificar o recurso e garantir que o nome seja exclusivo. Os últimos nós no nome incluem várias variações na formatação do tipo, nome e ID do recurso. Quando o Image Builder cria um recurso, ele usa o seguinte formato:
arn:aws:imagebuilder:
region
:owner
:resource-type/resource-name/version/build-version
nota
A versão de compilação nem sempre está incluída no ARN do recurso. No entanto, algumas operações de API, como GetComponent, precisam da versão de compilação para identificar de forma exclusiva um recurso a ser recuperado.
Para os recursos que o Image Builder usa em suas receitas, como a imagem base ou os componentes, o nó proprietário pode ser um dos seguintes:
-
O número da conta do proprietário do recurso
-
Para recursos gerenciados pela Amazon:
aws
-
Para obter AWS Marketplace recursos:
aws-marketplace
O exemplo a seguir mostra o ARN de um componente gerenciado para instalar o CloudWatch agente da Amazon no Linux:
arn:aws:imagebuilder:
us-east-1
:aws:component:amazon-cloudwatch-agent-linux/1.0.1/1
Este exemplo mostra o ARN de um componente gerenciado fictício do: AWS Marketplace
arn:aws:imagebuilder:
us-east-1
:aws-marketplace:component:example-linux-software-component/1.0.1
Para obter mais informações sobre como obter uma lista de componentes, incluindo o uso de um filtro de propriedade, consulteListar componentes do Image Builder.
Exemplo ARNs
Veja a seguir alguns exemplos de recursos ARNs que você pode especificar em uma política do IAM:
-
Instância ARN
"Resource": "arn:aws:imagebuilder:
us-east-1
:111122223333
:instance/i-1234567890abcdef0
" -
Exemplo de curinga (*) para especificar todas as instâncias de uma determinada conta
"Resource": "arn:aws:imagebuilder:
us-east-1
:111122223333
:instance/*" -
Exemplo de caractere curinga (*) para especificar todas as versões de um fluxo de trabalho de imagem gerenciada
"Resource": "arn:aws:imagebuilder:
us-east-1
:aws:workflow/build/build-image/*" -
ARN de imagem gerenciada
"Resource": "arn:aws:imagebuilder:
us-east-1
:aws:image/amazon-linux-2-arm64/2024.12.17/1
" -
Exemplo de curinga (*) para especificar todas as versões de uma imagem gerenciada
"Resource": "arn:aws:imagebuilder:
us-east-1
:aws:image/amazon-linux-2-arm64/x.x.x
"
Muitas ações da API EC2 Image Builder envolvem vários recursos. Para especificar vários recursos em uma única instrução, separe-os ARNs com vírgulas.
"Resource": [ "
resource1
", "resource2
" ]
Chaves de condição
O Image Builder fornece chaves de condições específicas ao serviço e é compatível com o 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 do usuário do IAM. A seguintes chaves de condição específicas ao serviço são fornecidas.
construtor de imagens: CreatedResourceTagKeys
Funciona com operadores de string.
Use esta chave para filtrar acesso por presença de chaves de tag na solicitação. Isso permite gerenciar os recursos que o Image Builder cria.
Disponibilidade — Essa chave está disponível somente para CreateInfrastrucutreConfiguration
UpdateInfrastructureConfiguration
APIs e.
construtor de imagens:/CreatedResourceTag<key>
Funciona com operadores de string.
Use esta chave para filtrar o acesso por pares de chave-valor da etiqueta anexados ao recurso criado pelo Image Builder. Isso permite gerenciar os recursos do Image Builder por meio de tags definidas.
Disponibilidade — Essa chave está disponível somente para CreateInfrastrucutreConfiguration
UpdateInfrastructureConfiguration
APIs e.
Construtor de imagens: EC2 MetadataHttpTokens
Funciona com operadores de string.
Use essa chave para filtrar o acesso pelo requisito de token HTTP de metadados da EC2 instância especificado na solicitação.
Esse valor para essa chave pode ser optional
ourequired
.
Disponibilidade — Essa chave está disponível somente para CreateInfrastrucutreConfiguration
UpdateInfrastructureConfiguration
APIs e.
construtor de imagens: StatusTopicArn
Funciona com operadores de string.
Use esta chave para filtrar o acesso pelo ARN do tópico do SNS na solicitação na qual as notificações de estado do terminal serão publicadas.
Disponibilidade — Essa chave está disponível somente para CreateInfrastrucutreConfiguration
UpdateInfrastructureConfiguration
APIs e.
Exemplos
Para visualizar exemplos de políticas baseadas em identidade do Image Builder, consulte Políticas baseadas em identidade do Image Builder.
Políticas baseadas em recursos do Image Builder
As políticas baseadas em recursos especificam quais ações uma entidade principal específica pode executar no recurso do Image Builder e sob quais condições. O Image Builder oferece suporte a políticas de permissões baseadas em recursos para componentes, imagens e fórmulas de imagens. 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 componentes, imagens e receitas de imagens.
Para obter informações sobre como anexar uma política baseada em recursos a um componente, uma imagem ou uma fórmula de imagem, consulte Compartilhe recursos do Image Builder com AWS RAM.
nota
Quando você atualiza uma política de recursos usando o Image Builder, a atualização aparecerá no console da RAM.
Autorização baseada em tags do construtor de imagens do construtor
Você pode anexar tags a recursos do Image Builder ou passar tags em uma solicitação ao Image Builder. 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 imagebuilder:ResourceTag/
, key-name
aws:RequestTag/
ou chaves de condição key-name
aws:TagKeys
. Para obter mais informações sobre marcação de recursos no Image Builder, consulte Marque um recurso do AWS CLI.
Funções do IAM do construtor de imagens
Uma função do IAM é uma entidade dentro da sua Conta da AWS que tem permissões específicas.
Usar credenciais temporárias com o Image Builder
É possível usar credenciais temporárias para fazer login com federação, assumir um perfil do IAM ou assumir um perfil entre contas. Você obtém credenciais de segurança temporárias chamando operações de AWS STS API, como AssumeRoleou GetFederationToken.
Perfis vinculados ao serviço
As funções vinculadas ao serviço permitem Serviços da AWS acessar recursos em outros serviços para concluir uma ação em seu nome. Os perfis vinculados a serviço aparecem em sua conta do IAM e são de propriedade do serviço. Um usuário com acesso administrativo pode visualizar, mas não pode editar as permissões para funções vinculadas ao serviço.
O Image Builder é compatível com funções vinculadas ao serviço. Para obter informações sobre como criar ou gerenciar funções vinculadas ao serviço do Image Builder, consulte Usar perfis do IAM vinculados ao serviço para o Image Builder.
Perfis de serviço
Esse atributo permite que um serviço assuma um perfil de serviço em seu nome. O perfil permite que o serviço acesse recursos em outros serviços para concluir uma ação em seu nome. Os perfis de serviço aparecem em sua conta do IAM e são de propriedade da conta. Isso significa que um usuário com acesso administrativo pode alterar as permissões para essa função. Porém, fazer isso pode alterar a funcionalidade do serviço.