Gestionar aplicaciones OAuth externas

Como administrador, utilizando el marco OAuth, puedes delegar la autorización a aplicaciones externas. Una vez registradas, estas aplicaciones pueden hacer llamadas a las aplicaciones de UiPath o a los recursos con alcance a las API que designe.

Añadir una aplicación externa

Para registrar una aplicación externa para que pueda utilizar OAuth para acceder a tus recursos de UiPath:

1. Ve a Administración y seleccione la organización en la parte superior izquierda del panel.
2. Selecciona Aplicaciones externas.
3. Selecciona Añadir aplicación en la parte superior derecha.
4. Rellene el campo Nombre de la aplicación
5. Selecciona una opción para el Tipo de aplicación.

   Si seleccionas Aplicación confidencial, recibirás un secreto de la aplicación al final, así que asegúrate de que tu aplicación puede almacenarlo de forma segura. Si no se puede, selecciona Solicitud no confidencial.

6. En Recursos, selecciona Añadir ámbitos.

   Aparecerá el panel Editar recurso a la derecha, en el que puedes seleccionar los recursos a los que debe tener acceso la aplicación.

7. En la lista desplegable Recursos, selecciona la API de UiPath que puede utilizar la aplicación.
   Nota: Solo se puede añadir ámbito para un recurso a la vez. Si quieres permitir el acceso a varios recursos, repite este proceso para añadir el ámbito de cada recurso.
8. En la pestaña Ámbito(s) de usuario, selecciona las casillas de los permisos lógicos de la API que quieres otorgar, según sea necesario.

   Conceder permisos bajo el ámbito de usuario significa que la aplicación externa puede acceder a esos recursos dentro de un contexto de usuario y un usuario con los permisos adecuados debe estar conectado.

9. Si se trata de una aplicación confidencial, puedes cambiar a la pestaña Ámbito(s) de aplicación para conceder también permisos a nivel de aplicación para el recurso seleccionado, según sea necesario.

   Con los permisos bajo el ámbito de la aplicación, la aplicación externa tiene acceso a los datos de toda la aplicación para los ámbitos seleccionados sin necesidad de la interacción del usuario.

   Las aplicaciones no confidenciales no pueden acceder al ámbito de la aplicación.

10. Selecciona Guardar.

    Se cierra el panel y el recurso y los ámbitos seleccionados se añadirán a la tabla Recursos del formulario.

11. Si la aplicación externa ha sido registrada con ámbitos de usuario, debes añadir una URL de redirección donde la aplicación externa debe recibir la respuesta de autorización.

    Si solo se seleccionan ámbitos de aplicación, es opcional facilitar una URL de redirección.

12. Selecciona Añadir para crear el registro.

    Se abrirá un mensaje de confirmación. Para las aplicaciones confidenciales, el mensaje de confirmación incluye el secreto de la aplicación que la aplicación externa registrada puede utilizar para solicitar autorización. Asegúrate de guardarlo en una ubicación segura porque no podrás volver a verlo.

Cambiar el alcance de una aplicación existente

Los ámbitos son los permisos de la aplicación externa en relación con tus recursos UiPath.

1. Ve a Administración > Organización > Aplicaciones externas.
2. Selecciona el icono Editar .
3. Cambiar el ámbito al que tiene acceso la aplicación:
   • Utiliza los iconos de la derecha de una fila de recursos para editar el ámbito existente o para eliminar el recurso.
   • Selecciona Añadir ámbitos para añadir un recurso adicional y luego selecciona ámbitos para él.
4. Selecciona Guardar.

Generar un nuevo secreto de aplicación

Si no conoces el secreto de aplicación que se generó para una aplicación externa confidencial, no podrás recuperarlo. Pero puedes generar uno nuevo.

Nota: Si generas un nuevo secreto de aplicación, asegúrate de compartirlo con el desarrollador que mantiene la integración con la aplicación externa. Deben actualizar el mecanismo de autenticación, si no la integración existente dejará de funcionar.

Para generar un nuevo secreto de aplicación:

1. Ve a Administración > Organización > Aplicaciones externas.
2. Selecciona el icono Editar .
3. En App Secret, selecciona Generar nuevo.

   Se genera y se muestra un nuevo secreto de aplicación. El secreto de la aplicación permanece visible hasta que selecciones Cancelar para cerrar la página.

4. Cópialo y asegúrate de guardarlo en un lugar seguro.

Facilitar detalles a los desarrolladores

Tras registrar una aplicación externa, un desarrollador también debe configurar la aplicación externa para que se autentique correctamente, solicite autorización al Identity Server de UiPath y luego acceda a los recursos permitidos de UiPath.

Para poder realizar esas tareas, debes compartir con ellos la siguiente información:

• el tipo de aplicación y ID de aplicación, ambos visibles en la página Admin > Aplicaciones externas
• los ámbitos añadidos para cada tipo de ámbito. Para algunos recursos, el mismo nombre se utiliza tanto en el ámbito del usuario como en el de la aplicación, por lo que el tipo también es importante.

• si se trata de una solicitud confidencial, el secreto de la aplicación generado al registrar la aplicación externa.

  Nota: Si ya no tienes el secreto, genera uno nuevo como se ha descrito anteriormente.

Para obtener más información sobre cómo autenticar y autorizar aplicaciones externas como desarrollador, consulta Aplicaciones externas en la guía de la API.