Prepare-se para as próximas mudanças na autorização

O Application Integration está atualizando a forma como autoriza integrações. Essas mudanças entraram em vigor para novas integrações em 15 de outubro de 2026. As integrações atuais mantêm o comportamento atual até uma data posterior. A maioria das integrações continua funcionando sem mudanças, mas algumas exigem uma atualização de configuração para continuar em execução. É possível fazer as mudanças descritas nesta página agora, porque elas usam configurações que você já controla.

Próximas mudanças na autorização

A Application Integration está atualizando a forma como lida com identidades para execuções de integração. Agora, cada execução precisa ter uma identidade explícita, atuando como uma das seguintes:

• O usuário que acionou a execução. Os sistemas chamados aplicam as permissões de acesso do usuário.
• Uma conta de serviço de execução. Você controla, define o escopo e audita essa conta como qualquer outra conta de serviço no seu projeto do Google Cloud.

Por causa dessa atualização:

• Para publicar ou testar uma integração que tenha uma conta de serviço de execução, você precisa ter permissão para atuar como essa conta. A execução da integração, a aprovação das execuções suspensas e a chamada de outra integração exigirão a mesma permissão à medida que o lançamento prosseguir.
• Não é possível publicar ou testar uma nova integração com um gatilho programado ou de evento sem uma conta de serviço de execução. As execuções que alcançam uma tarefa sem uma identidade e as execuções assíncronas de qualquer integração sem uma conta de serviço de execução vão falhar em uma versão posterior.

Quando as atualizações entram em vigor

Integração	Quando as atualizações são aplicadas
Criados a partir de 15 de outubro de 2026	Da primeira versão que você criar. Todas as versões publicadas depois disso vão manter o novo comportamento.
Criados antes de 15 de outubro de 2026	Essas integrações mantêm o comportamento atual até uma data posterior, que será anunciada separadamente pela Application Integration.

Observação: editar uma integração não muda o estágio dela, e uma subintegração é executada no próprio estágio, não no estágio da integração que a chama. As seguintes condições não dependem do estágio:

• As verificações de usuário da conta de serviço se aplicam a todas as integrações, independentemente da data de criação.
• Todos os testes usam o novo comportamento, incluindo os iniciados no console do Google Cloud e os de integrações criadas antes de 15 de outubro de 2026.

O que fazer

Faça essas mudanças agora, seja qual for o estágio das suas integrações. Elas entram em vigor assim que são feitas.

1. Encontrar integrações que precisam de uma conta de serviço de execução: integrações que são executadas de forma assíncrona, em uma programação ou de um evento e não têm uma.
2. Conceda o papel de Usuário da conta de serviço em cada conta de serviço de execução e em cada conta de serviço do perfil de autenticação a todos que executam, testam, publicam ou aprovam a integração, bem como às contas de serviço usadas pelos gatilhos e pela automação.
3. Defina uma conta de serviço de execução em cada integração encontrada e publique-a.

Aviso: conclua a etapa 2 antes da etapa 3. Para publicar uma integração com uma conta de serviço de execução, é necessário ter o papel de usuário da conta de serviço nessa conta. Portanto, se você definir a conta de serviço primeiro, a publicação poderá ser rejeitada.

Testar o novo comportamento antes que ele seja aplicado

As integrações criadas a partir de 15 de outubro de 2026 já usam o novo comportamento. Suas integrações atuais vão manter o comportamento atual até uma data posterior, mas você não precisa esperar para descobrir como elas serão afetadas. Há duas maneiras de testar a mudança enquanto você ainda controla o tempo.

Ativar credenciais de usuário final para uma região

Isso aplica o novo comportamento a todas as integrações em uma região.

1. No console do Google Cloud , acesse as configurações da região.
2. Ative a opção Executar integrações com credenciais de usuário final.
3. Salve as configurações.

As tarefas nessa região chamam serviços downstream como o usuário que acionou a integração, em vez de uma identidade de plataforma compartilhada. As execuções sem um usuário acionador recorrem a uma identidade que não tem permissões.

Aviso: essa configuração se aplica a todas as integrações na região, incluindo as criadas antes de 15 de outubro de 2026. Uma tarefa que toca em um recurso que o usuário acionador não pode acessar começa a falhar com um erro de permissão. Siga as instruções em O que fazer primeiro e, em seguida, ative a configuração.

Testar uma única integração de forma assíncrona

Se você preferir testar uma integração em vez de uma região inteira, execute-a de forma assíncrona no painel de teste. Isso usa o mesmo caminho de credencial de uma execução programada ou orientada por eventos, sem alterar nenhuma configuração.

1. Abra a integração e clique em Testar integração.
2. Em Modo de execução, ative Executar de maneira assíncrona.
3. Insira os valores de entrada e execute o teste.

A execução é colocada na fila da mesma forma que um gatilho real é acionado, sem credenciais do autor da chamada. Assim, ela exercita o caminho de credencial que um gatilho programado ou de evento usaria. O teste executa a versão que você abriu com as entradas inseridas e informa um ID de execução em vez da saída.

Observação: se algum valor de configuração for diferente da versão salva, a execução será recusada e nada será colocado na fila. Salve a integração antes de testá-la de forma assíncrona.

Se algo falhar após a mudança, consulte Resolver problemas de erros de autorização.