**Aviso**: novas inscrições de clientes e atualizações de conta não estão mais disponíveis para a Amazon. WorkDocs Saiba mais sobre as etapas de migração aqui: [Como migrar dados de WorkDocs](https://aws.amazon.com/blogs/business-productivity/how-to-migrate-content-from-amazon-workdocs).

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 a Amazon WorkDocs trabalha com o IAM
<a name="security_iam_service-with-iam"></a>

Antes de usar o IAM para gerenciar o acesso WorkDocs, você precisa entender quais recursos do IAM estão disponíveis para uso WorkDocs. Para ter uma visão de alto nível de como WorkDocs e outros AWS serviços funcionam com o 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*.

**Topics**
+ [Políticas baseadas em identidade do WorkDocs](#security_iam_service-with-iam-id-based-policies)
+ [Políticas baseadas em recursos do WorkDocs](#security_iam_service-with-iam-resource-based-policies)
+ [Autorização baseada em tags do WorkDocs](#security_iam_service-with-iam-tags)
+ [WorkDocs Funções do IAM](#security_iam_service-with-iam-roles)

## Políticas baseadas em identidade do WorkDocs
<a name="security_iam_service-with-iam-id-based-policies"></a>

Com as políticas baseadas em identidade do IAM, você pode especificar ações permitidas ou negadas. WorkDocs suporta ações específicas. Para saber mais sobre 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 *Manual do usuário do IAM*.

### Ações
<a name="security_iam_service-with-iam-id-based-policies-actions"></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. As ações de política geralmente têm o mesmo nome da operação de AWS API 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 políticas WorkDocs usam o seguinte prefixo antes da ação:`workdocs:`. Por exemplo, para conceder permissão a alguém para executar a operação da WorkDocs `DescribeUsers` API, você inclui a `workdocs:DescribeUsers` ação na política dessa pessoa. As declarações de política devem incluir um elemento `Action` ou WorkDocs . 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 instrução, separe-as com vírgulas, como segue:

```
"Action": [
      "workdocs:DescribeUsers",
      "workdocs:CreateUser"
```

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": "workdocs:Describe*"
```



**nota**  
Para garantir a compatibilidade com versões anteriores, inclua a ação `zocalo`. Por exemplo:  

```
"Action": [
"zocalo:*",
"workdocs:*"
],
```

Para ver uma lista de WorkDocs ações, consulte [Ações definidas WorkDocs](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonworkdocs.html#amazonworkdocs-actions-as-permissions) no *Guia do usuário do IAM*.

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

WorkDocs não suporta a especificação de recursos ARNs em uma política.

### Chaves de condição
<a name="security_iam_service-with-iam-id-based-policies-conditionkeys"></a>

WorkDocs não fornece nenhuma chave de condição específica do serviço, mas oferece suporte ao uso de algumas chaves de condição globais. 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*.

### Exemplos
<a name="security_iam_service-with-iam-id-based-policies-examples"></a>



Para ver exemplos de políticas WorkDocs baseadas em identidade, consulte. [Exemplos de políticas WorkDocs baseadas em identidade da Amazon](security_iam_id-based-policy-examples.md)

## Políticas baseadas em recursos do WorkDocs
<a name="security_iam_service-with-iam-resource-based-policies"></a>

WorkDocs não oferece suporte a políticas baseadas em recursos.

## Autorização baseada em tags do WorkDocs
<a name="security_iam_service-with-iam-tags"></a>

WorkDocs não oferece suporte à marcação de recursos ou ao controle de acesso com base em tags.

## WorkDocs Funções do IAM
<a name="security_iam_service-with-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.

### Usando credenciais temporárias com WorkDocs
<a name="security_iam_service-with-iam-roles-tempcreds"></a>

Recomendados fortemente 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). 

WorkDocs suporta o uso de credenciais temporárias. 

### Perfis vinculados a serviço
<a name="security_iam_service-with-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 perfis vinculados a serviço aparecem em sua conta do IAM e são de propriedade do serviço. Um administrador do IAM pode visualizar, mas não pode editar as permissões para perfis vinculados a serviço.

WorkDocs não oferece suporte a funções vinculadas a serviços.

### Perfis de serviço
<a name="security_iam_service-with-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. 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.

WorkDocs não oferece suporte a funções de serviço.