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

Antes de poder utilizar conexiones, asegúrate de que se cumplen las siguientes condiciones:

• Integration Service está habilitado y aprovisionado para tu tenant.
• Los usuarios que trabajan con conexiones tienen los permisos necesarios en Orchestrator. Para crear una conexión, un usuario debe tener el permiso Conexiones - Crear en la carpeta de destino. Para obtener más información sobre los permisos, consulta Configurar el acceso para las cuentas en la guía del usuario de Orchestrator.

Conexiones en Orchestrator

Importante:

A partir de marzo de 2026, puedes crear nuevas conexiones de Integration Service en Orchestrator. Las conexiones de Integration Service existentes seguirán siendo visibles en la pestaña Conexiones de Integration Service hasta julio de 2026 (esta fecha está sujeta a posibles extensiones). Después de esta fecha, las conexiones de Integration Service existentes se migrarán a Orchestrator y se eliminará la pestaña Conexiones en Integration Service. Este cambio está programado para estar disponible primero para los usuarios de Community y luego para los usuarios de Enterprise de forma progresiva, dependiendo de las regiones de la organización y el tenant. Sigue las notas de la versión de Integration Service para saber cuándo se anuncia el cambio por primera vez.

Ventajas clave de gestionar las conexiones en 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

La pestaña Conexiones en Orchestrator proporciona una ubicación central para crear y gestionar conexiones. También puedes crear conexiones directamente desde automatizaciones en UiPath Studio, UiPath Studio Web o UiPath Assistant.

Para crear una conexión en Orchestrator, sigue estos pasos:

1. Selecciona Orchestrator en el lanzador de productos.
2. Selecciona una carpeta y luego navega a la pestaña Conexiones .
3. Selecciona Añadir conexión.
4. Para abrir la página de creación de conexiones, selecciona el conector de la lista. Puedes utilizar la barra de búsqueda para encontrar el conector.
5. Selecciona el tipo de autenticación (si corresponde), introduce las credenciales necesarias y luego selecciona Conectar.

Para obtener más información, consulta Gestionar conexiones en la guía del usuario de Orchestrator.

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

Algunos conectores de Integration Service admiten varios tipos de autenticación. El tipo se selecciona al crear la conexión. Las opciones disponibles pueden incluir:

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

Las opciones disponibles varían en función del conector.

Gestionar conexiones

Puedes gestionar todas las conexiones en un solo lugar desde la pestaña Conexiones en Orchestrator. Aquí es donde puedes comprobar el estado de las conexiones, volver a conectar, gestionar desencadenadores, editar detalles de conexión como el nombre y el intervalo de sondeo, y eliminar conexiones.

Para obtener más información, consulta Gestionar conexiones en la guía del usuario de Orchestrator.

Gestionar conexiones desde 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 ofrece un modelo Trae tu propia aplicación Oauth 2.0 (BYOA) que permite a las empresas conectarse utilizando sus propias aplicaciones OAuth 2.0 en lugar de la aplicación OAuth pública registrada por UiPath.

UiPath registra y mantiene las aplicaciones OAuth 2.0 en los portales de desarrolladores de proveedores para la mayoría de los conectores (por ejemplo, Microsoft, Google, Salesforce, Atlassian Jira, etc.). En la mayoría de los casos, estas aplicaciones vienen con ámbitos predefinidos y son gestionadas completamente por UiPath.

Sin embargo, algunas organizaciones pueden tener políticas estrictas de TI, seguridad o cumplimiento que les impiden utilizar registros de aplicaciones externas. En tales casos, BYOA permite a los clientes utilizar su propio ID de cliente y Secreto de cliente para autenticar y autorizar las conexiones de Integration Service.

Escenarios comunes sobre cuándo utilizar BYOA

Utiliza BYOA cuando:

• La aplicación admite el tipo de autenticación de concesión de código de autorización OAuth2.0. No se pueden utilizar otros tipos de OAuth2.0 en BYOA.
• Su empresa requiere que todas las integraciones de terceros utilicen aplicaciones OAuth administradas internamente.
• Debes añadir o modificar ámbitos que no forman parte de la aplicación registrada predeterminada de UiPath.
• Las políticas de seguridad o cumplimiento de su organización prohíben el uso compartido de aplicaciones.
• Deseas controlar el ciclo de vida de la aplicación OAuth, incluida la rotación de secretos.

Nota:

Las aplicaciones OAuth públicas de UiPath utilizan ámbitos fijos y no se pueden modificar a petición del cliente. Si necesitas ámbitos adicionales, BYOA es la opción correcta.

Cómo funciona BYOA

Al crear una conexión en Integration Service, puedes seleccionar Traer tu propia aplicación Oauth2 como tipo de autenticación.

Esto te permite introducir:

• ID de cliente y Secreto de cliente : credenciales obtenidas del registro de tu aplicación en el portal de desarrolladores del proveedor.
• Ámbitos : permisos requeridos por el conector.
• URI de redirección : URL de devolución de llamada no editable (https://cloud.uipath.com/provisioning_/callback para Automation Cloud). Esta es la URL de devolución de llamada que Integration Service utiliza para completar el flujo OAuth.

Integration Service utiliza tus credenciales para realizar el flujo OAuth y almacena de forma segura los tokens de acceso y actualización resultantes.

Configurar una conexión BYOA

Paso 1: registrar una aplicación OAuth en el portal del proveedor

Crea una aplicación OAuth 2.0 en el portal de desarrolladores del proveedor (por ejemplo, Salesforce, Microsoft, Jira o Google). Durante el registro:

• Establece el URI de redirección/devolución de llamada en https://cloud.uipath.com/provisioning_/callback.
• Añade los ámbitos necesarios (consulta la documentación específica del conector para conocer los ámbitos obligatorios).
• Asegúrate de que el proveedor admita el tipo de concesión requerido por el conector (Concesión de código de autorización).

Paso 2: crear una conexión en Integration Service

1. Ve a Integration Service > Conectores, selecciona el conector deseado y luego haz clic en Conectar.

2. Selecciona el tipo de autenticación Trae tu propia aplicación OAuth2 2.0.

3. Introduce los siguientes detalles de tu aplicación registrada:

   • ID de cliente
   • Secreto de cliente
   • Ámbitos (seleccione uno de los existentes o escríbalos manualmente)
   Nota:

   Muchos proveedores (Atlassian Jira, Coupa, etc.) esperan que los mismos ámbitos estén presentes en tu aplicación.

4. Sigue las instrucciones en pantalla para completar el flujo de consentimiento OAuth proporcionando tu nombre de usuario y contraseña en la página de inicio de sesión del proveedor.

5. Una vez autorizada, la conexión se almacena de forma segura y está disponible para su uso.

6. Integration Service se encarga de actualizar periódicamente el token de acceso.

Paso 3: Verificar los ámbitos obligatorios

Cada conector tiene ámbitos obligatorios necesarios para sus actividades y desencadenadores.

Si tu aplicación BYOA no incluye estos ámbitos, la creación de la conexión fallará o ciertas acciones pueden no funcionar como se espera.

Consulta la documentación del conector para confirmar la lista de ámbitos obligatorios.

Mejores prácticas

• Utilizar un registro de aplicación empresarial dedicado para UiPath Integration Service; evita reutilizar ID de aplicaciones de integraciones no relacionadas.
• Incluye solo los ámbitos necesarios para el acceso con privilegios mínimos.
• Mantén los secretos de cliente rotados periódicamente y actualízalos en Integration Service editando las conexiones.
• Documente la propiedad de la aplicación y garantice la continuidad si cambian los administradores.
• Verifique que los URI de redirección coincidan exactamente con el valor mostrado en Integration Service; los URI no coincidentes causan errores de OAuth.

Seguridad y mantenimiento

• Las credenciales BYOA se cifran y almacenan de forma segura en UiPath Integration Service y nunca se exponen en texto sin formato.
• UiPath no gestiona ni supervisa tus credenciales o ámbitos de aplicación personalizados.
• La rotación de secretos, la cancelación del registro de la aplicación o el mantenimiento del ámbito son responsabilidad del cliente.

Problemas comunes

La siguiente tabla enumera los problemas comunes encontrados al utilizar conexiones BYOA, junto con sus posibles causas y resoluciones.

Incidencia	Posible causa	Resolución
Cliente o secreto no válido	ID de cliente o secreto incorrectos.	Verifique las credenciales del registro de la aplicación del proveedor.
Error de coincidencia de URI de redirección	El URI de redirección en la aplicación del proveedor no coincide con el valor de UiPath.	Actualiza el URI de redirección en el registro de la aplicación del proveedor.
Ámbitos insuficientes o acceso denegado	Faltan ámbitos obligatorios en la aplicación del proveedor.	Añada los ámbitos necesarios y vuelva a autorizar.
El token caduca con frecuencia	Aplicación del proveedor configurada con tokens de corta duración.	Habilite los tokens de actualización en la aplicación o amplíe la validez del token.

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.

Solución de problemas de conexión

Para obtener información sobre cómo solucionar problemas comunes que puedes encontrar al utilizar la conexión, consulta Solución de problemas de conexión.