Aviso de fim do suporte: em 31 de março de 2027, AWS encerrará o suporte para a Amazon WorkMail. Depois de 31 de março de 2027, você não poderá mais acessar o WorkMail console da Amazon ou os WorkMail recursos da Amazon. Para obter mais informações, consulte [ WorkMail Fim do suporte da Amazon](https://docs.aws.amazon.com/workmail/latest/adminguide/workmail-end-of-support.html).
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 WorkMail trabalha com o IAM
Antes de usar o IAM para gerenciar o acesso à Amazon WorkMail, você deve entender quais recursos do IAM estão disponíveis para uso com a Amazon WorkMail. Para ter uma visão de alto nível de como a Amazon WorkMail 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 WorkMail identidade da Amazon](#security_iam_service-with-iam-id-based-policies)
+ [Políticas baseadas em WorkMail recursos da Amazon](#security_iam_service-with-iam-resource-based-policies)
+ [Autorização com base nas WorkMail tags da Amazon](#security_iam_service-with-iam-tags)
+ [Funções WorkMail do Amazon IAM](#security_iam_service-with-iam-roles)
## Políticas baseadas em WorkMail identidade da Amazon
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. A Amazon WorkMail oferece suporte a 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
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 políticas na Amazon WorkMail usam o seguinte prefixo antes da ação:`workmail:`. Por exemplo, para conceder permissão a alguém para recuperar uma lista de usuários com a operação de WorkMail `ListUsers` API da Amazon, você inclui a `workmail:ListUsers` ação na política dessa pessoa. As instruções de política devem incluir um elemento `Action` ou `NotAction`. A Amazon WorkMail define seu próprio conjunto de ações que descrevem tarefas que você pode realizar com esse serviço.
Para especificar várias ações em uma única instrução, separe-as com vírgulas, como segue:
```
"Action": [
"workmail:ListUsers",
"workmail:DeleteUser"
```
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 `List`, inclua a seguinte ação:
```
"Action": "workmail:List*"
```
Para ver uma lista de WorkMail ações da Amazon, consulte [Ações definidas pela Amazon WorkMail](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonworkmail.html#amazonworkmail-actions-as-permissions) no *Guia do usuário do 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 (\*) para indicar que a instrução se aplica a todos os recursos.
```
"Resource": "*"
```
A Amazon WorkMail oferece suporte a permissões em nível de recursos para organizações da Amazon. WorkMail
O recurso WorkMail organizacional da Amazon tem o seguinte ARN:
```
arn:aws:workmail:${Region}:${Account}:organization/${OrganizationId}
```
Para obter mais informações sobre o formato dos ARNs, consulte [Amazon Resource Names (ARNs) e namespaces AWS de serviços](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).
Por exemplo, para especificar a organização `m-n1pq2345678r901st2u3vx45x6789yza` em sua declaração, use o ARN a seguir.
```
"Resource": "arn:aws:workmail:us-east-1:111122223333:organization/m-n1pq2345678r901st2u3vx45x6789yza"
```
Para especificar todas as organizações que pertencem a uma conta específica, use o caractere curinga (\*):
```
"Resource": "arn:aws:workmail:us-east-1:111122223333:organization/*"
```
Algumas WorkMail ações da Amazon, como as de criação de recursos, não podem ser realizadas em um recurso específico. Nesses casos, é necessário utilizar o caractere curinga (\*).
```
"Resource": "*"
```
Para ver uma lista dos tipos de WorkMail recursos da Amazon e seus ARNs, consulte [Recursos definidos pela Amazon WorkMail](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonworkmail.html#amazonworkmail-resources-for-iam-policies) no *Guia do usuário do IAM*. Para saber com quais ações você pode especificar para o ARN de cada recurso, consulte [Ações, recursos e chaves de condição para a Amazon](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonworkmail.html). WorkMail
### Chaves de condição
A Amazon WorkMail oferece suporte às seguintes chaves de condição globais.
+ `aws:CurrentTime`
+ `aws:EpochTime`
+ `aws:MultiFactorAuthAge`
+ `aws:MultiFactorAuthPresent`
+ `aws:PrincipalOrgID`
+ `aws:PrincipalArn`
+ `aws:RequestedRegion`
+ `aws:SecureTransport`
+ `aws:UserAgent`
O exemplo de política a seguir concede acesso ao WorkMail console da Amazon somente de diretores do IAM autenticados pelo MFA na região da AWS. `eu-west-1`
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"ses:Describe*",
"ses:Get*",
"workmail:Describe*",
"workmail:Get*",
"workmail:List*",
"workmail:Search*",
"lambda:ListFunctions",
"iam:ListRoles",
"logs:DescribeLogGroups",
"cloudwatch:GetMetricData"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"aws:RequestedRegion": [
"eu-west-1"
]
},
"Bool": {
"aws:MultiFactorAuthPresent": true
}
}
}
]
}
```
------
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*.
`workmail:ImpersonationRoleId`é a única chave de condição específica do serviço suportada pela Amazon. WorkMail
O exemplo a seguir reduz o escopo da `AssumeImpersonationRole` ação para uma determinada WorkMail organização e função de representação.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"workmail:AssumeImpersonationRole"
],
"Resource": "arn:aws:workmail:{{us-east-1}}:{{111122223333}}:organization/{{m-n1pq2345678r901st2u3vx45x6789yza}}",
"Condition": {
"StringEquals": {
"workmail:ImpersonationRoleId":"{{12345678-1234-1234-1234-123456789012}}"
}
}
}
]
}
```
------
### Exemplos
Para ver exemplos de políticas WorkMail baseadas em identidade da Amazon, consulte. [Exemplos de políticas WorkMail baseadas em identidade da Amazon](security_iam_id-based-policy-examples.md)
## Políticas baseadas em WorkMail recursos da Amazon
A Amazon WorkMail não oferece suporte a políticas baseadas em recursos.
## Autorização com base nas WorkMail tags da Amazon
Você pode anexar tags aos WorkMail recursos da Amazon ou passar tags em uma solicitação para a Amazon WorkMail. 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`. Para obter mais informações sobre a marcação de WorkMail recursos da Amazon, consulte[Marcar uma organização](org-tag.md).
## Funções WorkMail do Amazon IAM
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 a Amazon WorkMail
É 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 WorkMail oferece suporte ao uso de credenciais temporárias.
### Service-linked funções
[Service-linked as funções](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) permitem que os AWS serviços acessem recursos em outros serviços para concluir uma ação em seu nome. Service-linked as funções aparecem na 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.
A Amazon WorkMail oferece suporte a funções vinculadas a serviços. Para obter detalhes sobre como criar ou gerenciar funções WorkMail vinculadas a serviços da Amazon, consulte. [Usando funções vinculadas a serviços para a Amazon WorkMail](using-service-linked-roles.md)
### 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.
A Amazon WorkMail oferece suporte a funções de serviço.