

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 os Grupos de recursos funcionam com o IAM
<a name="security_iam_service-with-iam"></a>

Antes de usar o IAM para gerenciar o acesso aos Grupos de recursos, você precisa saber quais atributos do IAM estão disponíveis para uso com os Grupos de recursos. Para ter uma visão geral de como os Grupos de recursos e outros produtos da AWS funcionam com o IAM, consulte [Produtos da AWS compatíveis 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*.

**Topics**
+ [Políticas baseadas em identidade dos Grupos de recursos](#security_iam_service-with-iam-id-based-policies-arg-te)
+ [Políticas baseadas em recursos](#security_iam_resource-based-policies)
+ [Autorização baseada em tags dos Grupos de recursos](#security_iam_tags)
+ [Perfis do IAM dos Grupos de recursos](#security_iam_roles)

## Políticas baseadas em identidade dos Grupos de recursos
<a name="security_iam_service-with-iam-id-based-policies-arg-te"></a>

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. Os Grupos de recursos são compatíveis com ações, recursos e chaves de condição 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
<a name="security_iam_service-with-iam-id-based-policies-actions-arg-te"></a>

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íticas nos Grupos de recursos usam o seguinte prefixo antes da ação: `resource-groups:`. As ações do Tag Editor são executadas inteiramente no console, mas têm o prefixo `resource-explorer` nas entradas do log.

Por exemplo, para conceder permissão a alguém para criar um grupo de Grupos de recursos com a operação da API `CreateGroup` dos Grupos de recursos, inclua a ação `resource-groups:CreateGroup` na política. As instruções de política devem incluir um elemento `Action` ou `NotAction`. Os Grupos de recursos definem seu próprio conjunto de ações que descrevem as tarefas que você pode realizar com esse serviço.

Para especificar várias ações de Grupos de recursos e do Tag Editor em uma única declaração, separe-as com vírgulas, conforme o seguinte:

```
"Action": [
      "resource-groups:action1",
      "resource-groups:action2",
      "resource-explorer:action3"
```

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": "resource-groups:List*"
```

Para ver uma lista de ações de Grupos de recursos, consulte [Ações, recursos e chaves de condição para o AWS Resource Groups](https://docs.aws.amazon.com//IAM/latest/UserGuide/list_awsresourcegroups.html) no *Manual do usuário do IAM*.

### Recursos
<a name="security_iam_service-with-iam-id-based-policies-resources-arg-te"></a>

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 único recurso dos Grupos de recursos disponível é um *grupo*. O recurso de grupo tem o seguinte formato de ARN:

```
arn:${Partition}:resource-groups:${Region}:${Account}:group/${GroupName}
```

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 um grupo de recursos `my-test-group` na instrução, use o seguinte ARN:

```
"Resource": "arn:aws:resource-groups:us-east-1:123456789012:group/my-test-group"
```

Para especificar todos os grupos que pertencem a uma conta específica, use o caractere curinga (\$1):

```
"Resource": "arn:aws:resource-groups:us-east-1:123456789012:group/*"
```

Algumas ações dos Grupos de recursos, como as ações para a criação de recursos, não podem ser executadas em um recurso específico. Nesses casos, é necessário utilizar o caractere curinga (\$1).

```
"Resource": "*"
```

Algumas ações da API dos Grupos de recursos envolvem vários recursos. Por exemplo, `DeleteGroup` exclui grupos, portanto, uma entidade principal de chamada deve ter permissões para excluir um grupo específico ou todos os grupos. 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 Resource Groups e deles ARNs, e saber com quais ações você pode especificar o ARN de cada recurso, consulte [Actions, Resources, and Condition Keys AWS Resource Groups no Guia](https://docs.aws.amazon.com//IAM/latest/UserGuide/list_awsresourcegroups.html) *do usuário do IAM*.

### Chaves de condição
<a name="security_iam_id-based-policies-conditionkeys"></a>

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

Os Grupos de recursos definem seu próprio conjunto de chaves de condição e também oferecem suporte ao 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*.

Para ver uma lista de chaves de condição dos Grupos de recursos e saber com quais ações e recursos você pode usar uma chave de condição, consulte [Ações, recursos e chaves de condição para o AWS Resource Groups](https://docs.aws.amazon.com//IAM/latest/UserGuide/list_awsresourcegroups.html) no *Manual do usuário do IAM*.

### Exemplos
<a name="security_iam-id-based-policies-examples"></a>

Para ver exemplos das políticas baseadas em identidade dos Grupos de recursos, consulte [AWS Resource Groups exemplos de políticas baseadas em identidade](security_iam_id-based-policy-examples.md).

## Políticas baseadas em recursos
<a name="security_iam_resource-based-policies"></a>

Os Grupos de recursos não oferecem suporte a políticas baseadas em recurso.

## Autorização baseada em tags dos Grupos de recursos
<a name="security_iam_tags"></a>

Você pode anexar tags a grupos em Grupos de recursos ou transmitir tags em uma solicitação para os Grupos de recursos. 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`. Você pode aplicar tags a um grupo ao criar ou atualizar o grupo. Para obter mais informações sobre como marcar um grupo em Grupos de recursos, consulte [Criação de grupos baseados em consultas no AWS Resource Groups](gettingstarted-query.md) e [Atualizando grupos em AWS Resource Groups](updating-resource-groups.md) neste guia.

Para visualizar um exemplo de política baseada em identidade para limitar o acesso a um recurso baseado em tags desse recurso, consulte [Visualizar grupos baseados em tags](security_iam_id-based-policy-examples.md#security_iam_policy-examples-view-tags).

## Perfis do IAM dos Grupos de recursos
<a name="security_iam_roles"></a>

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. Os Grupos de recursos não têm nem usam perfis de serviço.

### Uso de credenciais temporárias com Grupos de recursos
<a name="security_iam_roles-tempcreds"></a>

Nos Grupos de recursos, você pode 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
<a name="security_iam_roles-service-linked"></a>

[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 que AWS os serviços acessem recursos em outros serviços para concluir uma ação em seu nome.

Os Grupos de recursos não têm nem usam perfis vinculados a serviços.

### Perfis de serviço
<a name="security_iam_roles-service"></a>

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.

Os Grupos de recursos não têm nem usam perfis de serviço.