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á. # Integração do Identity and Access Management com o Image Builder **Topics** + [Público](#security-iam-audience) + [Autenticação com identidades](#security-iam-authentication) + [Como o Image Builder utiliza políticas e perfis do IAM](security_iam_service-with-iam.md) + [Gerencie perímetros de dados para acesso ao download do bucket S3 no Image Builder](security-iam-data-perimeter.md) + [Políticas baseadas em identidade do Image Builder](security-iam-identity-based-policies.md) + [Permissões do IAM para fluxos de trabalho personalizados](#security-iam-custom-workflows) + [Políticas baseadas em recursos do Image Builder](#security-iam-resource-based-policies) + [Use políticas AWS gerenciadas para o EC2 Image Builder](security-iam-awsmanpol.md) + [Usar perfis do IAM vinculados ao serviço para o Image Builder](image-builder-service-linked-role.md) + [Solucionar problemas do IAM no Image Builder](security_iam_troubleshoot.md) ## Público A forma como você usa AWS Identity and Access Management (IAM) difere com base na sua função: + **Usuário do serviço**: solicite permissões ao seu administrador se você não conseguir acessar os atributos (consulte [Solucionar problemas do IAM no Image Builder](security_iam_troubleshoot.md)). + **Administrador do serviço**: determine o acesso do usuário e envie solicitações de permissão (consulte [Como o Image Builder utiliza políticas e perfis do IAM](security_iam_service-with-iam.md)) + **Administrador do IAM**: escreva políticas para gerenciar o acesso (consulte [Políticas baseadas em identidade do Image Builder](security_iam_service-with-iam.md#security_iam_id-based-policy-examples)) ## Autenticação com identidades Para obter informações detalhadas sobre como fornecer autenticação para pessoas e processos em seu Conta da AWS, consulte [Identidades](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html) no *Guia do usuário do IAM*. # 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) 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 podem ser anexados 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) 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. 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html) 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](#security_iam_id-based-policy-examples). ## 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. É necessário [especificar uma entidade principal](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html) 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, é possível especificar uma conta inteira ou as entidades do IAM em outra conta como a entidade principal em uma política baseada em recursos. Consulte mais informações em [Acesso a recursos entre contas no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html) 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. Incluem ações em uma política para conceder permissões para executar a operação associada. Para ver uma lista das ações do Image Builder, consulte [Ações definidas pelo EC2 Image Builder ](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonec2imagebuilder.html#amazonec2imagebuilder-actions-as-permissions) na *Referência de autorização do 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](#security_iam_id-based-policy-examples). ## 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. Como prática recomendada, especifique um recurso usando seu [nome do recurso da Amazon (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html). Para ações que não oferecem compatibilidade com permissões em nível de recurso, use um curinga (\$1) 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](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonec2imagebuilder.html#amazonec2imagebuilder-resources-for-iam-policies) Builder na Referência de *Autorização de Serviço*. Para saber com quais ações é possível especificar o ARN de cada recurso, consulte [Ações definidas pelo EC2 Image Builder](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonec2imagebuilder.html#amazonec2imagebuilder-actions-as-permissions). Para visualizar exemplos de políticas baseadas em identidade do Image Builder, consulte [Políticas baseadas em identidade do Image Builder](#security_iam_id-based-policy-examples). ## 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` especifica quando as instruções são executadas com base em critérios definidos. É possível criar expressões condicionais que usem [agentes de condição](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html), como “igual a” ou “menor que”, para fazer a condição da política corresponder aos valores na solicitação. Para ver todas as chaves de condição AWS globais, consulte as [chaves de contexto de condição AWS global](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) no *Guia do usuário do IAM*. Para ver uma lista de chaves de condição do Image Builder, consulte [Chaves de condição do EC2 Image Builder](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonec2imagebuilder.html#amazonec2imagebuilder-policy-keys) na *Referência de autorização do serviço*. Para saber com quais ações e recursos é possível usar uma chave de condição, consulte [Ações definidas pelo EC2 Image Builder](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonec2imagebuilder.html#amazonec2imagebuilder-actions-as-permissions). Para visualizar exemplos de políticas baseadas em identidade do Image Builder, consulte [Políticas baseadas em identidade do Image Builder](#security_iam_id-based-policy-examples). ## 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 permissões com base em atributos chamados de tags. Você pode anexar tags a entidades e AWS recursos do IAM e, em seguida, criar políticas ABAC para permitir operações quando a tag do diretor corresponder à tag no recurso. Para controlar o acesso baseado em tags, forneça informações sobre as tags no [elemento de condição](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) de uma política usando as `aws:ResourceTag/key-name`, `aws:RequestTag/key-name` ou chaves de condição `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 saber mais sobre o ABAC, consulte [Definir permissões com autorização do ABAC](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html) no *Guia do usuário do IAM*. Para visualizar um tutorial com etapas para configurar o ABAC, consulte [Usar controle de acesso por atributo (ABAC)](https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html) no *Guia do usuário do IAM*. ## Usar credenciais temporárias com o Image Builder **Compatível com credenciais temporárias:** sim As credenciais temporárias fornecem acesso de curto prazo aos AWS recursos e são criadas automaticamente quando você usa a federação ou troca de funções. AWS recomenda que você gere credenciais temporárias dinamicamente em vez de usar chaves de acesso de longo prazo. Para ter mais informações, consulte [Credenciais de segurança temporárias no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) e [Serviços da Serviços da AWS que funcionam com o IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) no *Guia do usuário do 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 As sessões de acesso direto (FAS) usam as permissões do principal chamando um AWS service (Serviço da AWS), combinadas com a solicitação AWS service (Serviço da AWS) de fazer solicitações aos serviços posteriores. Para obter detalhes da política ao fazer solicitações de FAS, consulte [Sessões de acesso direto](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html). ## 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) 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 saber mais, consulte [Criar um perfil para delegar permissões a um AWS service (Serviço da AWS)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) 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 assumir 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](image-builder-service-linked-role.md). ## 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 usados em uma política JSON, consulte [Ações, recursos e chaves de condição do Amazon EC2 Image Builder](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonec2imagebuilder.html) 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 (\$1). 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 AWS](https://docs.aws.amazon.com/service-authorization/latest/reference/reference_policies_actions-resources-contextkeys.html)Açõ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](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) *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. Como prática recomendada, especifique um recurso usando seu [nome do recurso da Amazon (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html). Para ações que não oferecem compatibilidade com permissões em nível de recurso, use um curinga (\$1) 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](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_GetComponent.html), 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, consulte[Listar componentes do Image Builder](component-details.md#list-components). **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 (\$1) para especificar todas as instâncias de uma determinada conta ``` "Resource": "arn:aws:imagebuilder:us-east-1:111122223333:instance/*" ``` + Exemplo de caractere curinga (\$1) 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 (\$1) 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 do 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_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 Funciona com [operadores de string](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_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: LifecyclePolicyResourceType Funciona com [operadores de string](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_String). Use essa chave para filtrar o acesso pelo tipo de recurso do ciclo de vida especificado na solicitação. O valor dessa chave pode ser `AMI_IMAGE` ou`CONTAINER_IMAGE`. **Disponibilidade** — Essa chave está disponível somente para `CreateLifecyclePolicy` `UpdateLifecyclePolicy` APIs e. #### Construtor de imagens: EC2 MetadataHttpTokens Funciona com [operadores de string](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_String). Use esta chave para filtrar o acesso pelo Requisito de token HTTP de metadados de instâncias do EC2 especificado na solicitação. Esse valor para essa chave pode ser `optional` ou`required`. **Disponibilidade** — Essa chave está disponível somente para `CreateInfrastrucutreConfiguration` `UpdateInfrastructureConfiguration` APIs e. #### construtor de imagens: StatusTopicArn Funciona com [operadores de string](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_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](security-iam-identity-based-policies.md). ## 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](manage-shared-resources.md). **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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) de uma política usando as `imagebuilder:ResourceTag/key-name`, `aws:RequestTag/key-name` ou chaves de condição `aws:TagKeys`. Para obter mais informações sobre marcação de recursos no Image Builder, consulte [Marque um recurso do AWS CLI](tag-resources.md#cli-tag-resource). ## Funções do IAM do construtor de imagens Uma [função do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) é 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 [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)ou [GetFederationToken](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetFederationToken.html). ### Perfis vinculados ao serviço [As funções vinculadas ao serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) 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](image-builder-service-linked-role.md). ### Perfis de serviço Esse atributo permite que um serviço assuma um [perfil de serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role) 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. # Gerencie perímetros de dados para acesso ao download do bucket S3 no Image Builder O EC2 Image Builder mantém duas classes AWS de buckets S3 de propriedade do serviço que contêm os recursos disponíveis para download necessários para executar as cargas de trabalho do Image Builder em sua conta. Se você usa perímetros de dados para controlar o acesso ao Amazon S3 em seu ambiente, talvez seja necessário permitir explicitamente o acesso a esses buckets. Você pode usar o ARN do bucket ou o URL do bucket para permitir esses buckets, dependendo de como você controla o acesso ao Amazon S3. **Scripts de inicialização do gerenciamento de componentes (obrigatório)** Esse bucket do S3 contém scripts de inicialização para configurar o AWSTOE aplicativo nas instâncias do EC2 que são usadas para criar imagens. O Image Builder requer acesso para baixar os scripts para apoiar a criação e o teste de novas imagens. + **ARN do bucket S3:** `arn::s3:::ec2imagebuilder-managed-resources--prod` + **URL do bucket S3:** `https://ec2imagebuilder-managed-resources-.s3..` **Componentes gerenciados** Esse bucket do S3 contém cargas úteis de pacotes para componentes gerenciados pela Amazon. O Image Builder requer acesso para baixar quaisquer componentes gerenciados que estejam configurados em suas receitas. + **ARN do bucket S3:** `arn::s3:::ec2imagebuilder-toe--prod` + **URL do bucket S3:** `https://ec2imagebuilder-toe-.s3..` # Políticas baseadas em identidade do Image Builder **Topics** + [Melhores práticas de política baseada em identidade](#security-iam-service-policy-best-practices) + [Usando o console Image Builder](#sec-iam-id-based-policies-using-console) ## Melhores práticas de política baseada em identidade As políticas baseadas em identidade determinam se alguém pode criar, acessar ou excluir recursos do Image Builder em sua conta. Essas ações podem gerar custos para sua Conta da AWS. Ao criar ou editar políticas baseadas em identidade, siga estas diretrizes e recomendações: + **Comece com as políticas AWS gerenciadas e avance para as permissões de privilégios mínimos — Para começar a conceder permissões** aos seus usuários e cargas de trabalho, use as *políticas AWS gerenciadas* que concedem permissões para muitos casos de uso comuns. Eles estão disponíveis no seu Conta da AWS. Recomendamos que você reduza ainda mais as permissões definindo políticas gerenciadas pelo AWS cliente que sejam específicas para seus casos de uso. Para saber mais, consulte [Políticas gerenciadas pela AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies) ou [Políticas gerenciadas pela AWS para funções de trabalho](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_job-functions.html) no *Guia do usuário do IAM*. + **Aplique permissões de privilégio mínimo**: ao definir permissões com as políticas do IAM, conceda apenas as permissões necessárias para executar uma tarefa. Você faz isso definindo as ações que podem ser executadas em recursos específicos sob condições específicas, também conhecidas como *permissões de privilégio mínimo*. Para saber mais sobre como usar o IAM para aplicar permissões, consulte [Políticas e permissões no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) no *Guia do usuário do IAM*. + **Use condições nas políticas do IAM para restringir ainda mais o acesso**: é possível adicionar uma condição às políticas para limitar o acesso a ações e recursos. Por exemplo, é possível escrever uma condição de política para especificar que todas as solicitações devem ser enviadas usando SSL. Você também pode usar condições para conceder acesso às ações de serviço se elas forem usadas por meio de uma ação específica AWS service (Serviço da AWS), como CloudFormation. Para saber mais, consulte [Elementos da política JSON do IAM: condição](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) no *Guia do usuário do IAM*. + **Use o IAM Access Analyzer para validar suas políticas do IAM a fim de garantir permissões seguras e funcionais**: o IAM Access Analyzer valida as políticas novas e existentes para que elas sigam a linguagem de política do IAM (JSON) e as práticas recomendadas do IAM. O IAM Access Analyzer oferece mais de cem verificações de política e recomendações práticas para ajudar a criar políticas seguras e funcionais. Para saber mais, consulte [Validação de políticas do IAM Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-validation.html) no *Guia do Usuário do IAM*. + **Exigir autenticação multifator (MFA**) — Se você tiver um cenário que exija usuários do IAM ou um usuário root, ative Conta da AWS a MFA para obter segurança adicional. Para exigir MFA quando as operações de API forem chamadas, adicione condições de MFA às suas políticas. Para saber mais, consulte [Configuração de acesso à API protegido por MFA](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_configure-api-require.html) no *Guia do Usuário do IAM*. Para saber mais sobre as práticas recomendadas do IAM, consulte [Práticas recomendadas de segurança no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) no *Guia do usuário do IAM*. ## Usando o console Image Builder Para acessar o console do EC2 Image Builder, você deve ter um conjunto mínimo de permissões. Essas permissões devem autorizar você a listar e visualizar detalhes sobre os recursos do Image Builder na sua Conta da AWS. Se você criar uma política baseada em identidade que seja mais restritiva que as permissões mínimas necessárias, o console não funcionará como pretendido para entidades (usuários ou perfis do IAM) com essa política. Para garantir que suas entidades do IAM possam usar o console do Image Builder, você deve anexar uma das seguintes políticas AWS gerenciadas a elas: + [Política AWSImageBuilderReadOnlyAccess](security-iam-awsmanpol.md#sec-iam-manpol-AWSImageBuilderReadOnlyAccess) + [Política AWSImageBuilderFullAccess](security-iam-awsmanpol.md#sec-iam-manpol-AWSImageBuilderFullAccess) Para obter mais informações sobre políticas gerenciadas pelo Image Builder, consulte [Use políticas AWS gerenciadas para o EC2 Image Builder](security-iam-awsmanpol.md). **Importante** A **AWSImageBuilderFullAccess**política é necessária para criar a função vinculada ao serviço do Image Builder. Ao anexar essa política a uma entidade do IAM, você também deve anexar a seguinte política personalizada e incluir os recursos que deseja usar e que não têm `imagebuilder` no nome do recurso: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "sns:Publish" ], "Resource": "arn:aws:sns:*:*:*imagebuilder*" }, { "Effect": "Allow", "Action": [ "iam:GetInstanceProfile" ], "Resource": "arn:aws:iam::*:instance-profile/*imagebuilder*" }, { "Effect": "Allow", "Action": "iam:PassRole", "Resource": [ "arn:aws:iam::*:instance-profile/*imagebuilder*", "arn:aws:iam::*:role/*imagebuilder*" ], "Condition": { "StringEquals": { "iam:PassedToService": "ec2.amazonaws.com" } } }, { "Effect": "Allow", "Action": [ "s3:ListBucket" ], "Resource": "arn:aws:s3::*:*imagebuilder*" } ] } ``` ------ Você não precisa permitir permissões mínimas do console para usuários que estão fazendo chamadas somente para a API AWS CLI ou para a AWS API. Em vez disso, permita o acesso somente às ações que corresponderem a operação da API que você estiver tentando executar. ## Permissões do IAM para fluxos de trabalho personalizados Ao usar fluxos de trabalho personalizados com ações de etapas específicas[RegisterImage](wfdoc-step-actions.md#wfdoc-step-action-register-image), como permissões adicionais do IAM, podem ser necessárias além das políticas gerenciadas padrão do Image Builder. Esta seção descreve as permissões adicionais necessárias para ações personalizadas das etapas do fluxo de trabalho. ### RegisterImage permissões de ação de etapa A ação da `RegisterImage` etapa exige permissões específicas do Amazon EC2 para registrar AMIs e, opcionalmente, recuperar tags de snapshot. Ao usar o `includeSnapshotTags` parâmetro, são necessárias permissões adicionais para descrever os instantâneos. **Permissões necessárias para a ação da RegisterImage etapa:** Para todos os recursos, permita as seguintes ações: + `ec2:RegisterImage` + `ec2:DescribeSnapshots` ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ec2:RegisterImage", "ec2:DescribeSnapshots" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "ec2:CreateTags" ], "Resource": "arn:aws:ec2:*::image/*", "Condition": { "StringEquals": { "ec2:CreateAction": "RegisterImage" } } } ] } ``` **Detalhes da permissão:** + `ec2:RegisterImage`- Necessário para registrar novos a AMIs partir de instantâneos + `ec2:DescribeSnapshots`- Obrigatório ao usar `includeSnapshotTags: true` para recuperar tags de instantâneo para mesclagem com tags AMI + `ec2:CreateTags`- Obrigatório para aplicar tags à AMI registrada, incluindo as tags padrão do Image Builder e as tags de snapshot mescladas **nota** A `ec2:DescribeSnapshots` permissão só é usada quando o `includeSnapshotTags` parâmetro é definido como`true`. Se você não usar esse recurso, poderá omitir essa permissão. **Comportamento de mesclagem de tags:** Quando `includeSnapshotTags` estiver ativada, a ação da RegisterImage etapa: + Recupere as tags do primeiro instantâneo especificado no mapeamento do dispositivo de bloco + Exclua todas as tags AWS reservadas (aquelas com chaves começando com “aws:”) + Mescle tags de snapshot com as tags de registro de AMI padrão do Image Builder + Dê precedência às tags do Image Builder quando as chaves de tag entrarem em conflito ## Políticas baseadas em recursos do Image Builder Para informações sobre como criar um componente, consulte [Usar componentes para personalizar sua imagem do Image Builder](manage-components.md). ### Restringir o acesso do componente do construtor de imagens a endereços IP específicos O exemplo a seguir concede permissões a qualquer usuário para executar qualquer operação do Image Builder em componentes. No entanto, a solicitação deve se originar no intervalo de endereços IP especificados na condição. A condição nesta declaração identifica o intervalo 54.240.143.\$1 de endereços IP permitidos do Protocolo de Internet versão 4 (IPv4), com uma exceção: 54.240.143.188. O `Condition` bloco usa as `NotIpAddress` condições `IpAddress` e e a chave de `aws:SourceIp` condição, que é uma chave AWS de condição ampla. Para obter mais informações sobre essas chaves de condições, consulte [Especificar condições em uma política](https://docs.aws.amazon.com/AmazonS3/latest/userguide/amazon-s3-policy-keys.html). Os `aws:sourceIp` IPv4 valores usam a notação CIDR padrão. Para obter mais informações, consulte [Operadores de condição de endereço IP](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_IPAddress) no *Guia do usuário do IAM*. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Id": "IBPolicyId1", "Statement": [ { "Sid": "IPAllow", "Effect": "Allow", "Action": "imagebuilder:GetComponent", "Resource": "arn:aws:imagebuilder:*::examplecomponent/*", "Condition": { "IpAddress": {"aws:SourceIp": "54.240.143.0/24"}, "NotIpAddress": {"aws:SourceIp": "54.240.143.188/32"} } } ] } ``` ------ # Use políticas AWS gerenciadas para o EC2 Image Builder Uma política AWS gerenciada é uma política autônoma criada e administrada por AWS. AWS as políticas gerenciadas são projetadas para fornecer permissões para muitos casos de uso comuns, para que você possa começar a atribuir permissões a usuários, grupos e funções. Lembre-se de que as políticas AWS gerenciadas podem não conceder permissões de privilégio mínimo para seus casos de uso específicos porque estão disponíveis para uso de todos os AWS clientes. Recomendamos que você reduza ainda mais as permissões definindo as [ políticas gerenciadas pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#customer-managed-policies) que são específicas para seus casos de uso. Você não pode alterar as permissões definidas nas políticas AWS gerenciadas. Se AWS atualizar as permissões definidas em uma política AWS gerenciada, a atualização afetará todas as identidades principais (usuários, grupos e funções) às quais a política está anexada. AWS é mais provável que atualize uma política AWS gerenciada quando uma nova AWS service (Serviço da AWS) é lançada ou novas operações de API são disponibilizadas para serviços existentes. Para saber mais, consulte [AWS Políticas gerenciadas pela ](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies) no *Guia do usuário do IAM*. ## Política AWSImageBuilderFullAccess A política **AWSImageBuilderFullAccess** concede acesso total aos recursos do Image Builder para a função à qual está associada, permitindo que a função liste, descreva, crie, atualize e exclua recursos do Image Builder. A política também concede permissões direcionadas aos relacionados Serviços da AWS que são necessários, por exemplo, para verificar recursos ou exibir os recursos atuais da conta no Console de gerenciamento da AWS. ### Detalhes das permissões Esta política inclui as seguintes permissões: + **Image Builder**: o acesso administrativo é concedido para que a função possa listar, descrever, criar, atualizar e excluir recursos do Image Builder. + **Amazon EC2**: o acesso é concedido para o Amazon EC2 descrever as ações que são necessárias para verificar a existência de recursos ou obter listas de recursos pertencentes à conta. + **IAM**: o acesso é concedido para obter e usar perfis de instância cujo nome contém “imagebuilder”, para verificar a existência da função vinculada ao serviço Image Builder por meio da ação de API `iam:GetRole` e para criar a função vinculada ao serviço Image Builder. + **License Manager**: o acesso é concedido para listar as configurações de licenças ou licenças de um recurso. + **Amazon S3**: o acesso é concedido aos buckets da lista pertencentes à conta e também aos buckets do Image Builder com “imagebuilder” em seus nomes. + **Amazon SNS**: permissões de gravação são concedidas ao Amazon SNS para verificar a propriedade dos tópicos que contêm “imagebuilder”. Para visualizar as permissões para esta política, consulte [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSImageBuilderFullAccess.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSImageBuilderFullAccess.html) na *Referência de políticas gerenciadas pela AWS *. ## Política AWSImageBuilderReadOnlyAccess A política do **AWSImageBuilderReadOnlyAccess** concede acesso de somente leitura a todos os recursos do Image Builder. As permissões são concedidas para verificar se a função vinculada ao serviço Image Builder existe por meio da ação da API `iam:GetRole`. ### Detalhes das permissões Esta política inclui as seguintes permissões: + **Image Builder**: o acesso é concedido de somente leitura aos recursos do Image Builder. + **IAM**: o acesso é concedido para verificar a existência da função vinculada ao serviço Image Builder por meio da ação da API `iam:GetRole`. Para visualizar as permissões para esta política, consulte [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSImageBuilderReadOnlyAccess.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSImageBuilderReadOnlyAccess.html) na *Referência de políticas gerenciadas pela AWS *. ## Política AWSServiceRoleForImageBuilder A **AWSServiceRoleForImageBuilder**política permite que o Image Builder ligue Serviços da AWS em seu nome. ### Detalhes das permissões Esta política é anexada à função vinculada ao serviço Image Builder quando a função é criada por meio do Systems Manager. Para obter mais informações sobre a função vinculada ao serviço do Image Builder, consulte [Usar perfis do IAM vinculados ao serviço para o Image Builder](image-builder-service-linked-role.md). A política inclui as seguintes permissões: + **CloudWatch Registros** — O acesso é concedido para criar e carregar CloudWatch registros em qualquer grupo de registros cujo nome comece com`/aws/imagebuilder/`. + **Amazon EC2** — O acesso é concedido ao Image Builder para criar, tirar instantâneos e registrar imagens (AMIs) que ele cria e executar instâncias EC2 em sua conta. O Image Builder usa instantâneos, volumes, interfaces de rede, sub-redes, grupos de segurança, configuração de licenças e pares de chaves relacionados conforme necessário, desde que a imagem, a instância e os volumes que estão sendo criados ou usados estejam marcados com ou. `CreatedBy: EC2 Image Builder` `CreatedBy: EC2 Fast Launch` O Image Builder pode obter informações sobre imagens do Amazon EC2, atributos da instância, status da instância, os tipos de instância que estão disponíveis para sua conta, modelos de inicialização, sub-redes, hosts e tags em seus recursos do Amazon EC2. O Image Builder pode atualizar as configurações de imagem para ativar ou desativar o lançamento mais rápido de instâncias do Windows em sua conta, onde a imagem está marcada com `CreatedBy: EC2 Image Builder`. Além disso, o Image Builder pode iniciar, interromper e encerrar instâncias em execução na sua conta, compartilhar snapshots do Amazon EBS, criar e atualizar imagens e executar modelos, cancelar o registro de imagens existentes, adicionar tags e replicar imagens em contas às quais você concedeu permissões por meio da política **Ec2ImageBuilderCrossAccountDistributionAccess**. A marcação do Image Builder é necessária para todas essas ações, conforme descrito anteriormente. + **Amazon ECR**: o acesso é concedido ao Image Builder para criar um repositório, se necessário, para escanear vulnerabilidades de imagens de contêiner e marcar os recursos que ele cria para limitar o escopo de suas operações. O acesso também é concedido ao Image Builder para excluir as imagens de contêiner que ele criou para as digitalizações depois de tirar snapshots das vulnerabilidades. + **EventBridge**— O acesso é concedido ao Image Builder para criar e gerenciar EventBridge regras. + **IAM**: o acesso é concedido para que o Image Builder passe qualquer função em sua conta para o Amazon EC2 e para o VM Import/Export. + **Amazon Inspector**: o acesso é concedido ao Image Builder para determinar quando o Amazon Inspector conclui as varreduras de instâncias de compilação e para coletar descobertas de imagens que estão configuradas para permitir isso. + **AWS KMS**: o acesso é concedido ao Amazon EBS para criptografar, descriptografar ou recriptografar volumes do Amazon EBS. Isso é crucial para garantir que os volumes criptografados funcionem quando o Image Builder cria uma imagem. + **License Manager**: o acesso é concedido ao Image Builder para atualizar as especificações do License Manager via `license-manager:UpdateLicenseSpecificationsForResource`. + **Amazon SNS**: as permissões de gravação são concedidas para qualquer tópico do Amazon SNS na sua conta. + **Systems Manager**: o acesso é concedido ao Image Builder para listar os comandos do Systems Manager e as respectivas invocações e entradas de inventário, descrever informações de instância e status de execução de automação, descrever hosts para suporte ao posicionamento de instâncias e obter detalhes de invocação de comandos. O Image Builder também pode enviar sinais de automação e interromper as execuções de automação para qualquer recurso em sua conta. O Image Builder é capaz de emitir invocações de comando de execução para qualquer instância que esteja com a tag `"CreatedBy": "EC2 Image Builder"` para os seguintes arquivos de script: `AWS-RunPowerShellScript`, `AWS-RunShellScript` ou `AWSEC2-RunSysprep`. O Image Builder é capaz de iniciar uma execução de automação do Systems Manager em sua conta para documentos de automação em que o nome começa com `ImageBuilder`. O Image Builder também pode criar ou excluir associações do State Manager para qualquer instância em sua conta, desde que o documento de associação seja `AWS-GatherSoftwareInventory`. Além disso, pode criar a função vinculada ao serviço Systems Manager em sua conta. O Image Builder é capaz de ler parâmetros públicos do Parameter Store e ler e atualizar parâmetros privados prefixados com `/imagebuilder/` para que ele possa atualizar o valor do parâmetro com a AMI de saída IDs que o Image Builder cria a partir de uma nova compilação. + **AWS STS**: o acesso é concedido para que o Image Builder assuma funções nomeadas **EC2ImageBuilderDistributionCrossAccountRole** de sua conta em qualquer conta em que a política de confiança da função permita. Isso é usado para distribuição de imagens entre contas. Para visualizar as permissões para esta política, consulte [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSServiceRoleForImageBuilder.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSServiceRoleForImageBuilder.html) na *Referência de políticas gerenciadas pela AWS *. ## Política Ec2ImageBuilderCrossAccountDistributionAccess A política do **Ec2ImageBuilderCrossAccountDistributionAccess** concede permissões para o Image Builder distribuir imagens entre contas nas regiões de destino. Além disso, o Image Builder pode descrever, copiar e aplicar tags a qualquer imagem do Amazon EC2 na conta. A política também concede a capacidade de modificar as permissões da AMI por meio da ação da API `ec2:ModifyImageAttribute`. ### Detalhes das permissões Esta política inclui as seguintes permissões: + **Amazon EC2**: o acesso é concedido ao Amazon EC2 para descrever, copiar e modificar atributos de uma imagem e criar tags para qualquer imagem do Amazon EC2 na conta. Para visualizar as permissões para esta política, consulte [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/Ec2ImageBuilderCrossAccountDistributionAccess.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/Ec2ImageBuilderCrossAccountDistributionAccess.html) na *Referência de políticas gerenciadas pela AWS *. ## Política EC2ImageBuilderLifecycleExecutionPolicy A **EC2ImageBuilderLifecycleExecutionPolicy**política concede permissões para que o Image Builder execute ações como descontinuar, desativar ou excluir recursos de imagem do Image Builder e seus recursos subjacentes (AMIsinstantâneos) para dar suporte a regras automatizadas para tarefas de gerenciamento do ciclo de vida de imagens. ### Detalhes das permissões Esta política inclui as seguintes permissões: + **Amazon EC2** — O acesso é concedido ao Amazon EC2 para realizar as seguintes ações para Amazon Machine Images AMIs () na conta que está marcada com. `CreatedBy: EC2 Image Builder` + Habilite e desabilite uma AMI. + Habilite e desabilite a descontinuação de imagens. + Descreva e cancele o registro de uma AMI. + Descreva e modifique os atributos da imagem de AMI. + Exclua os snapshots de volume associados à AMI. + Recupere as tags para um recurso. + Adicionar ou remover tags de uma AMI para descontinuação. + **Amazon ECR**: o acesso é concedido ao Amazon ECR para realizar as seguintes ações em lote nos repositórios dp ECR com a tag `LifecycleExecutionAccess: EC2 Image Builder`. As ações em lote são compatíveis com regras automatizadas de ciclo de vida de imagens de contêineres. + `ecr:BatchGetImage` + `ecr:BatchDeleteImage` O acesso é concedido no nível do repositório para repositórios do ECR marcados com `LifecycleExecutionAccess: EC2 Image Builder`. + **AWS Grupos de recursos** — O acesso é concedido ao Image Builder para obter recursos com base em tags. + **EC2 Image Builder**: o acesso é concedido ao Image Builder para excluir recursos de imagem do Image Builder. Para visualizar as permissões para esta política, consulte [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/EC2ImageBuilderLifecycleExecutionPolicy.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/EC2ImageBuilderLifecycleExecutionPolicy.html) na *Referência de políticas gerenciadas pela AWS *. ## Política EC2InstanceProfileForImageBuilder A política do **EC2InstanceProfileForImageBuilder** concede as permissões mínimas necessárias para que uma instância do EC2 funcione com o Image Builder. Isso não inclui as permissões necessárias para usar o Systems Manager Agent. ### Detalhes das permissões Esta política inclui as seguintes permissões: + **CloudWatch Registros** — O acesso é concedido para criar e carregar CloudWatch registros em qualquer grupo de registros cujo nome comece com`/aws/imagebuilder/`. + **Amazon EC2** — O acesso é concedido para descrever volumes e instantâneos, criar instantâneos de recursos de volume ou instantâneos criados pelo Image Builder e criar tags para recursos do Image Builder. + **Image Builder** — O acesso é concedido para obter qualquer Image Builder ou AWS Marketplace componente. + **AWS KMS**— O acesso é concedido para descriptografar um componente do Image Builder, se ele tiver sido criptografado via. AWS KMS + **Amazon S3** — O acesso é concedido para obter objetos armazenados em um bucket do Amazon S3 cujo nome comece `ec2imagebuilder-` com, ou recursos que tenham uma extensão de arquivo ISO. Para visualizar as permissões para esta política, consulte [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/EC2InstanceProfileForImageBuilder.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/EC2InstanceProfileForImageBuilder.html) na *Referência de políticas gerenciadas pela AWS *. ## Política EC2InstanceProfileForImageBuilderECRContainerBuilds A política do **EC2InstanceProfileForImageBuilderECRContainerBuilds** concede as permissões mínimas necessárias para uma instância do EC2 ao trabalhar com o Image Builder para criar imagens do Docker e, em seguida, registrar e armazenar as imagens em um repositório de contêiner do Amazon ECR. Isso não inclui as permissões necessárias para usar o Systems Manager Agent. ### Detalhes das permissões Esta política inclui as seguintes permissões: + **CloudWatch Registros** — O acesso é concedido para criar e carregar CloudWatch registros em qualquer grupo de registros cujo nome comece com`/aws/imagebuilder/`. + **Amazon ECR**: o acesso é concedido ao Amazon ECR para obter, registrar e armazenar uma imagem de contêiner e obter um token de autorização. + **Image Builder**: o acesso é concedido para obter um componente ou fórmula de contêiner do Image Builder. + **AWS KMS**— O acesso é concedido para descriptografar um componente ou uma receita de contêiner do Image Builder, se ele tiver sido criptografado via. AWS KMS + **Amazon S3**: o acesso é concedido para obter objetos armazenados em um bucket do Amazon S3 cujo nome começa com `ec2imagebuilder-`. Para visualizar as permissões para esta política, consulte [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/EC2InstanceProfileForImageBuilderECRContainerBuilds.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/EC2InstanceProfileForImageBuilderECRContainerBuilds.html) na *Referência de políticas gerenciadas pela AWS *. ## Atualizações do Image Builder para políticas AWS gerenciadas Esta seção fornece informações sobre atualizações nas políticas AWS gerenciadas do Image Builder desde que esse serviço começou a rastrear essas alterações. Para receber alertas automáticos sobre alterações realizadas nesta página, inscreva-se no feed RSS na página [Histórico de documentos](doc-history.md) do Image Builder. | Alteração | Descrição | Data | | --- | --- | --- | | [AWSServiceRoleForImageBuilder](#sec-iam-manpol-AWSServiceRoleForImageBuilder): atualizar para uma política existente | O Image Builder fez as alterações a seguir no perfil de serviço: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 26 de fevereiro de 2026 | | [AWSServiceRoleForImageBuilder](#sec-iam-manpol-AWSServiceRoleForImageBuilder) – atualização para uma política existente | O Image Builder fez as seguintes alterações na função de serviço para oferecer suporte ao uso dos parâmetros de armazenamento de parâmetros AWS Systems Manager (SSM) em receitas e durante a distribuição de imagens. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 23 de julho de 2025 | | [EC2InstanceProfileForImageBuilder](#sec-iam-manpol-EC2InstanceProfileForImageBuilder) – atualização para uma política existente | O Image Builder fez as seguintes alterações na política de perfil da instância para oferecer suporte a mais extensões de arquivo para downloads de arquivos ISO. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 19 de maio de 2025 | | [AWSServiceRoleForImageBuilder](#sec-iam-manpol-AWSServiceRoleForImageBuilder) – atualização para uma política existente | O Image Builder fez as seguintes alterações na função de serviço para oferecer suporte à importação de arquivos ISO do sistema operacional cliente Microsoft como imagem base. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 30 de dezembro de 2024 | | [EC2InstanceProfileForImageBuilder](#sec-iam-manpol-EC2InstanceProfileForImageBuilder) – atualização para uma política existente | O Image Builder fez as seguintes alterações na política de perfil da instância para oferecer suporte à criação de imagens a partir de arquivos de imagem de disco. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 30 de dezembro de 2024 | | [EC2InstanceProfileForImageBuilder](#sec-iam-manpol-EC2InstanceProfileForImageBuilder): política atualizada | O Image Builder atualizou a `EC2InstanceProfileForImageBuilder` política para permitir que o Image Builder obtenha AWS Marketplace componentes. | 2 de dezembro de 2024 | | [EC2ImageBuilderLifecycleExecutionPolicy](#sec-iam-manpol-EC2ImageBuilderLifecycleExecutionPolicy) – Nova política | O Image Builder adicionou a nova política `EC2ImageBuilderLifecycleExecutionPolicy` que contém permissões para o gerenciamento do ciclo de vida de imagem. | 17 de novembro de 2023 | | [AWSServiceRoleForImageBuilder](#sec-iam-manpol-AWSServiceRoleForImageBuilder) – atualização para uma política existente | O Image Builder fez as alterações a seguir no perfil de serviço para oferecer compatibilidade com o posicionamento de instâncias. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 19 de outubro de 2023 | | [AWSServiceRoleForImageBuilder](#sec-iam-manpol-AWSServiceRoleForImageBuilder) – atualização para uma política existente | O Image Builder fez as alterações a seguir no perfil de serviço para oferecer compatibilidade com o posicionamento de instâncias. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 28 de setembro de 2023 | | [AWSServiceRoleForImageBuilder](#sec-iam-manpol-AWSServiceRoleForImageBuilder) – atualização para uma política existente | O Image Builder fez as seguintes alterações no perfil de serviço para permitir que os fluxos de trabalho do Image Builder coletassem descobertas de vulnerabilidade para compilações de imagens de contêiner AMI e ECR. As novas permissões são compatíveis com o atributo de detecção e geração de relatórios do CVE. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 30 de março de 2023 | | [AWSServiceRoleForImageBuilder](#sec-iam-manpol-AWSServiceRoleForImageBuilder) – atualização para uma política existente | O Image Builder fez as alterações a seguir no perfil de serviço: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 22 de março de 2022 | | [AWSServiceRoleForImageBuilder](#sec-iam-manpol-AWSServiceRoleForImageBuilder) – atualização para uma política existente | O Image Builder fez as alterações a seguir no perfil de serviço: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 21 de fevereiro de 2022 | | [AWSServiceRoleForImageBuilder](#sec-iam-manpol-AWSServiceRoleForImageBuilder) – atualização para uma política existente | O Image Builder fez as alterações a seguir no perfil de serviço: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 20 de novembro de 2021 | | [AWSServiceRoleForImageBuilder](#sec-iam-manpol-AWSServiceRoleForImageBuilder) – atualização para uma política existente | O Image Builder adicionou novas permissões para corrigir problemas em que mais de uma associação de inventário faz com que a criação da imagem fique paralisada. | 11 de agosto de 2021 | | [AWSImageBuilderFullAccess](#sec-iam-manpol-AWSImageBuilderFullAccess) – atualização para uma política existente | O Image Builder fez as alterações a seguir no perfil de acesso total: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 13 de abril de 2021 | | O Image Builder começou a monitorar alterações | O Image Builder começou a monitorar as mudanças em suas políticas AWS gerenciadas. | 02 de abril de 2021 | # Usar perfis do IAM vinculados ao serviço para o Image Builder O EC2 Image Builder AWS Identity and Access Management usa funções vinculadas a [serviços (IAM)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role). Um perfil vinculado ao serviço é um tipo exclusivo de perfil do IAM que é vinculado diretamente ao Image Builder. As funções vinculadas ao serviço são predefinidas pelo Image Builder e incluem todas as permissões que o serviço exige para ligar para outras pessoas Serviços da AWS em seu nome. Um perfil vinculado ao serviço torna a configuração do Image Builder mais eficiente, porque você não precisa adicionar as permissões necessárias manualmente. O Image Builder define as permissões de seus perfis vinculados ao serviço e, exceto se definido de outra forma, somente o Image Builder pode assumir seus perfis. As permissões definidas incluem a política de confiança e a política de permissões. A política de permissões não pode ser anexada a nenhuma outra entidade do IAM. Para obter informações sobre outros serviços que são compatíveis com os perfis vinculados ao serviço, consulte [Serviços da AWS Compatíveis com o IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) e procure os serviços que contêm **Sim** na coluna **Perfil vinculado ao serviço**. Escolha um **Sim** com um link para visualizar a documentação do perfil vinculado para esse serviço. ## Permissões de perfil vinculado ao serviço para o Image Builder O Image Builder usa a função **AWSServiceRoleForImageBuilder**vinculada ao serviço para permitir que o EC2 Image Builder acesse AWS recursos em seu nome. O perfil vinculado ao serviço confia no serviço *imagebuilder.amazonaws.com* para assumir o perfil. Você não precisa criar manualmente esse perfil vinculado ao serviço. Quando você cria sua primeira imagem do Image Builder no AWS Management Console, ou na AWS API AWS CLI, o Image Builder cria a função vinculada ao serviço para você. As ações a seguir criam uma nova imagem: + Execute o assistente de pipeline no console do Image Builder para criar uma imagem personalizada. + Use uma das ações de API a seguir ou o AWS CLI comando correspondente: + A ação **[CreateImage](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateImage.html)** da API (**[create-image](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html)**no AWS CLI). + A ação **[ImportVmImage](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ImportVmImage.html)** da API (**[import-vm-image](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/import-vm-image.html)**no AWS CLI). + A ação **[StartImagePipelineExecution](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_StartImagePipelineExecution.html)** da API (**[start-image-pipeline-execution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/start-image-pipeline-execution.html)**no AWS CLI). **Importante** Se o perfil vinculado ao serviço for excluído da sua conta, você poderá usar o mesmo processo para criá-lo novamente. Quando você cria seu primeiro recurso EC2 Image Builder, o Image Builder cria um perfil vinculado ao serviço para você novamente. Para ver as permissões do **AWSServiceRoleForImageBuilder**, consulte a página [Política AWSServiceRoleForImageBuilder](security-iam-awsmanpol.md#sec-iam-manpol-AWSServiceRoleForImageBuilder). Para saber mais sobre como configurar permissões para um perfil vinculado ao serviço, consulte [Permissões do perfil vinculado ao serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions) no *Guia do usuário do IAM*. ## Remover um perfil vinculado ao serviço do Image Builder da sua conta Você pode usar o console do IAM AWS CLI, o ou a AWS API para remover manualmente a função vinculada ao serviço do Image Builder da sua conta. No entanto, antes de fazer isso, você deve garantir que não haja recursos habilitados do Image Builder que se refiram a ele. **nota** Se o serviço do Image Builder estiver usando o perfil quando você tenta excluir os recursos, a exclusão poderá falhar. Se isso acontecer, espere alguns minutos e tente a operação novamente. **Limpe os recursos do Image Builder usados pelo perfil `AWSServiceRoleForImageBuilder`** 1. Verifique se não há compilações de pipeline em execução antes de começar. Para cancelar uma compilação em execução, use o comando `cancel-image-creation` do AWS CLI. ``` aws imagebuilder cancel-image-creation --image-build-version-arn arn:aws:imagebuilder:us-east-1:123456789012:image-pipeline/sample-pipeline ``` 1. Altere todas as programações do pipeline para usar um processo de compilação manual ou as exclua se você não quiser usá-las novamente. Para obter mais informações sobre exclusão de recursos, consulte [Excluir recursos desatualizados ou não utilizados do Image Builder](delete-resources.md). **Excluir o perfil vinculado a serviço usando o IAM** Você pode usar o console do IAM AWS CLI, o ou a AWS API para excluir a `AWSServiceRoleForImageBuilder` função da sua conta. Para obter mais informações, consulte [Excluir uma função vinculada ao serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role) no *Guia do usuário do IAM*. ## Regiões compatíveis com os perfis vinculados ao serviço do Image Builder O Image Builder oferece suporte ao uso de funções vinculadas ao serviço em todas as AWS regiões em que o serviço está disponível. Para ver a lista de AWS regiões suportadas, consulte[AWS Regiões e endpoints](what-is-image-builder.md#image-builder-regions). # Solucionar problemas do IAM no Image Builder **Topics** + [Não tenho autorização para executar uma ação no Image Builder](#security_iam_troubleshoot-no-permissions) + [Não estou autorizado a realizar iam: PassRole](#security_iam_troubleshoot-passrole) + [Quero permitir que pessoas de fora da minha acessem meus Conta da AWS recursos do Image Builder](#security_iam_troubleshoot-cross-account-access) ## Não tenho autorização para executar uma ação no Image Builder Se você receber uma mensagem de erro informando que não tem autorização para executar uma ação, suas políticas deverão ser atualizadas para permitir que você realize a ação. O erro do exemplo a seguir ocorre quando o usuário do IAM `mateojackson` tenta usar o console para visualizar detalhes sobre um atributo `my-example-widget` fictício, mas não tem as permissões `imagebuilder:GetWidget` fictícias. ``` User: arn:aws:iam::123456789012:user/mateojackson is not authorized to perform: imagebuilder:GetWidget on resource: my-example-widget ``` Nesse caso, a política do usuário `mateojackson` deve ser atualizada para permitir o acesso ao recurso `my-example-widget` usando a ação `imagebuilder:GetWidget`. Se precisar de ajuda, entre em contato com seu AWS administrador. Seu administrador é a pessoa que forneceu suas credenciais de login. ## Não estou autorizado a realizar iam: PassRole Se você receber uma mensagem de erro informando que não tem autorização para executar a ação `iam:PassRole`, as suas políticas deverão ser atualizadas para permitir a passagem de um perfil para o Image Builder. Alguns Serviços da AWS permitem que você passe uma função existente para esse serviço em vez de criar uma nova função de serviço ou uma função vinculada ao serviço. Para fazer isso, é preciso ter permissões para passar o perfil para o serviço. O erro de exemplo a seguir ocorre quando uma usuária do IAM chamada `marymajor` tenta usar o console para executar uma ação no Image Builder. No entanto, a ação exige que o serviço tenha permissões concedidas por um perfil de serviço. Mary não tem permissões para passar o perfil para o serviço. ``` User: arn:aws:iam::123456789012:user/marymajor is not authorized to perform: iam:PassRole ``` Nesse caso, as políticas de Mary devem ser atualizadas para permitir que ela realize a ação `iam:PassRole`. Se precisar de ajuda, entre em contato com seu AWS administrador. Seu administrador é a pessoa que forneceu suas credenciais de login. ## Quero permitir que pessoas de fora da minha acessem meus Conta da AWS recursos do Image Builder É possível criar um perfil que os usuários de outras contas ou pessoas fora da organização podem usar para acessar seus recursos. É possível especificar quem é confiável para assumir o perfil. Para serviços que oferecem suporte a políticas baseadas em recursos ou listas de controle de acesso (ACLs), você pode usar essas políticas para conceder às pessoas acesso aos seus recursos. Para saber mais, consulte: + Para saber se o Image Builder oferece suporte a esses atributos, consulte [Como o Image Builder utiliza políticas e perfis do IAM](security_iam_service-with-iam.md). + Para saber como fornecer acesso aos seus recursos em todos os Contas da AWS que você possui, consulte Como [fornecer acesso a um usuário do IAM em outro Conta da AWS que você possui](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_aws-accounts.html) no *Guia do usuário do IAM*. + Para saber como fornecer acesso aos seus recursos a terceiros Contas da AWS, consulte Como [fornecer acesso Contas da AWS a terceiros](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_third-party.html) no *Guia do usuário do IAM*. + Para saber como conceder acesso por meio da federação de identidades, consulte [Conceder acesso a usuários autenticados externamente (federação de identidades)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_federated-users.html) no *Guia do usuário do IAM*. + Para conhecer a diferença entre perfis e políticas baseadas em recurso para acesso entre contas, consulte [Acesso a recursos entre contas no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html) no *Guia do usuário do IAM*.