Usar funções vinculadas ao serviço do Detective

O Amazon Detective usa funções vinculadas a serviços AWS Identity and Access Management (IAM). A função vinculada ao serviço é um tipo exclusivo de perfil do IAM vinculada diretamente ao Detective. As funções vinculadas ao serviço são predefinidas pelo Detective e incluem todas as permissões que o serviço exige para ligar para outros AWS serviços em seu nome.

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

Um perfil vinculado ao serviço poderá ser excluído somente após excluir seus atributos relacionados. Isso protege seus recursos do Detective, 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ços, consulte serviços da AWS compatíveis com o IAM e procure os serviços que apresentam Sim na coluna Função vinculada a serviços. 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 do Detective

O Detective usa a função vinculada ao serviço chamada — AWSServiceRoleForDetectivePermite que o Detective acesse informações em seu nome. AWS Organizations

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

• detective.amazonaws.com

A função AWSServiceRoleForDetective vinculada ao serviço usa a política gerenciada. AmazonDetectiveServiceLinkedRolePolicy

Para obter detalhes sobre as atualizações da AmazonDetectiveServiceLinkedRolePolicy política, consulte as atualizações do Amazon Detective para políticas AWS gerenciadas. Para receber alertas automáticos sobre alterações nessa política, assine o feed RSS na página de histórico de documentos do Detective.

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 a serviço. Para obter mais informações, consulte Permissões de função vinculada a serviços no Guia do usuário do IAM.

Criar uma função vinculada ao serviço do Detective

Você não precisa criar manualmente uma função vinculada a serviço. Quando você designa a conta de administrador do Detective para uma organização na, na ou AWS Management Console na API, AWS CLI o Detective cria AWS a função vinculada ao serviço para você.

Se excluir esse perfil vinculado ao serviço e precisar criá-lo novamente, você poderá usar esse mesmo processo para recriar o perfil em sua conta. Quando você designa a conta de administrador do Detective para uma organização, o Detective cria novamente a função vinculada ao serviço para você.

Editar uma função vinculada ao serviço do Detective

Detective não permite que você edite a função vinculada ao AWSServiceRoleForDetective serviço. Depois que criar um perfil vinculado ao serviço, você não poderá alterar o nome do perfil, pois várias entidades podem fazer referência a ele. No entanto, será possível editar a descrição do perfil usando o IAM. Para ter mais informações, consulte Editar um perfil vinculado ao serviço no Guia do usuário do IAM.

Excluir uma função vinculada ao serviço do Detective

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 sua função vinculada ao serviço antes de excluí-la manualmente.

nota

Se o serviço do Detective 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 Detective usados pelo AWSServiceRoleForDetective

1. Remova a conta de administrador do Detective. Consulte Designando o administrador do Detective para uma organização.

2. Repita o processo em cada região em que você designou a conta de administrador do Detective.

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

Use o console do IAM AWS CLI, o ou a AWS API para excluir a função AWSServiceRoleForDetective vinculada ao serviço. Para 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 Detective

O Detective oferece suporte a funções vinculadas ao serviço em todas as regiões em que o serviço está disponível. Para obter mais informações, consulte Regiões e endpoints da AWS.