Usar funções vinculadas ao serviço no Amazon WorkMail

O Amazon WorkMail usa funções vinculadas ao serviço do AWS Identity and Access Management (IAM). Uma função vinculada ao serviço é um tipo especial de perfil do IAM vinculado diretamente ao Amazon WorkMail. As funções vinculadas a serviços são predefinidas pelo Amazon WorkMail e incluem todas as permissões que o serviço precisa para chamar outros produtos da AWS em seu nome.

Uma função vinculada ao serviço facilita a configuração do Amazon WorkMail porque você não precisa adicionar as permissões necessárias manualmente. O Amazon WorkMail define as permissões das funções vinculadas ao serviço e, exceto definido de outra forma, somente o Amazon WorkMail pode assumir suas funções. As permissões definidas incluem a política de confiança e a política de permissões, e essa política de permissões não pode ser anexada a nenhuma outra entidade do IAM.

Você pode excluir uma função vinculada ao serviço somente depois de excluir os recursos relacionados da . Isso protege os recursos do Amazon WorkMail, pois você não pode remover por engano as permissões para acessar os recursos.

Para obter informações sobre outros serviços que oferecem suporte às funções vinculadas a serviço, consulte Serviços da AWS compatíveis que funcionam com o IAM e procure os serviços que apresentam Sim na coluna Função vinculada ao serviço. Escolha um Sim com um link para exibir a documentação da função vinculada a serviço desse serviço.

Permissões da função vinculada ao serviço no Amazon WorkMail

O Amazon WorkMail usa a função vinculada ao serviço chamada AmazonWorkmailEvents – O Amazon WorkMail usa essa função vinculada ao serviço para permitir o acesso a serviços e recursos da AWS usados ou gerenciados por eventos do Amazon WorkMail, como o monitoramento de eventos de e-mail registrados em log pelo CloudWatch. Para obter mais informações sobre como habilitar o registro em log de eventos de e-mail no Amazon WorkMail, consulte Habilitando o registro de eventos de e-mail.

A função vinculada ao serviço AmazonWorkMailEvents confia nos seguintes serviços para assumir a função:

• events.workmail.amazonaws.com

A política de permissões da função permite que o Amazon WorkMail conclua as ações a seguir nos recursos especificados:

• Ação: logs:CreateLogGroup em all AWS resources

• Ação: logs:CreateLogStream em all AWS resources

• Ação: logs:PutLogEvents em all AWS resources

Você deve configurar permissões para que uma entidade do IAM (por exemplo, um usuário, grupo ou função) crie, edite ou exclua uma função vinculada ao serviço. Para obter mais informações, consulte Service-linked role permissions (Permissões de função vinculada a serviços) no Guia do usuário do IAM.

Criar uma função vinculada ao serviço no Amazon WorkMail

Não é necessário criar manualmente uma função vinculada ao serviço. Quando você ativa o registro em log de eventos do Amazon WorkMail e usa as configurações padrão no console do Amazon WorkMail, o Amazon WorkMail cria a função vinculada ao serviço para você.

Se excluir essa função vinculada ao serviço e precisar criá-la novamente, você poderá usar esse mesmo processo para recriar a função em sua conta. Quando você ativa o registro em log de eventos do Amazon WorkMail e usa as configurações padrão, o Amazon WorkMail cria a função vinculada ao serviço para você novamente.

Editar uma função vinculada ao serviço no Amazon WorkMail

O Amazon WorkMail não permite que você edite a função vinculada ao serviço AmazonWorkMailEvents. Depois que você criar uma função vinculada a serviço, não poderá alterar o nome da função, pois várias entidades podem fazer referência à função. No entanto, você poderá editar a descrição da função usando o IAM. Para obter mais informações, consulte Editar uma função vinculada ao serviço no Guia do usuário do IAM.

Excluir uma função vinculada ao serviço no Amazon WorkMail

Se você não precisar mais usar um recurso ou serviço que requer uma função vinculada a serviço, é recomendável excluí-la. Dessa forma, você não tem uma entidade não utilizada que não seja monitorada ativamente ou mantida. No entanto, você deve limpar os recursos de sua função vinculada ao serviço antes de excluí-la manualmente.

nota

Se o serviço do Amazon WorkMail estiver usando a função quando você tentar excluir os recursos, a exclusão poderá falhar. Se isso acontecer, espere alguns minutos e tente a operação novamente.

Para excluir os recursos do Amazon WorkMail usados por AmazonWorkMailEvents

1. Desative o registro em log de eventos do Amazon WorkMail.

   1. Abra o console do Amazon WorkMail em https://console.aws.amazon.com/workmail/.

      Se necessário, altere a região da AWS. Na barra na parte superior da janela do console, abra a lista Selecionar uma região e escolha uma região. Para obter mais informações, consulte Regiões e endpoints da na Referência geral da Amazon Web Services.

   2. No painel de navegação, selecione Organizações e, em seguida, escolha o nome da organização.

   3. No painel de navegação, selecione Configurações da organização e, em seguida, escolha Monitoramento.

   4. Em Log settings (Configurações de log), escolha Edit (Editar).

   5. Mova o controle deslizante Habilitar eventos de e-mail para a posição desativado.

   6. Escolha Save (Salvar).

2. Excluir o grupo de logs do Amazon CloudWatch.

   1. Abra o console do CloudWatch em https://console.aws.amazon.com/cloudwatch/.

   2. Escolha Logs.

   3. Em Log Groups (Grupos de log), selecione os grupos para excluir.

   4. Em Actions (Ações), escolha Delete log group (Excluir grupo de registros).

   5. Selecione Sim, excluir.

Como excluir manualmente a função vinculada ao serviço usando o IAM

Use o console do IAM, a AWS CLI ou a API da AWS para excluir a função vinculada ao serviço AmazonWorkMailEvents. Para obter mais informações, consulte Excluir uma função vinculada ao serviço no Guia do usuário do IAM.

Regiões compatíveis com funções vinculadas ao serviço do Amazon WorkMail

O Amazon WorkMail é compatível com funções vinculadas a serviços em todas as regiões em que o serviço está disponível. Para obter mais informações, consulte Regiões e endpoints do Amazon WorkMail.