Usar funções vinculadas ao serviço do AWS RAM

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

Uma função vinculada ao serviço facilita a configuração do AWS RAM porque você não precisa adicionar as permissões necessárias manualmente. AWS RAM define as permissões de suas funções vinculadas ao serviço e, a menos que definido em contrário, somente AWS RAM 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 não pode ser anexada a nenhuma outra entidade do IAM.

Para obter informações sobre outros serviços compatíveis com funções vinculadas a serviços, consulte Serviços da AWS compatíveis com o IAM e procure os serviços que contenham Yes (Sim) na coluna Service-Linked Role (Função vinculada a serviço). Escolha um Sim com um link para visualizar a documentação da função vinculada a esse serviço.

Permissões da função vinculada ao serviço para o AWS RAM

AWS RAM usa a função vinculada ao serviço nomeada AWSServiceRoleForResourceAccessManager quando você ativa o compartilhamento com AWS Organizations. Essa função concede permissões ao AWS RAM serviço para visualizar os detalhes da organização, como a lista de contas dos membros e em quais unidades organizacionais cada conta está.

Esta função vinculada ao service-linked confia no seguinte serviço para assumir a função:

• ram.amazonaws.com

A política de permissões para essa função vinculada ao serviço chama-se AWSCloud9ServiceRolePolicy, e ela permite que o AWS RAM conclua as seguintes ações nos recursos especificados:

• Ações: ações somente para leitura que recuperam detalhes sobre a estrutura da sua organização. Para ver a lista completa de ações, você pode ver a política no console do IAM: AWSResourceAccessManagerServiceRolePolicy.

Para que uma entidade principal ative o AWS RAM compartilhamento em sua organização, essa entidade principal (uma entidade do IAM, por exemplo, um usuário, grupo ou função) deve ter permissão para criar uma função vinculada a serviço. Para obter mais informações, consulte Permissões de função vinculada ao serviço no Guia do usuário do IAM.

Criação de uma função vinculada a um serviço do AWS RAM

Não é necessário criar manualmente uma função vinculada ao serviço. Quando você ativa o AWS RAM compartilhamento dentro da sua organização no AWS Management Console, ou executa o EnableSharingWithAWSOrganization em sua conta usando o AWS CLI ou uma AWS API, AWS RAM cria a função vinculada ao serviço para você.

Se você excluir essa função vinculada ao serviço, AWS RAM não terá mais permissões para visualizar os detalhes da estrutura da sua organização.

Editar uma função vinculada ao serviço para o AWS RAM

O AWS RAM não permite que você edite a função vinculada ao serviço AWSResourceAccessManagerServiceRolePolicy. Depois que criar uma função vinculada ao serviço, você não poderá alterar o nome da função, pois várias entidades podem fazer referência a ela. No entanto, será possível 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.

Exclusão de uma função vinculada ao serviço do AWS RAM

Também é possível usar o console do IAM, a AWS CLI ou a API da AWS para excluir manualmente a função vinculada ao serviço.

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 AWSResourceAccessManagerServiceRolePolicy. Para obter mais informações, consulte Excluir uma função vinculada ao serviço no Guia do usuário do IAM.

Regiões com suporte a funções vinculadas a serviço do AWS RAM

O AWS RAM oferece suporte a 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 AWS no Referência geral da Amazon Web Services.