Conexões

Sobre conexões

As conexões ajudam a estabelecer tarefas entre usuários únicos e aplicativos externos. As conexões são criadas após os usuários se autenticarem com um provedor de API.

Pré-requisitos

Antes de poder usar conexões, certifique-se de que as seguintes condições sejam atendidas:

• O Integration Service é habilitado e provisionado para seu tenant.
• Os usuários que trabalham com conexões têm as permissões necessárias no Orchestrator. Para criar uma conexão, um usuário deve ter a permissão Conexões - Criar na pasta de destino. Para obter mais informações sobre permissões, consulte Configuração de acesso para contas no guia do usuário do Orchestrator.

Conexões no Orchestrator

Importante:

A partir de março de 2026, você pode criar novas conexões do Integration Service no Orchestrator. As conexões existentes do Integration Service continuarão visíveis na guia Conexões do Integration Service até julho de 2026 (essa data está sujeita a possíveis extensões). Após essa data, as conexões existentes do Integration Service serão migradas para o Orchestrator, e a aba Conexões no Integration Service será removida. Essa alteração é programada para ficar disponível primeiro para os usuários Community e, em seguida, para os usuários Enterprise progressivamente, dependendo da organização e das regiões do tenant. Siga as notas de versão do Integration Service para saber quando a alteração é anunciada pela primeira vez.

Principais benefícios do gerenciamento de conexões no Orchestrator

Essa mudança traz várias vantagens importantes:

• Menos troca de contexto

  Agora você pode criar ativos, filas, gatilhos e conexões, tudo em um só lugar, sem navegar para outro menu à esquerda. Menos cliques, menos carregamentos de páginas e menor carga cognitiva resultam em um fluxo de trabalho mais tranquilo.

• Solução de problemas mais fácil

  Quando as execuções falham, você já está no Orchestrator revisando trabalhos, filas ou logs. Agora você pode visualizar e gerenciar a conexão relacionada na mesma interface, reduzindo o tempo de resolução.

• Um modelo mensal consistente

  O Orchestrator já centraliza seus recursos. O gerenciamento de conexões ao lado de ativos e gatilhos garante uma experiência mais intuitiva e coesa.

Conexões compartilhadas

Quando uma conexão é criada em uma pasta compartilhada, todos os usuários com acesso a essa pasta podem usar a conexão em seus fluxos de trabalho de automação. A conexão pode ser editada por todos os usuários com acesso a ela.

Recomendamos criar conexões para as quais a autenticação é feita por meio de contas pessoais em Espaços de trabalho pessoais e apenas usar pastas compartilhadas para conexões em que a autenticação é feita por meio de contas de serviço. Os administradores podem impedir que usuários regulares criem conexões compartilhadas do Integration Service em pastas da equipe. Para obter mais informações, consulte Imposição da governança de conexão do Integration Service em nível de usuário no guia do usuário do Orchestrator.

Observação:

Todos os conectores do Integration Service são compatíveis com o compartilhamento e a configuração no tempo de execução. Para obter mais informações sobre como configurar conexões no tempo de execução, consulte o Guia do usuário do Orchestrator.

Criando uma conexão

A guia Conexões no Orchestrator fornece um local central para criar e gerenciar conexões. Você também pode criar conexões diretamente a partir de automações no UiPath Studio, UiPath Studio Web ou UiPath Assistant.

Para criar uma conexão no Orchestrator, siga estas etapas:

1. Selecione Orchestrator no inicializador do produto.
2. Selecione uma pasta e navegue até a aba Conexões .
3. Selecione Adicionar conexão.
4. Para abrir a página de criação de conexão, selecione o conector na lista. Você pode usar a barra de pesquisa para encontrar o conector.
5. Selecione o tipo de autenticação (se aplicável), insira as credenciais necessárias e selecione Conectar.

Para obter mais detalhes, consulte Gerenciamento de conexões no guia do usuário do Orchestrator.

Observação:

Para criar uma conexão com sucesso, você deve configurar uma lista de permissão de endereços IP para o Integration Service. Para obter mais informações, consulte Configuração do firewall no Guia do administrador do Automation Cloud.

Selecionando o tipo de autenticação

Alguns conectores do Integration Service são compatíveis com vários tipos de autenticação. Você seleciona o tipo ao criar a conexão. As opções disponíveis podem incluir:

• Código de autorização do OAuth 2.0
• Senha do OAuth 2.0
• Traga seu próprio aplicativo OAuth 2.0
• Token de acesso pessoal (PAT)

Observação:

As opções disponíveis variam dependendo do conector.

Como gerenciar conexões

Você pode gerenciar todas as conexões em um só lugar na guia Conexões no Orchestrator. É aqui que você pode verificar a integridade das conexões, reconectar, gerenciar gatilhos, editar detalhes da conexão, como o nome e o intervalo de pesquisa e excluir conexões.

Para obter mais detalhes, consulte Gerenciamento de conexões no guia do usuário do Orchestrator.

Gerenciamento de conexões a partir do UiPath Assistant

Você pode gerenciar conexões do Integration Service diretamente no UiPath Assistant. Para saber mais, consulte Conexões no UiPath Assistant.

Selecione Configurar no navegador para abrir a página Conexões no Studio Web. Para saber mais, consulte Gerenciamento de conexões no guia do usuário do Studio Web.

Observação:

Os usuários da Automation Cloud para o Setor Público podem visualizar conexões no UiPath Assistant, mas não gerenciá-las. Em vez disso, eles podem configurar e gerenciar conexões do Integration Service usando a aba Requisitos de pacote no Orchestrator.

Traga seu próprio aplicativo OAuth 2.0

O UiPath Integration Service oferece um modelo de traga seu próprio aplicativo Oauth2.0 (BYOA) , que permite que as empresas se conectem usando seus próprios aplicativos OAuth 2.0 em vez do aplicativo público OAuth registrado pela UiPath.

A UiPath registra e mantém aplicativos OAuth 2.0 em portais de desenvolvedores de fornecedores para a maioria dos conectores (por exemplo, Microsoft, Google, Salesforce, Atlassian Jira etc.). Na maioria dos casos, esses aplicativos vêm com escopos predefinidos e são gerenciados totalmente pela UiPath.

No entanto, algumas organizações podem ter políticas rigorosas de TI, segurança ou conformidade que as impedem de usar registros de aplicativos externos. Nesses casos, a BYOA permite que os clientes usem seu próprio ID do cliente e Segredo do cliente para autenticar e autorizar conexões do Integration Service.

Cenários comuns de quando usar BYOA

Use o BYOA quando:

• O aplicativo é compatível com o tipo de autenticação de concessão de código de autorização OAuth2.0. Outros tipos de OAuth2.0 não podem ser usados em BYOA.
• Sua empresa exige que todas as integrações de terceiros usem aplicativos OAuth gerenciados internamente.
• Você precisa adicionar ou modificar escopos que não fazem parte do aplicativo registrado padrão do UiPath.
• As políticas de segurança ou conformidade da sua organização proíbem o uso de aplicativos compartilhados.
• Você deseja controlar o ciclo de vida do aplicativo OAuth, incluindo a rotação de segredos.

Observação:

Os aplicativos OAuth públicos da UiPath usam escopos fixos e não podem ser modificados por solicitação do cliente. Se você precisar de escopos adicionais, BYOA é a opção correta.

Como a BYOA funciona

Ao criar uma conexão no Integration Service, você pode selecionar Trazer seu próprio aplicativo Oauth2 como o tipo de autenticação.

Isso permite que você insira:

• ID do cliente e Segredo do cliente - Credenciais obtidas a partir do registro do seu aplicativo no portal do desenvolvedor do fornecedor.
• Escopos - Permissões exigidas pelo conector.
• URI de redirecionamento – URL de retorno de chamada não editável (https://cloud.uipath.com/provisioning_/callback para Automation Cloud). Essa é a URL de retorno de chamada que o Integration Service usa para concluir o fluxo do OAuth.

O Integration Service usa suas credenciais para executar o fluxo do OAuth e armazena com segurança os tokens de acesso resultantes e atualização.

Configurando uma conexão BYOA

Etapa 1: registrar um aplicativo OAuth no portal do fornecedor

Crie um aplicativo OAuth 2.0 no portal do desenvolvedor do fornecedor (por exemplo, Salesforce, Microsoft, Jira ou Google). Durante o registro:

• Defina o URI de redirecionamento/retorno de chamada como https://cloud.uipath.com/provisioning_/callback.
• Adicione os escopos necessários . Consulte a documentação específica do conector para escopos obrigatórios.
• Certifique-se de que o fornecedor ofereça suporte ao tipo de concessão exigido pelo conector (Concessão de código de autorização).

Etapa 2: criar uma conexão no Integration Service

1. Navegue até Integration Service > Conectores, selecione o conector desejado e clique em Conectar.

2. Selecione o tipo de autenticação Traga seu próprio aplicativo OAuth2 2.0.

3. Insira os seguintes detalhes do aplicativo registrado:

   • ID do Cliente
   • Segredo do Cliente
   • Escopos (selecione entre os existentes ou os digite manualmente)
   Observação:

   Muitos fornecedores (Atlassian Jira, Coupa etc.) esperam que os mesmos escopos também estejam presentes em seu aplicativo.

4. Siga as solicitações na tela para concluir o fluxo de consentimento do OAuth fornecendo seu nome de usuário e senha na página de login do fornecedor.

5. Após a autorização, a conexão será armazenada com segurança e estará disponível para uso.

6. O Integration Service se encarrega de atualizar periodicamente o token de acesso.

Etapa 3: verificar escopos obrigatórios

Cada conector tem escopos obrigatórios necessários para suas atividades e gatilhos.

Se seu aplicativo BYOA não incluir esses escopos, a criação da conexão falhará ou certas ações podem não funcionar conforme o esperado.

Consulte a documentação do conector para confirmar a lista de escopos obrigatórios.

Melhores práticas

• Usar um registro de aplicativo empresarial dedicado para o UiPath Integration Service; evite reutilizar IDs de aplicativos de integrações não relacionadas.
• Inclua apenas os escopos necessários para acesso com privilégio mínimo.
• Mantenha os segredos do cliente rotacionados periodicamente e atualize-os no Integration Service editando conexões.
• Documente a propriedade do aplicativo e garanta a continuidade se os administradores mudarem.
• Verifique se os URIs de redirecionamento correspondem exatamente ao valor exibido no Integration Service; URIs incompatíveis causam erros de OAuth.

Segurança e manutenção

• As credenciais da BYOA são criptografadas e armazenadas com segurança no UiPath Integration Service e nunca são expostas em texto simples.
• A UiPath não gerencia nem monitora suas credenciais ou escopos de aplicativos personalizados.
• A rotação de segredo, cancelamento de registro de aplicativo ou manutenção de escopo são de responsabilidade do cliente.

Problemas comuns

A tabela a seguir lista problemas comuns encontrados ao usar conexões BYOA, juntamente com suas possíveis causas e resoluções.

Issue	Possível causa	Resolution
Segredo ou cliente inválido	Segredo ou ID do cliente incorreto.	Verifique as credenciais do registro de aplicativo do fornecedor.
Incompatibilidade de URI de redirecionamento	O URI de redirecionamento no aplicativo de fornecedor não corresponde ao valor da UiPath.	Atualize o URI de redirecionamento no registro de aplicativo do fornecedor.
Escopos insuficientes ou acesso negado	Escopos obrigatórios ausentes no aplicativo do fornecedor.	Adicione os escopos necessários e reautorize.
Token expirando com frequência	Aplicativo do fornecedor configurado com tokens de vida curta.	Habilite os tokens de atualização no aplicativo ou estenda a validade dos tokens.

Conexões em Soluções

Você pode gerenciar conexões e gatilhos de eventos como parte do seu pacote de solução. Consulte Visão geral do gerenciamento de soluções para saber o que são pacotes de soluções, como funcionam e como criar, gerenciar e implantá-los.

Quando você cria um pacote de solução, as conexões e seus gatilhos de eventos associados ficam disponíveis no painel Componentes . Você pode editar as seguintes propriedades: Nome da conexão, Descrição da conexão e Tipo de autenticação. Para gatilhos de eventos, você pode executar as mesmas etapas de configuração que no Orchestrator.

Observação:

Você também pode editar esses campos no momento da implantação, a menos que eles estejam bloqueados para edição.

Após a solução ser criada e publicada, as conexões ficam disponíveis no painel Componentes da solução. Todas as conexões selecionadas ao criar o pacote da solução agora podem ser implantadas.

O Gerenciamento de soluções não exibe conexões para processos, a menos que um gatilho de evento também esteja conectado. O problema pode afetar a implantação da solução, exigindo configuração manual da conexão para a operação adequada.

Você pode optar por implantar o pacote de solução em uma pasta específica que ainda não existe no Integration Service. Nesse caso, a pasta é criada automaticamente.

Tipo de autenticação de conexão

Como administrador, você decide durante a implantação se deve usar uma conexão existente, criar uma nova ou permitir que o usuário final selecione a conexão.

Observação:

As soluções movem as conexões e suas relações de entidade associadas (como fluxos de trabalho e processos aos quais a conexão pertence), mas não transferem credenciais de autenticação.

Durante a implantação, o administrador pode definir o Tipo de autenticação como:

• Configurável por usuários: nenhuma conexão é criada ou usada a partir das existentes. Espera-se que os usuários configurem a conexão depois que a solução for implantada no runtime. Consulte Configuração de conexões na documentação do Orchestrator.

• Autenticar após a implantação ser concluída: uma nova conexão é criada e requer autenticação após a implantação. A conexão permanece inativa até que a etapa de autenticação seja concluída.

  • Antes que a autenticação seja concluída, o nome de usuário é exibido como System. Assim que a autenticação for bem-sucedida, o nome de usuário será atualizado para exibir as credenciais do autenticador.

Também há a opção de vincular componentes. Quando você seleciona Vincular à existente, uma janela pop-up exibe todas as conexões acessíveis ao usuário que implanta o pacote da solução. Você pode escolher qualquer conexão existente para fazer parte do pacote da solução.

Observação:

Se você selecionar conexões existentes para os conectores incluídos no pacote da solução e também selecionar uma nova pasta durante a implantação, a pasta será criada no Integration Service, sem conexões nela. Use essa pasta se as preferências forem modificadas ou se novas conexões forem adicionadas.

A opção Vincular a existente não está disponível ao editar uma configuração usando os seguintes métodos: Configuração da implantação ou Editar configuração da implantação. Para vincular componentes ou editar o tipo de autenticação após a implantação, você deve atualizar o pacote da solução. Isso requer editar a solução e implantar a nova versão novamente.

As conexões criadas em qualquer pasta por meio de Soluções não são excluídas, mesmo ao atualizar o fluxo de trabalho para usar conexões diferentes. Isso garante que os processos e automações que dependem dessas conexões não sejam impactados pela atualização.

Solução de problemas de conexão

Para obter informações sobre como corrigir problemas comuns que você pode encontrar ao usar a conexão, consulte Solução de problemas de conexões.