As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Como o Amazon MQ funciona com o IAM
Antes de usar o IAM para gerenciar o acesso ao Amazon MQ, você deve entender quais recursos do IAM estão disponíveis para uso com a Amazon MQ. Para ter uma visão de alto nível de como o Amazon MQ e AWS outros serviços funcionam com o IAM, [AWS consulte Serviços que funcionam com o IAM no Guia](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) do usuário *do IAM*.
O Amazon MQ usa o IAM para operações de API do Amazon MQ para criar, atualizar, excluir e listar agentes. Para acesso do agente para publicar e assinar mensagens, o Amazon MQ para ActiveMQ oferece suporte à autenticação ActiveMQ nativa e ao LDAP, enquanto o Amazon MQ para RabbitMQ suporta autenticação IAM e outros métodos. Para obter mais informações, consulte [Autenticação e autorização do corretor](security-broker-auth-ref.md).
**Topics**
+ [Políticas baseadas em identidade do Amazon MQ](#security_iam_service-with-iam-id-based-policies)
+ [Políticas baseadas em recursos do Amazon MQ](#security_iam_service-with-iam-resource-based-policies)
+ [Autorização baseada em etiquetas do Amazon MQ](#security_iam_service-with-iam-tags)
+ [Funções do IAM do Amazon MQ](#security_iam_service-with-iam-roles)
## Políticas baseadas em identidade do Amazon MQ
Com as políticas baseadas em identidade do IAM, é possível especificar ações ou recursos permitidos ou negados, bem como as condições sob as quais as ações são permitidas ou negadas. O Amazon MQ é compatível com ações, chaves de condição e recursos específicos. Para conhecer todos os elementos usados em uma política JSON, consulte [Referência de elementos 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*.
### Ações
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.
As ações de política no Amazon MQ usam o seguinte prefixo antes da ação: `mq:`. Por exemplo, para conceder permissão a alguém para executar uma instância do Amazon MQ com a operação da API `CreateBroker` do Amazon MQ, inclua a ação `mq:CreateBroker` na política da pessoa. As instruções de política devem incluir um elemento `Action` ou `NotAction`. O Amazon MQ 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": [
"mq:action1",
"mq: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 `Describe`, inclua a seguinte ação:
```
"Action": "mq:Describe*"
```
Para ver uma lista das ações do Amazon MQ, consulte [Ações definidas pelo Amazon MQ](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonmq.html#amazonmq-actions-as-permissions) no *Manual do usuário IAM*.
### 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": "*"
```
No Amazon MQ, os principais AWS recursos são um agente de mensagens do Amazon MQ e sua configuração. Cada agente e configuração do Amazon MQ tem Amazon Resource Names (ARNs) exclusivos associados a eles, conforme mostrado na tabela a seguir.
****
| Tipos de recursos | ARN | Chaves de condição |
| --- | --- | --- |
| brokers | arn:aws:mq:us-east-1:123456789012:broker:\$1\$1brokerName\$1:\$1\$1brokerId\$1 | [aws:ResourceTag/\$1\$1TagKey\$1](#amazonmq-aws_ResourceTag___TagKey_) |
| configurations | arn:\$1\$1Partition\$1:mq:\$1\$1Region\$1:\$1\$1Account\$1:configuration:\$1\$1configuration-id\$1 | [aws:ResourceTag/\$1\$1TagKey\$1](#amazonmq-aws_ResourceTag___TagKey_) |
Para obter mais informações sobre o formato de ARNs, consulte [Amazon Resource Names (ARNs) e AWS Service Namespaces](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).
Por exemplo, para especificar o agente denominado `MyBroker` com brokerId `b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9` em sua declaração, use o seguinte ARN:
```
"Resource": "arn:aws:mq:us-east-1:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9"
```
Para especificar todos os agentes e configurações que pertencem a uma conta específica, use o caractere curinga (\$1):
```
"Resource": "arn:aws:mq:us-east-1:123456789012:*"
```
Algumas ações do Amazon MQ, como as de criação de recursos, não podem ser executadas em um recurso específico. Nesses casos, é necessário utilizar o caractere curinga (\$1).
```
"Resource": "*"
```
A ação da API `CreateTags` requer um agente e uma configuração. Para especificar vários recursos em uma única instrução, separe-os ARNs com vírgulas.
```
"Resource": [
"resource1",
"resource2"
```
Para ver uma lista dos tipos de recursos do Amazon MQ e seus ARNs, consulte [Recursos definidos pelo Amazon MQ](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonmq.html#amazonmq-resources-for-iam-policies) no Guia do usuário *do* IAM. Para saber com quais ações você pode especificar o ARN de cada recurso, consulte [Ações definidas pelo Amazon MQ](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonmq.html#amazonmq-actions-as-permissions).
### Chaves de condição
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*.
O Amazon MQ não define nenhuma chave de condição específica ao serviço, mas é compatível com o uso de algumas chaves de condição globais. Para ver uma lista de chaves de condição do Amazon MQ, consulte a tabela abaixo ou [Chaves de condição para o Amazon MQ](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonmq.html#amazonmq-policy-keys) no *Manual do usuário do IAM*. Para saber com quais ações e recursos você pode usar a chave de condição, consulte [Ações definidas pelo Amazon MQ](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonmq.html#amazonmq-actions-as-permissions).
****
| Chaves de condição | Descrição | Tipo |
| --- | --- | --- |
| [foi: RequestTag /\$1 \$1\$1 TagKey](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-requesttag) | Filtra ações com base nas tags transmitidas na solicitação. | String |
| [foi: ResourceTag /\$1 \$1\$1 TagKey](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-resourcetag) | Filtra as ações com base nas tags associadas ao recurso. | String |
| [leis: TagKeys](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-tagkeys) | Filtra ações com base nas chaves de tag transmitidas na solicitação. | String |
### Exemplos
Para visualizar exemplos de políticas baseadas em identidade do Amazon MQ, consulte [Exemplos de políticas baseadas em identidade do Amazon MQ](security_iam_id-based-policy-examples.md).
## Políticas baseadas em recursos do Amazon MQ
Atualmente, o Amazon MQ não é compatível com a autenticação IAM que usam permissões baseadas em recursos ou políticas baseadas em recursos.
## Autorização baseada em etiquetas do Amazon MQ
É possível anexar etiquetas aos recursos do Amazon MQ ou informar etiquetas em uma solicitação para o Amazon MQ. 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 `mq:ResourceTag/key-name`, `aws:RequestTag/key-name` ou chaves de condição `aws:TagKeys`.
O Amazon MQ é compatível com políticas baseadas em etiquetas. Por exemplo, você pode negar acesso a todos os recursos do Amazon MQ que incluem uma etiqueta com a chave `environment` e o valor `production`:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Deny",
"Action": [
"mq:DeleteBroker",
"mq:RebootBroker",
"mq:DeleteTags"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"aws:ResourceTag/environment": "production"
}
}
}
]
}
```
------
Esta política vai `Deny` a capacidade de excluir ou reiniciar um agente do Amazon MQ que inclui a etiqueta `environment/production`.
Para obter mais informações sobre marcação, consulte:
+ [Adicionar tags aos recursos do Amazon MQ](amazon-mq-tagging.md)
+ [Controlar o acesso com tags do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_iam-tags.html)
## Funções do IAM do Amazon MQ
Uma [função do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) é uma entidade dentro da sua AWS conta que tem permissões específicas.
### Usar credenciais temporárias com o Amazon MQ
É 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).
A Amazon MQ é compatível com o uso de credenciais temporárias.
### 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 administrador do IAM pode alterar as permissões para esse perfil. Porém, fazer isso pode alterar a funcionalidade do serviço.
O Amazon MQ é compatível com as funções de serviço.