Token interactivo

Información general

El tipo de autenticación de token interactivo incluye las siguientes características:

• Se ejecuta como usuario.
• Se utiliza en escenarios de automatización atendidos.
• Utiliza permisos delegados.

Nota: Este es el mismo método de autenticación que Integration Service admite, ya sea a través de la aplicación pública de UiPath o el método Trae tu propia aplicación .

Detalles

Puedes utilizar el tipo de autenticación de token interactivo para la automatización atendida y cuando se requiere la autenticación multifactor (MFA). Si quieres probar el paquete de actividades, utiliza este método de autenticación, ya que es fácil de configurar y funciona bien para cuentas personales. El token interactivo utiliza el URI de redirección predeterminado mencionado en la sección Registrar tu aplicación .

Puedes utilizar la aplicación pública de UiPath (OAuthApplication = UiPath), que es la predeterminada, o puedes registrarte y utilizar tu propia aplicación de Azure (OAuthApplication = Custom):

• Registro de la aplicación pública de UiPath: la ventaja de utilizar la aplicación pública de UiPath es que no es necesario configurar ni mantener la aplicación.
  Nota: UiPath no almacena ningún dato de usuario. El token de autenticación solo se guarda en tu máquina o en tu depósito de Orchestrator. Para obtener más información, consultaRegistro de la aplicación pública de UiPath.
• Trae tu propia aplicación (BYOA): la ventaja de utilizar tu propia aplicación es que puedes gestionar, personalizar y asignar permisos dentro de tu organización de forma más detallada. Para obtener más información, consulta Registro de aplicaciones OAuth personalizadas - Trae tu propia aplicación (BYOA).

Al crear una aplicación, debes seleccionar un tipo de aplicación. Para la autenticación de token interactivo, utiliza una aplicación móvil o de escritorio que utilice el flujo de código de autorización OAuth 2.0 con un URI de redirección de tipo public client o native (móvil y escritorio).

Cuando ejecutas la actividad de Microsoft 365 por primera vez con el tipo de autenticación de token interactivo, se te pide que autorices el acceso a los recursos a los que concediste permisos al registrar tu aplicación. Para obtener más información, consulta Obtener acceso en nombre de un usuario.

Una sola organización puede tener varios ID de aplicación (cliente). Cada ID de aplicación contiene sus propios permisos y requisitos de autenticación. Por ejemplo, tanto tú como tu compañero podéis registrar una aplicación de Microsoft 365 en el ID de Microsoft Entra de vuestra empresa con diferentes permisos. Tu aplicación puede configurarse para autorizar permisos para interactuar solo con archivos, mientras que la aplicación de tu colega puede autorizar permisos para interactuar con archivos, correo y calendario.

Nota:

• Si seleccionas el tipo de autenticación de token interactivo en la actividad Ámbito de Microsoft 365 , deja los campos Nombre de usuario y Contraseña vacíos.
• Si utilizas una aplicación de un solo tenant, configura el campo Tenant .
• Si utilizas una aplicación multitenant (la aplicación pública de UiPath es multitenant), deja el campo Tenant vacío.

Ámbitos del token interactivo

Nota:

Esta sección se aplica tanto a la aplicación pública de UiPath como a los métodos Trae tu propia aplicación.

Cuando añades una actividad al Ámbito de Microsoft 365, Studio detecta automáticamente los ámbitos que requiere. También puedes permitir más o menos ámbitos. Sin embargo, si se seleccionan menos ámbitos, es posible que algunas funcionalidades de la actividad no funcionen.

Para obtener más detalles, consulta Trabajar con ámbitos de actividad.

Registro de la aplicación pública de UiPath

La aplicación pública de UiPath está registrada con la siguiente información:

• Nombre: UiPathStudioO365App
• ID de cliente: f2f43f65-16a6-4319-91b6-d2a342a88744
• Ámbitos: Calendars.Read, Calendars.Read.Shared, Calendars.ReadWrite, Calendars.ReadWrite.Shared, Chat.ReadWrite, email, EWS.AccessAsUser.All, Files.Read, Files.Read.All, Files.ReadWrite, Files. ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Mail.Read, Mail.Read.Shared, Mail.ReadWrite, Mail.ReadWrite.Shared, Mail.Send, Mail.Send.Shared, offline_access, openid, Presencia.Leer, Presencia.Leer.Todos, perfil, Sitios.Leer.Todos, Sitios.LeerEscritura.Todos, Usuario.Leer, Usuario.Leer.Todos.

Registro de aplicación OAuth personalizado: trae tu propia aplicación (BYOA)

En esta sección se explica cómo crear una aplicación para las conexiones de ámbito de Microsoft 365 .

Información general

Para habilitar las actividades clásicas de Microsoft 365, tu aplicación debe:

• integrarse con la plataforma de identidad de Microsoft.
• tener asignados los permisos correctos de la API de Microsoft Graph.

Después de registrar tu aplicación Microsoft 365, Microsot Entra ID asigna un ID de aplicación (cliente) único que introduces en la actividad Ámbito de Microsoft 365 junto con los servicios a los que has asignado permisos, que son archivos, correo y calendario.

Registre su propia aplicación (BYOA)

Consejo: este proceso se describe en detalle en la documentación de Microsoft en Inicio rápido: registrar una aplicación con la plataforma de identidad de Microsoft. Sin embargo, la interfaz de usuario de Microsoft puede haber cambiado desde que se documentaron estos pasos por primera vez.

1. Inicia sesión en el portal de Azure utilizando tu cuenta de Microsoft 365 personal, de trabajo o educativa.
2. Selecciona Microsoft Entra ID.
3. Selecciona el botón Añadir y, en la lista desplegable, selecciona Registro de aplicación.
4. En la página Registrar una aplicación , rellena los siguientes campos Nombre, Tipos de cuenta compatibles y URI de redirección (opcional).
5. En el campo Nombre , introduce un nombre para tu aplicación.
6. En Tipos de cuenta compatibles, selecciona la opción que se aplica a ti:
   • Solo cuentas en este directorio de la organización (solo UiPath: inquilino único) : utiliza esta opción si tu público objetivo es interno de tu organización. Esto representa una aplicación de un solo tenant.
   • Cuentas en cualquier directorio de la organización (Cualquier tenant de Microsoft Entra ID - Multitenant) : utiliza esta opción si tu público objetivo son clientes empresariales o educativos. Esto representa una aplicación multitenant.
   • Cuentas en cualquier directorio de la organización (cualquier inquilino de Microsoft Entra ID - Multitenant) y cuentas personales de Microsoft (por ejemplo, Skype, Xbox) : utiliza esta opción para apuntar al conjunto más amplio de identidades de Microsoft. Esto representa una aplicación multitenant.
   • Solo cuentas personales de Microsoft

   Para obtener más información sobre qué opción seleccionar, consulta ¿Quién puede iniciar sesión en tu aplicación?

7. En Redirigir URI (opcional), introduce una dirección URI, si procede. La biblioteca de autenticación de Microsoft (MSAL.NET) utiliza un URI de redirección predeterminado: https://login.microsoftonline.com/common/oauth2/nativeclient. Es probable que este valor funcione para ti cuando utilices el tipo de autenticación de token interactivo.
   • Su selección depende de su tipo de autenticación. Para obtener más información, consulta Cómo conectarse a las actividades de Microsoft 365).
   • En nuestro ejemplo, la organización admite la autenticación multitenant y solo puede utilizar el tipo de autenticación de token interactivo que requiere un URI de redirección.
     • Si utilizas un token interactivo y el URI de redirección de Microsoft predeterminado, debes añadir una plataforma de tipo Aplicaciones móviles y de escritorio. Para obtener más información, consulta Configurar los ajustes de la plataforma en la documentación de Microsoft.
     • Si tu tipo de autenticación es Autenticación de Windows integrada (IWA) o Nombre de usuario y contraseña, no necesitas registrar un URI de redirección para tu aplicación. Estos flujos hacen un viaje de ida y vuelta al punto final de la plataforma de identidad de Microsoft v2.0, y no se devolverá la llamada a tu aplicación en ningún URI específico.
   • Cuando trabajes con Microsoft 365 en un proyecto de UiPath Studio destinado a .NET 5.0, añade http://localhost al URI de redirección de las aplicaciones de tu propiedad.

     Para obtener más información, consulta Registro de aplicaciones de escritorio en la documentación de la plataforma de identidad de Microsoft.

8. Selecciona Registrar, que te redirige a la página Información general de tu aplicación registrada.

Para completar la configuración de la aplicación, también debes añadirle permisos de API.

Nota: esta configuración es solo un ejemplo. Por lo tanto, puedes realizar selecciones en función de las políticas de tu organización.

Agregar permisos de API

Nota:

• La autenticación de token interactivo utiliza permisos delegados.
• Los permisos pueden variar en función de la actividad, ya que cada actividad incluye los permisos que necesita para sus características específicas.

Después de registrar tu aplicación, añade los permisos de API necesarios de la siguiente manera:

1. En el portal de Azure , ve a tu aplicación registrada.
2. Expande la opción Administrar y selecciona Permisos de API.
3. Selecciona Añadir un permiso, que abre el panel lateral Solicitar permisos de la API .
4. Selecciona Microsoft Graph, en la pestaña API de Microsoft .
5. Selecciona Permisos delegados para mostrar la lista de permisos.
   Nota:

   • Los permisos delegados se utilizan con el token interactivo.
   • Los permisos de la aplicación se utilizan con el ID de la aplicación y el secreto.

   Para obtener más información sobre los tipos de permisos, consulta Configurar una aplicación cliente para acceder a las API web en la documentación de Microsoft Azure.

6. Utiliza la barra de búsqueda o desplázate hacia abajo en la lista y selecciona los siguientes permisos:
   Nota:

   • Los permisos pueden variar en función de la actividad, ya que cada actividad incluye los permisos que necesita para sus características específicas.
   • Estos permisos no son todos obligatorios. La siguiente lista representa el conjunto completo de permisos necesarios para ejecutar todas las actividades de Microsoft 365. Puedes restringir los permisos en función de tu caso de uso particular. Consultalas páginas de documentación de las actividades para saber qué permisos necesitan.
   • Calendario
     • Calendarios. Leer
     • Calendarios. LeerEscribir
   • Archivos
     • Archivos. Leer
     • Archivos.leer.todos
     • Archivos.LeerEscribir
     • Archivos.leerEscribir todo
   • Sitios
     • Sitios. Leer.todos
     • Sitios. LeerEscribir.todo
   • Correo
     • Correo. Leer
     • Mail.ReadWrite
     • Correo.Enviar
   • Usuarios
     • User.Read
   • Compartido : ámbitos necesarios para acceder a los recursos compartidos con el usuario, pero que no son de su propiedad.
     • Correo.Leer.Compartido
     • Correo.LeerEscribir.Compartido
     • Correo.Enviar.Compartido
     • Calendarios.Leer.Compartido
     • Calendarios.LeerEscribir.Compartir
7. Selecciona Añadir permisos para volver a tu lista de permisos de API.
   
   

   

   
   
8. Asegúrate de que tus permisos de API incluyen tus permisos añadidos de Calendarios, Archivos, Usuario y Correo .
   
   

   

   
   

Restringir una aplicación a sitios web específicos

Si quieres controlar a qué sitios web puede acceder tu aplicación, procede de la siguiente manera:

Primero, asigna el permiso Sites.Selected a tu aplicación:

1. En el portal de Azure , ve a tu aplicación registrada.
2. Expande la opción Administrar y selecciona Permisos de API.
3. Selecciona Añadir un permiso, que abre el panel lateral Solicitar permisos de la API .
4. En la pestaña API de Microsoft , selecciona Microsoft Graph.
5. Selecciona Permisos de aplicación.
6. Busca sitios y expande el menú desplegable Sitios para ver todos los permisos de sitio disponibles.
7. Añade una marca de verificación junto al permiso Sites.Selected y, a continuación, selecciona Añadir permiso.

A continuación, permite que la aplicación acceda a un sitio web concreto mediante las API:

1. Ve al explorador de Microsoft Graph.
2. Crea una API de tipo GET. Por ejemplo, https://graph.microsoft.com/v1.0/sites?search=FPH_Test, donde FPH_Test es el nombre de un sitio de SharePoint.
   Figura 1. Página de Microsoft Graph Explorer con la API GET
   

   

   
   
3. Selecciona Ejecutar consulta.
4. Copia el ID del sitio 6c964666-500d-48e6-9ca6-84acee41c5b9,f955b6bc-9d48-4155-b1f5-e722d5cea1b5 del cuerpo de la respuesta y pégalo en un documento para su uso posterior.
   Figura 2. El cuerpo de respuesta de la API GET en Microsoft Graph Explorer
   

   

   
   
5. Para permitir que la aplicación acceda a este sitio web, crea otra API, esta vez de tipo POST. Por ejemplo, https://graph/microsoft.com/v1.0/sites/0yxd4.sharepoint.com,6c964666-500d-48e6-9ca6-84acee41c5b9,f955b6bc-9d48-4155-b1f5-e722d5cea1b5/permissions, donde 6c964666-500d-48e6-9ca6-84acee41c5b9,f955b6bc-9d48-4155-b1f5-e722d5cea1b5 es el ID del sitio.
6. Dado que se trata de una API POST, introduce los datos de la carga útil en formato JSON en el cuerpo de la solicitud. Por ejemplo:

   {
   	"roles": [
   		"write"
   	],
   	"grantedToIdentities": [
   		{
   			"application": {
   				"id": "14dbd4c1-9ebf-47e8-c3f75bffed2d",
   				"displayName": "BOYA_Nisarg"
   			}
   		}
   	]
   }

   Nota:

   • Asegúrate de que la carga útil contenga el nombre y el ID de la aplicación.
   • Puedes encontrar el ID de la aplicación cuando accedes a la aplicación en Azure, en Información general.
7. Selecciona Ejecutar consulta. Si la consulta se ejecutó correctamente, se muestra el mensaje Creado - 201 .

Para comprobar qué aplicaciones pueden acceder a sitios específicos, cambia la API de POST a GET, elimina la carga útil, mantén la misma API y ejecuta la consulta. Puedes encontrar en el cuerpo de la respuesta todas las aplicaciones que pueden acceder a ese sitio específico.

Crear tu proyecto en Studio Desktop

Primero, crea un nuevo proyecto de automatización de la siguiente manera:

1. En UiPath Studio, selecciona Nuevo proyecto.
2. Selecciona Proceso, que abre una ventana Nuevo proceso en blanco .
3. Introduce un Nombre, una Ubicacióny una Descripcióndel proyecto.
4. Selecciona la Compatibilidad, donde Windows está seleccionado de forma predeterminada.
5. Selecciona Crear.
6. Para obtener más información sobre los paquetes de UiPath Studio, consulta Gestionar paquetes.

Después de crear tu proyecto, instala el paquete UiPath.MicrosoftOffice365.Activities de la siguiente manera:

1. Selecciona Gestionar paquetes en la cinta Diseño .
2. Introduce Office 365 o Microsoft en la barra de búsqueda, en Todos los paquetes.
3. Selecciona la versión del paquete que deseas y luego selecciona Instalar.
4. Selecciona Guardar.

¡Ya está! Ahora que has completado la configuración, puedes empezar a añadir las actividades de Microsoft 365 a tu proyecto.

Próximos pasos

Para una experiencia de aprendizaje práctica y para empezar a utilizar rápidamente las actividades, consulta las guías de inicio rápido . Estas guías proporcionan instrucciones paso a paso para ayudarte a crear muestras funcionales de las diferentes actividades para que puedas verificar la conexión a tu aplicación registrada y familiarizarte con las propiedades de entrada/salida.

Para obtener más información sobre las actividades de Microsoft 365 (incluidas las entradas/salidas de propiedades de ejemplo), consulta las actividades clásicas para obtener una lista completa y enlaces a las páginas detalladas de la actividad.