Encontrar integrações que precisam de uma conta de serviço de execução

Esta página ajuda você a encontrar as integrações que exigem uma conta de serviço de execução antes que as mudanças de autorização entrem em vigor.

Determinar se uma integração precisa de uma conta de serviço de execução

Você só precisa de uma conta de serviço de execução quando as credenciais do usuário não estão disponíveis para toda a execução. Isso ocorre nas seguintes situações:

Tipo de execução	As credenciais do usuário estão disponíveis?	A conta de serviço de execução é obrigatória?
Síncrona: um usuário aciona a integração e aguarda o resultado.	Sim, durante toda a execução.	Não
Assíncrona: a integração é colocada na fila e concluída mais tarde.	Sim, mas apenas quando acionado.	Sim
Sem supervisão: uma programação ou um evento aciona a integração.	Não, um usuário nunca está presente.	Sim

Observação: as execuções assíncronas exigem uma conta de serviço de execução, mesmo que sejam acionadas por um usuário. O trabalho em fila não retém as credenciais do usuário, o que significa que nenhuma identidade está disponível para autorizar a integração quando ela é executada. Uma integração que é executada apenas de maneira síncrona não precisa de uma conta de serviço de execução, a menos que ela chame outra integração de maneira assíncrona. Nesse caso, a subintegração requer a própria conta de serviço de execução.

Identificar integrações afetadas

Uma integração é executada sem uma identidade de usuário se qualquer uma das seguintes condições for atendida:

• Ele tem qualquer gatilho que não seja uma API ou particular, por exemplo, um gatilho de programação, Cloud Scheduler, Cloud Pub/Sub, Salesforce, evento do Integration Connectors ou Eventarc.
• Ela é programada pela API usando scheduleIntegrations.
• Outra integração a chama como uma subintegração assíncrona, usando a tarefa Chamar integração. A subintegração precisa da própria conta de serviço de execução, mesmo que a integração de chamada tenha uma.
• Ele usa a tarefa Suspender ou Aprovação, em que uma execução pode ficar aguardando e expirar por conta própria.

Verificar o status da conta de serviço de execução

Para listar todas as versões publicadas em uma região com as contas de serviço de execução, execute o seguinte comando:

curl -s -G -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  --data-urlencode "filter=state=ACTIVE" \
  --data-urlencode "pageSize=1000" \
  "https://REGION-integrations.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/integrations/-/versions" \
| jq -r '.integrationVersions[]
         | [ .name, (.runAsServiceAccount // "NONE") ]
         | @tsv'

Substitua:

• REGION: a região da integração. Para ver a lista de regiões com disponibilidade, consulte Locais.
• PROJECT_ID: o ID do seu projeto do Google Cloud;

Se a saída mostrar NONE para uma integração, você só precisará entrar em ação se a integração atender a qualquer uma das condições listadas anteriormente.

Para verificar uma integração manualmente, abra-a no editor de integração e clique em Configurações de integração na barra de ferramentas do editor. O campo Conta de serviço mostra a conta de serviço de execução. Ele ficará vazio se uma conta de serviço não for atribuída.

Atenção: mantenha filter=state=ACTIVE na solicitação em vez de filtrar a saída depois. O caractere curinga - retorna apenas a versão modificada mais recentemente de cada integração. Se você buscar tudo e filtrar depois, uma integração com a versão mais recente como um rascunho não publicado será omitida dos resultados, mesmo que uma versão publicada mais antiga ainda esteja em execução. Se a resposta contiver um nextPageToken, repita a solicitação usando pageToken=TOKEN até que o token não seja mais retornado.

Aviso: não confie apenas nos avisos do console do Google Cloud . Uma integração em uma programação pouco frequente ou que não foi acionada recentemente pode exigir uma ação sem exibir um aviso. Sempre verifique suas integrações programadas e orientadas por eventos usando as etapas descritas nesta página.

A seguir

• Conceda o papel de Usuário da conta de serviço nas contas de serviço de execução que você já usa.
• Defina uma conta de serviço de execução em cada integração encontrada.