Solução de problemas de conexões

Soluções para erros comuns de conexão no Integration Service, incluindo credenciais inválidas, incompatibilidades de escopo e outras falhas de autenticação.

Esta página explica como corrigir problemas que você pode encontrar ao usar conexões.

Falha na solicitação do cliente: falha ao receber token de acesso

Description

Esse erro é causado por credenciais ou detalhes inválidos fornecidos pelo cliente.

Solução

Verifique se todas as credenciais preenchidas/dadas são válidas.

Falha ao criar a conexão. Feche esta guia do navegador e tente novamente

Description

Esse erro é causado por escopos ou permissões do aplicativo inválidos.

Solução

Verifique se todos os escopos/permissões são fornecidos conforme o esperado.

A conexão atualmente está inativa, clique em corrigir conexão

Description

É possível que uma conexão expire devido à expiração do token do OAuth ou a um problema de atualização.

Solução

Selecione Corrigir conexão e refaça o fluxo de criação de conexão. Para corrigir uma conexão, selecione o botão Mais correspondente à sua conexão no lado direito da interface e selecione Corrigir conexão.

Código de erro: 400 Mensagem: não é possível excluir a conexão com um ou mais gatilhos atribuídos

Description

Ao tentar excluir uma conexão, você pode encontrar a seguinte mensagem: Código de erro: 400 Mensagem: não é possível excluir a conexão com um ou mais gatilhos atribuídos.

Solução

Você não pode excluir a instância quando tem um gatilho habilitado nela. Exclua o gatilho antes de excluir a instância.

O usuário não tem permissões de Connections.View na pasta de conexão.

Description

As conexões no Integration Service parecem bem-sucedidas (Status: Conectado), mas os trabalhos não assistidos falham com a seguinte mensagem de erro: "O usuário não tem permissões de Connections.View na pasta de conexão."

Solução

O robô precisa de acesso à conexão usada no processo.

Para que um robô execute um trabalho usando um conector do Integration Service, são necessários os seguintes itens:

• A conexão e o robô destinados a executar o trabalho devem estar na mesma pasta do Orchestrator.
• O robô deve receber uma função que tenha permissões de Visualização de pasta para o item Conexões. Para obter mais informações, consulte o Guia do usuário do Orchestrator.

Restrições de rede

Às vezes, pode não ser possível criar conexões com aplicativos externos. Isso geralmente é causado por restrições de rede ou firewall, onde o aplicativo de destino bloqueia solicitações da Automation Cloud porque os IPs do Integration Service não estão na lista de permissões.

Siga estas etapas para verificar a conectividade e resolver esses problemas.

1. Certifique-se de que:

   • Você tem o ponto de extremidade do aplicativo (URL ou IP) que o Integration Service precisa acessar.
   • Você tem acesso ao seu firewall empresarial ou configurações de rede para listar intervalos de IPs, se necessário.

2. Verifique a acessibilidade do ponto de extremidade.

   Use um utilitário de rede simples para verificar se o ponto de extremidade do seu aplicativo é acessível pela Internet.

   Usando curl:

   curl -v https://<your-application-endpoint>

   Se a solicitação falhar, o ponto de extremidade não estará acessível publicamente ou o IP será bloqueado.

3. Adicione IPs do Integration Service à lista de permissões.

   Consulte a lista de intervalos de IP do UiPath Automation Cloud na documentação oficial e adicione intervalos de IP do Integration Service à lista de permissões de seu aplicativo ou firewall.

4. Tente criar a conexão novamente.

   Depois de confirmar a acessibilidade do endpoint e colocar os IPs na lista de permissões, tente criar a conexão novamente no Integration Service.

Usuários autenticados por SSO

Ao fazer login na UiPath Automation Cloud via SSO (por exemplo, Okta, Azure AD, Microsoft SSO, etc.), você pode encontrar problemas ao criar conexões com aplicativos externos que usam o mesmo provedor de SSO.

Esse problema ocorre porque o Integration Service usa automaticamente sua sessão SSO existente, o que pode fazer com que o aplicativo pule a etapa de login ou use a conta errada para criar a conexão.

Exemplo de cenário

O exemplo a seguir demonstra como a propagação de sessão SSO pode interferir na criação de conexão no Integration Service:

1. Login do UiPath SSO - Gerardo faz login no UiPath Automation Cloud usando sua conta corporativa do Okta [e-mail].
2. SSO do Aplicativo de Destino — Alice deseja criar uma conexão com o Workday REST, que também usa o SSO do Okta, conforme configurado pelo administrador da empresa.
3. Criação de conexão — Durante a configuração da conexão:
   • O navegador envia automaticamente seu token de sessão Okta existente.
   • O Workday supõe que o usuário de SSO é [e-mail] sem solicitar novamente o login.
4. O problema — se Alice pretendesse se conectar usando uma conta do Workday diferente, a conexão pode falhar ou os fluxos de trabalho podem ser executados com as permissões erradas.

Soluções alternativas recomendadas

Use uma sessão de navegador privada (anônima)

Abra a página de criação de conexão em uma janela privada/anônima. Isso impede que o navegador reutilize a sessão SSO do UiPath.

Então, o Workday solicitará credenciais de login explícitas sempre que uma conexão precisar ser criada.

Alterne para a conta pretendida antes da criação da conexão

1. Faça login no UiPath Automation Cloud via SSO.

   Acesse o Integration Service da forma habitual.

2. Faça login no Workday separadamente.

   Se o aplicativo tiver feito logon automaticamente usando sua sessão SSO atual, é possível que você veja uma conta padrão.

3. Faça logoff do Workday e faça logon com a conta pretendida para a criação de conexão.

   Isso garante que o aplicativo tenha a sessão de usuário correta.

4. Retorne ao Integration Service para criar a conexão.

   O Integration Service agora disparará o fluxo de conexão.

   A sessão de conta pretendida é usada para autorização, impedindo permissões erradas ou prompts de consentimento ignorados.