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 obter uma visualização de alto nível de como o Amazon MQ e outros serviços da AWS funcionam com o IAM, consulte Serviços da AWS compatíveis com o IAM no Manual do usuário do IAM.

O Amazon MQ usa o IAM para criar, atualizar e excluir operações, exceto a autenticação nativa do ActiveMQ para agentes. Para ter mais informações, consulte Integração de agentes ActiveMQ com LDAP.

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 no Guia do usuário do IAM.

Ações

Os administradores podem usar as políticas JSON da AWS para especificar quem tem acesso a o 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 você pode usar para permitir ou negar acesso em uma política. As ações de políticas geralmente têm o mesmo nome que a operação de API da AWS 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.

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 (*). 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 no Manual do usuário IAM.

Recursos

Os administradores podem usar AWS as políticas JSON para especificar quem tem acesso a 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": "*"

No Amazon MQ, os recursos AWS principais são um agente de mensagens do Amazon MQ e sua configuração. Os agentes e configurações do Amazon MQ têm nomes do recurso da Amazon (ARNs) exclusivos associados a eles, conforme mostrado na tabela a seguir.

Para obter mais informações sobre o formato de ARNs, consulte Nomes de recursos da Amazon (ARNs)AWS e namespaces de serviços da

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 (*):

"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, você deve utilizar o caractere curinga (*).

"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 da Amazon MQ e seus ARNs, consulte Recursos definidos pelo Amazon MQ no Manual 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.

Chaves de condição

Os administradores podem usar as políticas JSON AWS para especificar quem tem acesso a 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 Condition em uma instrução ou várias chaves em um único Condition elemento, a AWS os avaliará usando uma operação lógica AND. Se você especificar vários valores para uma única chave de condição, a AWS avaliará a condição usando uma operação lógica OR. 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 atributo 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.

A AWS oferece compatibilidade com chaves de condição globais e chaves de condição específicas do serviço. Para ver todas as chaves de condição globais da AWS, consulte Chaves de Contexto de Condição Globais da AWS 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 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.

Exemplos

Para visualizar exemplos de políticas baseadas em identidade do Amazon MQ, consulte Exemplos de políticas baseadas em identidade do Amazon MQ.

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 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:

{
    "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:

Funções do IAM do Amazon MQ

Perfil do IAM é uma entidade dentro da sua conta da AWS 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. As credenciais de segurança temporárias são obtidas chamando operações da API do AWS STS, como AssumeRole ou GetFederationToken.

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