Conexiones

Sobre las conexiones

Las conexiones ayudan a establecer tareas entre usuarios únicos y aplicaciones externas. Las conexiones se crean una vez que los usuarios se autentifican con un proveedor de API.

Requisitos previos

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.

Conexiones en 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

Este movimiento aporta varias ventajas clave:

• Menos cambios de contexto

  Ahora puedes crear activos, colas, desencadenadores y conexiones en un solo lugar, sin tener que navegar a otro menú de la izquierda. Menos clics, menos cargas de página y una menor carga cognitiva conducen a un flujo de trabajo más fluido.

• Solución de problemas más fácil

  Cuando las ejecuciones fallan, ya estás en Orchestrator revisando trabajos, colas o registros. Ahora puedes ver y gestionar la conexión relacionada en la misma interfaz, lo que reduce el tiempo de resolución.

• Un modelo mental coherente

  Orchestrator ya centraliza tus recursos. Gestionar las conexiones junto con los activos y desencadenadores garantiza una experiencia más intuitiva y coherente.

Conexiones compartidas

Cuando se crea una conexión en una carpeta compartida, todos los usuarios con acceso a esa carpeta pueden utilizar la conexión en sus flujos de trabajo de automatización. La conexión puede ser editada por todos los usuarios con acceso a ella.

Recomendamos crear conexiones para las que la autenticación se realice a través de cuentas personales en Espacios de trabajo personales, y solo utilizar carpetas compartidas para conexiones en las que la autenticación se realice a través de cuentas de servicio. Los administradores pueden evitar que los usuarios normales creen conexiones compartidas de Integration Service en las carpetas del equipo. Para obtener más información, consulta Aplicar el control de la conexión de Integration Service a nivel de usuario en la guía del usuario de Orchestrator.

Nota:

Todos los conectores de Integration Service admiten el uso compartido de conexiones y la configuración en tiempo de ejecución. Para obtener más información sobre la configuración de las conexiones en tiempo de ejecución, consulta la Guía del usuario de Orchestrator.

Crear una conexión

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. Selecciona Añadir conexión.
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.

Nota:

Para crear una conexión correctamente, debes configurar una lista de direcciones IP permitidas para Integration Service. Para obtener más información, consulta Configurar el cortafuegos en la Guía de administración de Automation Cloud.

Seleccionar el tipo de autenticación

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

• Código de autorización OAuth 2.0
• Contraseña OAuth 2.0
• Traiga su propia aplicación OAuth 2.0
• Token de acceso personal (PAT)

Nota:

Available options vary depending on the connector.

Gestionar conexiones

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

Puedes gestionar las conexiones de Integration Service directamente desde UiPath Assistant. Para obtener más información, consulta Conexiones en UiPath Assistant.

Selecciona Configurar en el navegador para abrir la página Conexiones en Studio Web. Para obtener más información, consulta Gestionar conexiones en la guía del usuario de Studio Web.

Nota:

Los usuarios del sector público de Automation Cloud pueden ver las conexiones en UiPath Assistant, pero no gestionarlas. En su lugar, pueden configurar y gestionar las conexiones de Integration Service utilizando la pestaña Requisitos del paquete en Orchestrator.

Traiga su propia aplicación 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.

Nota:

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 de cliente
   • Secreto de cliente
   • Scopes (select from existing or type them manually)
   Nota:

   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.

Mejores prácticas

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

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

Incidencia	Posible causa	Resolución
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.

Conexiones en Soluciones

Puedes gestionar las conexiones y los desencadenadores de eventos como parte de tu paquete de soluciones. Consulta Información general sobre la gestión de soluciones para saber qué son los paquetes de soluciones, cómo funcionan y cómo crearlos, gestionarlos e implementarlos.

Al crear un paquete de soluciones, las conexiones y sus desencadenadores de eventos asociados están disponibles en el panel Componentes . Puedes editar las siguientes propiedades: Nombre de la conexión, Descripción de la conexión y Tipo de autenticación. Para los desencadenadores de eventos, puedes realizar los mismos pasos de configuración que en Orchestrator.

Nota:

También puedes editar estos campos en el momento de la implementación, a menos que estén bloqueados para su edición.

Una vez creada y publicada la solución, las conexiones están disponibles en el panel Componentes de la solución. Ahora se pueden implementar todas las conexiones seleccionadas al crear el paquete de soluciones.

La gestión de soluciones no muestra las conexiones para los procesos a menos que también esté conectado un desencadenador de eventos. El problema puede afectar a la implementación de la solución, requiriendo la configuración manual de la conexión para un funcionamiento adecuado.

Puedes elegir implementar el paquete de solución en una carpeta específica que aún no existe en Integration Service. En este caso, la carpeta se crea automáticamente.

Tipo de autenticación de conexión

Como administrador, decides durante la implementación si utilizar una conexión existente, crear una nueva o permitir que el usuario final seleccione la conexión.

Nota:

Solutions mueve las conexiones y sus relaciones de entidad asociadas (como los flujos de trabajo y los procesos a los que pertenece la conexión), pero no transfiere las credenciales de autenticación.

Durante la implementación, el administrador puede establecer el tipo de autenticación como:

• Configurable por los usuarios: no se crean ni se utilizan conexiones a partir de las existentes. Se espera que los usuarios configuren la conexión después de implementar la solución en tiempo de ejecución. Consulta Configurar conexiones en la documentación de Orchestrator.

• Autenticar después de la implementación: se crea una nueva conexión y requiere autenticación después de la implementación. La conexión permanece inactiva hasta que se completa el paso de autenticación.

  • Antes de que se complete la autenticación, el nombre de usuario se muestra como System. Una vez que la autenticación se realiza correctamente, el nombre de usuario se actualiza para mostrar las credenciales del autenticador.

También tienes la opción de vincular componentes. Al seleccionar Vincular a existente, una ventana emergente muestra todas las conexiones accesibles para el usuario que implementa el paquete de soluciones. Puedes elegir cualquier conexión existente para que forme parte del paquete de soluciones.

Nota:

Si seleccionas las conexiones existentes para los conectores incluidos en el paquete de soluciones, y también seleccionas una nueva carpeta durante la implementación, la carpeta se crea en Integration Service, sin conexiones en ella. Utilice esta carpeta si se modifican las preferencias o se añaden nuevas conexiones.

La opción Vincular a existente no está disponible cuando se edita una configuración utilizando los siguientes métodos: Configuración de implementación o Editar configuración de implementación. Para vincular componentes o editar el Tipo de autenticación después de la implementación, debes actualizar el paquete de soluciones. Esto requiere editar la solución y volver a implementar la nueva versión.

Las conexiones creadas en cualquier carpeta a través de Soluciones no se eliminan, incluso al actualizar el flujo de trabajo para utilizar conexiones diferentes. Esto garantiza que los procesos y automatizaciones que dependen de estas conexiones no se vean afectados por la actualización.

Troubleshooting connection issues

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