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

Before you can use connections, make sure the following conditions are met:

• Integration Service is enabled and provisioned for your tenant.
• Users who work with connections have the necessary permissions in Orchestrator. To create a connection, a user must have the Connections - Create permission in the target folder. For more information on permissions, see Configuring access for accounts in the Orchestrator user guide.

Conexões no Orchestrator

Importante:

Starting with March 2026, you can create new Integration Service connections 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

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

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. Selecione Adicionar conexão.
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

UiPath Integration Service offers a Bring your own Oauth2.0 app (BYOA) model that allows enterprises to connect using their own OAuth 2.0 applications instead of the default UiPath-registered public OAuth app.

UiPath registers and maintains OAuth 2.0 apps on vendor developer portals for the majority of connectors (for example, Microsoft, Google, Salesforce, Atlassian Jira, etc.). In most cases, these apps come with predefined scopes and are managed entirely by UiPath.

However, some organizations may have strict IT, security, or compliance policies that prevent them from using external app registrations. In such cases, BYOA enables customers to use their own Client ID and Client Secret to authenticate and authorize Integration Service connections.

Common scenarios for when to use BYOA

Use BYOA when:

• The application supports the OAuth2.0 Authorization code grant authentication type. Other OAuth2.0 types cannot be used under BYOA.
• Your enterprise requires that all third-party integrations use internally managed OAuth apps.
• You need to add or modify scopes that are not part of UiPath's default registered app.
• Your organization's security or compliance policies prohibit shared app usage.
• You want to control the OAuth app lifecycle, including rotation of secrets.

Observação:

UiPath's public OAuth apps use fixed scopes and cannot be modified per customer request. If you require additional scopes, BYOA is the correct option.

How BYOA works

When creating a connection in Integration Service, you can select Bring your own Oauth2 app as the authentication type.

This allows you to enter:

• Client ID and Client Secret - Credentials obtained from your app registration in the vendor's developer portal.
• Scopes - Permissions required by the connector.
• Redirect URI - Non-editable callback URL (https://cloud.uipath.com/provisioning_/callback for Automation Cloud). This is the callback URL that Integration Service uses to complete the OAuth flow.

Integration Service uses your credentials to perform the OAuth flow and securely stores the resulting access and refresh tokens.

Configuring a BYOA connection

Step 1: Register an OAuth App on the vendor portal

Create an OAuth 2.0 app in the vendor's developer portal (for example, Salesforce, Microsoft, Jira or Google). During registration:

• Set the redirect/callback URI to https://cloud.uipath.com/provisioning_/callback.
• Add the required scopes (see connector-specific documentation for mandatory scopes).
• Ensure the vendor supports the grant type required by the connector (Authorization Code Grant).

Step 2: Create a connection in Integration Service

1. Navigate to Integration Service > Connectors, select the desired connector, and then click Connect.

2. Select the authentication type Bring Your Own OAuth2 2.0 app.

3. Enter the following details from your registered app:

   • ID do Cliente
   • Segredo do Cliente
   • Scopes (select from existing or type them manually)
   Observação:

   Many vendors (Atlassian Jira, Coupa, etc.) expect the same scopes are present in your app as well.

4. Follow the on-screen prompts to complete the OAuth consent flow by providing your username and password on the vendor's login page.

5. Once authorized, the connection is securely stored and available to be used.

6. Integration service takes care of periodically refreshing the access token.

Step 3: Verify mandatory scopes

Each connector has mandatory scopes required for its activities and triggers.

If your BYOA app does not include these scopes, connection creation will fail, or certain actions may not work as expected.

Refer to the connector's documentation to confirm the list of mandatory scopes.

Melhores práticas

• Use a dedicated enterprise app registration for UiPath Integration Service; avoid reusing app IDs from unrelated integrations.
• Include only the necessary scopes for least-privilege access.
• Keep client secrets rotated periodically and update them in Integration Service by editing connections.
• Document app ownership and ensure continuity if admins change.
• Verify redirect URIs exactly match the value displayed in Integration Service; mismatched URIs cause OAuth errors.

Security and maintenance

• BYOA credentials are encrypted and stored securely in UiPath Integration Service and never exposed in plain text.
• UiPath does not manage or monitor your custom app credentials or scopes.
• Secret rotation, app de-registration, or scope maintenance are the customer's responsibility.

Problemas comuns

The following table lists common issues encountered when using BYOA connections, along with their possible causes and resolutions.

Issue	Possível causa	Resolution
Invalid client or secret	Wrong client ID or secret.	Verify credentials from the vendor app registration.
Redirect URI mismatch	The redirect URI in the vendor app does not match UiPath's value.	Update the redirect URI in the vendor app registration.
Insufficient scopes or Access denied	Missing mandatory scopes in vendor app.	Add required scopes and reauthorize.
Token expiring frequently	Vendor app configured with short-lived tokens.	Enable refresh tokens in the app or extend token validity.

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.

Troubleshooting connection issues

For information on how to fix common issues you might encounter when using connection, see Connections troubleshooting.