Como o AWS IoT Greengrass funciona com o IAM - AWS IoT Greengrass

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 AWS IoT Greengrass funciona com o IAM

Antes de usar o IAM para gerenciar o acesso ao AWS IoT Greengrass, você deve entender os atributos do IAM que você pode usar com o AWS IoT Greengrass.

Para ter uma visão geral de como outros serviços da AWS funcionam com o IAM, consulte Serviços da AWS compatíveis com o IAM no Guia do usuário do IAM.

Políticas do baseadas em identidade para o AWS IoT Greengrass

Com as políticas baseadas em identidade do IAM, é possível especificar ações e recursos permitidos ou negados e as condições sob as quais as ações são permitidas ou negadas. O AWS IoT Greengrass oferece suporte a ações, recursos e chaves de condição específicos. Para saber mais sobre todos os elementos usados em uma política, 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 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 do AWS IoT Greengrass usam o prefixo greengrass: antes da ação. Por exemplo, para permitir que alguém use a operação de API ListCoreDevices para listar os dispositivos principais na Conta da AWS, inclua a ação greengrass:ListCoreDevices na política da pessoa. As declarações de política devem incluir um elemento Action ou AWS IoT Greengrass. O NotAction define seu próprio conjunto de ações que descrevem as tarefas que podem ser executadas com esse serviço.

Para especificar várias ações em uma única declaração, coloque-as entre parênteses ([ ]) e separe-as com vírgulas, da seguinte forma:

"Action": [ "greengrass:action1", "greengrass:action2", "greengrass:action3" ]

Você pode usar curingas (*) para especificar várias ações. Por exemplo, para especificar todas as ações que começam com a palavra List, inclua a seguinte ação:

"Action": "greengrass:List*"
nota

Recomendamos que você evite o uso de curingas para especificar todas as ações disponíveis para um serviço. De acordo com as melhores práticas, você deve conceder permissões de privilégio mínimo e definir um escopo de permissões mais específico em uma política. Para obter mais informações, consulte Conceder o mínimo possível de permissões.

Para obter a lista de ações do AWS IoT Greengrass, consulte Ações definidas pelo AWS IoT Greengrass no Manual do usuário do IAM.

Recursos

Os administradores podem usar as políticas JSON da 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 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). Para ações em que não é possível usar permissões em nível de recurso, use um curinga (*) para indicar que a instrução se aplica a todos os recursos.

"Resource": "*"

A tabela a seguir contém os ARNs de recurso do AWS IoT Greengrass que podem ser usados no elemento Resource de uma declaração de política. Para obter um mapeamento das permissões de nível de recurso para ações do AWS IoT Greengrass compatíveis, consulte Ações definidas pelo AWS IoT Greengrass no Guia do usuário do IAM.

Algumas ações do AWS IoT Greengrass (por exemplo, algumas operações de lista), não podem ser executadas em um recurso específico. Nesses casos, você deve usar apenas o caractere curinga.

"Resource": "*"

Para especificar vários ARNs de recurso em uma declaração, liste-os entre parênteses ([ ]) e separe-os com vírgulas, da seguinte forma:

"Resource": [ "resource-arn1", "resource-arn2", "resource-arn3" ]

Para obter mais informações sobre formatos de ARN, consulte Nomes de recurso da Amazon (ARNs) e namespaces de serviços da AWS, no Referência geral da Amazon Web Services.

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 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, 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 globais da AWS, consulte Chaves de contexto de condição globais da AWS no Guia do usuário do IAM.

Exemplos

Para ver exemplos de políticas baseadas em identidade do AWS IoT Greengrass, consulte Exemplos de políticas baseadas em identidade para o AWS IoT Greengrass.

Políticas baseadas em recursos para o AWS IoT Greengrass

O AWS IoT Greengrass não oferece suporte a políticas baseadas em recurso.

Listas de controle de acesso (ACLs)

O AWS IoT Greengrass não oferece suporte a ACLs.

Autorização baseada em tags do AWS IoT Greengrass

É possível anexar tags a recursos do AWS IoT Greengrass compatíveis ou passar tags em uma solicitação ao AWS IoT Greengrass. 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 chaves de condição aws:ResourceTag/${TagKey}, aws:RequestTag/${TagKey} ou aws:TagKeys. Para obter mais informações, consulte Marcar com tag os recursos do AWS IoT Greengrass Version 2.

Perfis do IAM para o AWS IoT Greengrass

Um perfil do IAM é uma entidade dentro da sua Conta da AWS que tem permissões específicas.

Usar credenciais temporárias com o AWS IoT Greengrass

Credenciais temporárias são usadas para fazer login com federação, assumir um perfil do IAM ou assumir uma função entre contas. As credenciais de segurança temporárias são obtidas chamando AWS STS operações da API como AssumeRole ou GetFederationToken.

No núcleo do Greengrass, credenciais temporárias para a função do dispositivo são disponibilizadas aos componentes do Greengrass. Se seus componentes usam o SDK da AWS, não é preciso adicionar uma lógica para obter as credenciais porque o SDK da AWS faz isso para você.

Perfis vinculados a serviço

O AWS IoT Greengrass não oferece suporte às funções vinculadas ao serviço.

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.

Os dispositivos principais do AWS IoT Greengrass usam um perfil de serviço para permitir que os componentes do Greengrass e as funções do Lambda acessem alguns dos recursos da AWS em seu nome. Para obter mais informações, consulte Autorize os dispositivos principais a interagir com os serviços da AWS.

O AWS IoT Greengrass usa um perfil de serviço para acessar alguns dos recursos da AWS em seu nome. Para obter mais informações, consulte Função de serviço do Greengrass.