Gestionar aplicaciones OAuth externas

Aprende a registrar y gestionar aplicaciones OAuth externas que acceden a las API de UiPath en Automation Suite.

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 y que puedas utilizar OAuth para acceder a los recursos de UiPath dentro de su organización:

1. Inicia sesión en Automation Suite como administrador de la organización.

2. Go to Admin, make sure that the organization is selected at the top of the left pane, and then click External Applications.

3. En la parte superior derecha, haga clic en Agregar aplicación.

   Se abre la página Añadir aplicación donde puede registrar una aplicación externa.

4. Rellena 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 de la creación, así que asegúrese de que su aplicación puede almacenarlo de forma segura. Si no se puede, seleccione Solicitud no confidencial.

6. En Recursos, haz clic en 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. Haz clic en 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 puede aceptarla, puedes añadir una URL en el campo Redirigir la URL y la respuesta de autorización se envía allí. La aplicación puede usarlo para acceder a los recursos de UiPath.

12. Haz clic en Añadir para crear el registro.

    Aparece un mensaje de confirmación. En el caso de 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 un lugar seguro porque no podrás volver a verlo.

Cambiar el ámbito de una aplicación existente

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

1. Go to Admin > organization > External Applications.

2. Haz clic en a la derecha de la fila de la aplicación.

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.
   • Haz clic en Añadir ámbitos para añadir un recurso adicional y selecciona los ámbitos.

4. Haz clic en 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. Haz clic en a la derecha de la fila de la aplicación.
3. En Secreto de la aplicación haz clic en Generar nuevo.

Se genera un nuevo secreto de aplicación y se muestra encima del botón. Permanece visible hasta que haces clic en Cancelar para cerrar la página. 4. Cópiala y asegúrate de guardarla en un lugar seguro.

Eliminar un secreto de aplicación existente

Para eliminar un secreto de aplicación existente:

1. Ve a Administración > Organización > Aplicaciones externas.
2. Haz clic en a la derecha de la fila de la aplicación.
3. En Secreto de la aplicación, haz clic en el icono Eliminar junto al ID secreto que deseas eliminar.

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.