Usar funções vinculadas ao serviço no Amazon WorkMail - Amazon WorkMail
Permissões da função vinculada ao serviço no Amazon WorkMailCriar uma função vinculada ao serviço no Amazon WorkMailEditar uma função vinculada ao serviço no Amazon WorkMailExcluir uma função vinculada ao serviço no Amazon WorkMailRegiões compatíveis com funções vinculadas ao serviço do Amazon WorkMail

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 um perfil vinculado ao serviço somente depois de excluir os atributos relacionados. 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 Habilitar 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 um perfil vinculado a serviço. Para obter mais informações, consulte Permissões de perfil vinculado ao serviço no Guia do usuário do IAM.

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

Não é necessário criar manualmente um perfil vinculado 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 esse perfil vinculado ao serviço e precisar criá-lo novamente, será possível usar esse mesmo processo para recriar o perfil 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 um perfil vinculado ao serviço, não poderá alterar o nome do perfil, pois várias entidades podem fazer referência ao perfil. No entanto, você poderá editar a descrição do perfil usando o IAM. Para obter mais informações, consulte Editar uma função vinculada a 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 um perfil vinculado ao serviço, é recomendável excluí-lo. 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 seu perfil vinculado ao serviço antes de excluí-lo 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 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 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 o perfil vinculado 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 um perfil vinculado 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.