Usar funções vinculadas ao serviço para o AppIntegrations

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

Uma função vinculada ao serviço facilita a configuração do Amazon AppIntegrations porque você não precisa adicionar as permissões necessárias manualmente. O Amazon AppIntegrations define as permissões das funções vinculadas ao serviço e, exceto se definido de outra forma, somente o Amazon AppIntegrations pode assumir suas próprias 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.

Uma função vinculada ao serviço poderá ser excluída somente após excluir seus recursos relacionados. Isso protege seus recursos do Amazon AppIntegrations, pois não é possível remover por engano as permissões para acessar os recursos.

Para obter informações sobre outros serviços compatíveis com perfis vinculados aos serviços, consulte Serviços da AWS que funcionam com o IAM e procure os serviços que apresentam Sim na coluna Funções vinculadas aos serviços. Escolha um Sim com um link para visualizar a documentação da função vinculada a esse serviço.

Permissões de função vinculada ao serviço para o Amazon AppIntegrations

O Amazon AppIntegrations usa a função vinculada ao serviço chamadaAWSServiceRoleForAppIntegrations, que permite que o AppIntegrations acesse os serviços da AWS em seu nome.

A função vinculada ao serviço AWSServiceRoleForAppIntegrations confia no seguinte serviço para assumir a função:

A política de permissões da função denominada AppIntegrationsServiceLinkedRolePolicy permite que o Amazon AppIntegrations conclua as seguintes ações nos recursos especificados:

     {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "cloudwatch:PutMetricData"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "cloudwatch:namespace": "AWS/AppIntegrations"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "appflow:DescribeConnectorEntity",
                "appflow:ListConnectorEntities"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "appflow:DescribeConnectorProfiles",
                "appflow:UseConnectorProfile"
            ],
            "Resource": "arn:aws:appflow:*:*:connector-profile/*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "appflow:DeleteFlow",
                "appflow:DescribeFlow",
                "appflow:DescribeFlowExecutionRecords",
                "appflow:StartFlow",
                "appflow:StopFlow",
                "appflow:UpdateFlow"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/AppIntegrationsManaged": "true"
                }
            },
            "Resource": "arn:aws:appflow:*:*:flow/FlowCreatedByAppIntegrations-*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "appflow:TagResource"
            ],
            "Condition": {
                "ForAllValues:StringEquals": {
                    "aws:TagKeys": [
                        "AppIntegrationsManaged"
                    ]
                }
            },
            "Resource": "arn:aws:appflow:*:*:flow/FlowCreatedByAppIntegrations-*"
        }
    ]
}
   

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 para o Amazon AppIntegrations

Não é necessário criar manualmente uma função vinculada ao serviço. Quando você cria uma integração de dados ou eventos usando o Amazon Q in Connect, o Customer Profiles ou o widget Tarefas no Amazon Connect no AWS Management Console, na AWS CLI ou na API da AWS, o Amazon AppIntegrations 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ê pode usar esse mesmo processo para recriar a função na sua conta. Quando você cria uma integração de dados ou eventos usando o Amazon Q in Connect, o Customer Profiles ou o widget Tarefas no Amazon Connect, o Amazon AppIntegrations cria a função vinculada ao serviço novamente para você.

Você também pode usar o console do IAM para criar um perfil vinculado ao serviço com o caso de uso AppIntegrations. Na AWS CLI ou na API do AWS, crie uma função vinculada ao serviço com o nome de serviço app-integrations.amazonaws.com. Para obter mais informações, consulte Criar uma função vinculada ao serviço no Manual do usuário do IAM. Se você excluir essa função vinculada ao serviço, será possível usar esse mesmo processo para criar a função novamente.

Editar uma função vinculada ao serviço para o Amazon AppIntegrations

O Amazon AppIntegrations não permite que você edite a função vinculada ao serviço AWSServiceRoleForAppIntegrations. 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 uma função vinculada a serviço no Guia do usuário do IAM.

Excluir uma função vinculada ao serviço para o Amazon AppIntegrations

Se você não precisar mais usar um atributo 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. Você deve primeiro excluir suas associações de integração de dados e eventos no Console da AWS e, em seguida, excluir as integrações de dados e eventos usando a AWS CLI.

Como excluir manualmente a função vinculada a 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 AWSServiceRoleForAppIntegrations. 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 AppIntegrations

O Amazon AppIntegrations é compatível com 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.

Você pode usar a função AWSServiceRoleForAppIntegrations nas regiões a seguir.