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.

Connections in Orchestrator

Importante:

Starting with March 2026, you can create new Integration Service connections only in Orchestrator. Existing Integration Service connections will continue to be visible on the Integration Service Connections tab until July 2026 (this date is subject to possible extensions). After this date, existing Integration Service connections will be migrated to Orchestrator, and the Connections tab in Integration Service will be removed. This change is scheduled to become available to Community users first, then to Enterprise users progressively, depending on organization and tenant regions. Follow the Integration Service release notes to learn when the change is first announced.

Key benefits of managing connections in Orchestrator

This move brings several key advantages:

• Less context-switching

  You can now create assets, queues, triggers, and connections all in one place, without navigating to another left-hand menu. Fewer clicks, fewer page loads, and lower cognitive load lead to a smoother workflow.

• Easier troubleshooting

  When runs fail, you are already in Orchestrator reviewing jobs, queues, or logs. You can now view and manage the related connection in the same interface, reducing time to resolution.

• A consistent mental model

  Orchestrator already centralizes your resources. Managing connections alongside assets and triggers ensures a more intuitive and cohesive experience.

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

The Connections tab in Orchestrator provides a central location for creating and managing connections. You can also create connections directly from automations in UiPath Studio, UiPath Studio Web, or UiPath Assistant.

To create a connection in Orchestrator, follow these steps:

1. Select Orchestrator from the product launcher.
2. Select a folder, and then navigate to the Connections tab.
3. Select Add connection.
4. To open the connection creation page, select the connector from the list. You can use the search bar to find the connector.
5. Select the authentication type (if applicable), enter the required credentials, and then select Connect.

For more details, refer to Managing connections in the Orchestrator user guide.

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

Some Integration Service connectors support multiple authentication types. You select the type when creating the connection. Available options can include:

• 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:

Available options vary depending on the connector.

Como gerenciar conexões

You can manage all connections in one place from the Connections tab in Orchestrator. This is where you can check the health of connections, reconnect, manage triggers, edit connection details such as the name and polling interval, and delete connections.

For more details, refer to Managing connections in the Orchestrator user guide.

Managing connections from 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

A experiência de autenticação permite que você use a opção Traga seu próprio aplicativo OAuth 2.0 (BYOA) para conectores que são compatíveis com o código de autorização OAuth 2.0. Isso permite que você selecione um aplicativo privado ao fazer a autenticação antes de fazer sua conexão.

Para criar uma conexão usando o método Traga seu próprio aplicativo OAuth 2.0 , você precisa das seguintes credenciais:

• ID do Cliente
• Segredo do cliente

Observação:

Se sua organização usar BYOA, você pode definir valores padrão para essas credenciais por meio de uma política de governança do Integration Service no Automation Ops. Para obter mais informações, consulte Configurações para políticas do Integration Service.

Quando você cria um aplicativo do OAuth privado com um terceiro, siga a documentação específica de terceiros para configurá-lo. Certifique-se de definir o URI de redirecionamento (ou URL de retorno de chamada) para seu aplicativo como: https://{baseURL}/provisioning_/callback.

Observação:

For OAuth 2.0 app connections, we encrypt and store the authentication token, but don't use it to access any client data.

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.