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.

Información general

Tipos de aplicaciones compatibles y ámbito de acceso

Puede registrar las aplicaciones como uno de los siguientes tipos:

• Aplicaciones confidenciales: las aplicaciones que pueden almacenar de forma segura el secreto de la aplicación generado tras el registro; por ejemplo, las aplicaciones web y las aplicaciones de servicio a servicio (S2S).
• Aplicaciones no confidenciales: aplicaciones que no pueden garantizar el almacenamiento seguro del secreto de la aplicación y, por lo tanto, no se crea uno; por ejemplo, aplicaciones de escritorio o nativas para móviles.

El tipo de aplicación define el tipo de concesión de autorización que se permite para autorizar la aplicación. Las aplicaciones confidenciales tienen un ámbito de aplicación a nivel de usuario y/o API de ámbito de aplicación. Las aplicaciones no confidenciales solo pueden enviar solicitudes de ámbito de usuario, lo que significa que un usuario debe iniciar sesión para autorizar la solicitud de la aplicación.

Recursos de UiPath disponibles

Al registrar la aplicación externa, se le da acceso a uno o varios recursos UiPath a través de la API de una aplicación UiPath.

Las siguientes API están disponibles:

• API de Orchestrator

• API de Test Manager

• API de gestión de plataformas

Tres partes para autorizar aplicaciones externas

Hay tres pasos para conseguir que una aplicación externa acceda a tus recursos UiPath a través de OAuth:

Paso	Quién	Qué	Detalles
1	Administrador de la organización	Registrar una aplicación externa en Automation Suite	Registrar aplicaciones externas
2	Administrador de la organización	Proporcionar los datos de registro de la solicitud al desarrollador	Facilitar detalles a los desarrolladores
2	Desarrollador	Configura la aplicación externa para que use el tipo de concesión adecuado con el fin de acceder a tus recursos UiPath	Acceder a recursos de UiPath mediante aplicaciones externas

Registrar aplicaciones externas

Para registrar una aplicación externa y que puedas utilizar OAuth para acceder a los recursos de UiPath dentro de su organización:

1. En Automation Suite, diríjase a Administrador > Aplicaciones externas y haga clic en Añadir aplicación en la parte superior derecha.

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

2. Rellena el campo Nombre de la aplicación.
3. 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.

4. 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.

5. 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.
6. 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.

7. 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.

8. 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.

9. 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.
10. 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. Ve a Admin > Aplicaciones externas.
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 Admin > 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 que se muestra encima del botón. Permanece visible hasta que se hace clic en 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 tiene el secreto, genere uno nuevo como se describe 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 API.