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.

Crear una conexión

1. Accede a Automation Suite.
2. En el menú de la izquierda, selecciona Integration Service. Las ventanas de Integration Service incluyen tres pestañas independientes: Conectores, Conexiones y Desencadenadores. De forma predeterminada, se selecciona la pestaña Conectores . Solo se muestran los conectores instalados en tu entorno local.

1. En la sección Mis carpetas puedes seleccionar si quieres trabajar en tu espacio de trabajo personal o en una carpeta compartida, donde las conexiones creadas pueden ser utilizadas por todos los usuarios que tienen acceso a esta carpeta.

2. Selecciona el conector deseado para crear una nueva conexión o actualizar una existente.
3. Selecciona Conectar a <connector name>. Dependiendo del conector que hayas elegido, se solicitarán las credenciales específicas necesarias para tus conexiones.

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.

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.

Modificar conexiones

1. En la barra izquierda, selecciona Integration Service. La ventana de Integration Service incluye tres pestañas independientes: Conectores, Conexiones y Desencadenadores.
2. Selecciona la carpeta en la que deseas modificar la conexión.
   Nota:

   La carpeta en la que quieres crear la conexión también puede seleccionarse después del paso 4.

3. Go to the Connections tab, where the list of created connections is displayed.
4. Selecciona el botón Más correspondiente a la conexión deseada para modificarla. Puedes realizar las siguientes acciones:
   • Eliminar la conexión.
   • Configúrela como predeterminada (esta opción solo está disponible si tiene varias conexiones establecidas para la misma aplicación.
   • Compruebe la conexión para verificar su estado.

Cambio de nombre de las conexiones

Para cambiar el nombre de una conexión, debe:

1. Access the Connections tab.
2. En el menú de la izquierda, selecciona Integration Service. La ventana de Integration Service incluye pestañas independientes para Conectores, Conexiones y Desencadenadores, junto con una ventana de navegación izquierda que muestra las carpetas.
3. Selecciona la carpeta en la que deseas modificar la conexión.
   Nota:

   La carpeta se puede seleccionar después del paso 4.

4. Go to the Connections tab, where the list of created connections is displayed.
5. Pasa el cursor del ratón sobre el nombre de la conexión que deseas modificar. Se mostrará el botón Editar .
   Nota:

   Alternatively, you can select your connection from the list to access the detailed view. The Edit button is located on the right side of your connection name.

6. Selecciona el botón Editar y podrás elegir un nuevo nombre para tu conexión.

Seleccionar el tipo de autenticación

Algunos conectores en Integration Service admiten varios métodos de autenticación. Puedes seleccionar tu método preferido antes de iniciar una conexión.

1. En Integration Service, en la lista Conectores , selecciona un conector compatible.
2. Selecciona Conectar a <connector name> para ir a la página de configuración de la conexión.
3. Utiliza el menú desplegable Carpeta en la que se almacena la conexión para elegir la carpeta adecuada (p. ej., Mi espacio de trabajo).
4. Utiliza el menú desplegable Tipo de autenticación para seleccionar entre las opciones disponibles, como:
   • 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 pueden variar dependiendo del conector.

5. Introduce las credenciales necesarias para tu tipo de autenticación seleccionado y luego selecciona Conectar para establecer la conexión.

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 predeterminada registrada en 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.

Nota:

Al utilizar Integration Service en un entorno local, si debes autenticarte utilizando un ID de cliente y un secreto, debes crear tu propia aplicación OAuth 2.0, similar a la opción Trae tu propia aplicación OAuth 2.0 .

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 OAuth 2.0. No se pueden utilizar otros tipos de OAuth 2.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 OAuth 2.0 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://{yourDomain}/provisioning_/callback para Automation Suite). 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://{yourDomain}/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. En Integration Service, en la lista Conectores , selecciona el conector deseado y luego haz clic en Conectar para abrir la página de creación de conexión.

2. Si hay varios tipos de autenticación disponibles, selecciona el tipo de autenticación Trae tu propia aplicación OAuth 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.

Nota:

Si tu organización utiliza BYOA, puedes establecer valores predeterminados para estas credenciales a través de una política de gobernanza de Integration Service en Automation Ops. Para obtener más información, consulta Configuración de las políticas de Integration Service.

Solución de problemas de conexión

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