Token interactivo

Información general

• Se ejecuta: como usuario.
• Escenario: automatización atendida.
• Permisos delegados.

Nota: Este es el mismo método de autenticación admitido en Integration Service, ya sea a través de la aplicación pública de UiPath o de una aplicación privada personalizada (método Trae tu propia aplicación).

Detalles

• El tipo de autenticación de token interactivo se puede utilizar para la automatización atendida y cuando se requiere la autenticación multifactor (MFA). Esta es la opción predeterminada y la que usamos en nuestros ejemplos. Si estás interesado en probar el paquete de actividades, esta opción es fácil de configurar y funciona bien para las cuentas personales (utilizando el URI de redirección predeterminado indicado en el paso 7 de la sección Registra tu aplicación de la guía).

• Tienes la opción de registrarte y utilizar tu propia aplicación de Azure (es decir, OAuthApplication = UiPath) o la proporcionada por UiPath (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. Consulta Registro de la aplicación pública de UiPath.
  • Registro de aplicaciones personalizadas: la ventaja de utilizar tu propia aplicación personalizada es que puedes gestionar, personalizar y asignar permisos dentro de tu organización de forma más detallada. Consulta Cómo crear una aplicación para conexiones de ámbito de Microsoft 365.
• Al crear una aplicación personalizada, debes seleccionar un tipo de aplicación. Para la autenticación de token interactivo, utiliza una aplicación móvil/de escritorio (que utiliza el flujo de código de autorización OAuth 2.0).
• Cuando ejecutes la actividad de Microsoft 365 por primera vez utilizando este tipo de autenticación, se te pedirá que autorices el acceso a los recursos (a los que concediste permisos al registrar tu aplicación) a través de un cuadro de diálogo de consentimiento. 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 (cliente) contiene sus propios permisos y requisitos de autenticación. Por ejemplo, tú y tu colega podéis registrar una aplicación de Microsoft 365 en el Azure Active Directory de tu 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 está configurada para autorizar permisos para interactuar con archivos, correo y calendario.

• Si seleccionas este tipo de autenticación en Á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), puedes dejar el campo Tenant vacío.

Ámbitos del token interactivo

Cuando añades una actividad al Ámbito de Microsoft 365, sus ámbitos necesarios se detectan automáticamente. También puedes optar por permitir ámbitos adicionales o menos ámbitos. Si se seleccionan menos ámbitos, es posible que algunas funcionalidades de la actividad no funcionen. Para obtener más información, 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.

Cómo crear una aplicación para las conexiones de ámbito de Microsoft 365

Para habilitar las actividades clásicas de Microsoft 365, tu aplicación debe integrarse con la plataforma de identidad de Microsoft y tener los permisos correctos de API de Microsoft Graph asignados.

Para integrar su aplicación, asignar permisos y comenzar a crear su proyecto de automatización, complete los siguientes pasos:

1. Registre su aplicación.
2. Agrega permisos de API.
3. Construya su proyecto.

Después de registrar tu aplicación Microsoft 365, Azure Active Directory 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 (p. ej., archivos, correo, calendario).

Registre su aplicación

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. Ten en cuenta que la interfaz de usuario de Microsoft puede haber cambiado ya que estos pasos se documentaron por primera vez.

1. Inicia sesión en el portal de Azure utilizando tu cuenta de Microsoft 365 personal, de trabajo o educativa.
2. En el panel de navegación de la izquierda, haz clic en Azure Active Directory.
3. Una vez que se abra la página de Azure Active Directory , haz clic en Registros de aplicaciones.

4. Haga clic en + Nuevo registro en la barra de navegación superior.

5. Introduzca un nombre para su aplicación (por ejemplo, "Office365App").

6. En Tipos de cuentas compatibles, selecciona la opción que se aplica a ti. Para obtener más información sobre qué opción seleccionar, consulta ¿Quién puede iniciar sesión en tu aplicación?:

   • Solo Cuentas en este directorio organizativo: utiliza esta opción si tu público objetivo es interno a tu organización. Esto representa una única aplicación de tenant.
   • Cuentas en cualquier directorio organizativo (Cualquier directorio Azure AD - 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 organizativo y cuentas personales de Microsoft (por ejemplo, Skype, Xbox): utiliza esta opción para dirigirse al conjunto más amplio de identidades de Microsoft. Esto representa una aplicación multitenant.
7. En URI redireccionamiento (opcional), introduce una dirección URI (si corresponde). La biblioteca de autenticación de Microsoft (MSAL.NET) utiliza un URI de redirección predeterminado: https://login.microsoftonline.com/common/oauth2/nativeclient. Este valor probablemente funcione para ti al utilizar el tipo de autenticación de token interactivo.
   • Tu selección depende de tu tipo de autenticación. Para obtener más información sobre este tema, 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 redirigido.
     • Si utilizas el 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 la configuración de la plataforma en la documentación de Microsoft.
     • Si tu tipo de autenticación es Autenticación integrada de Windows (IWA) o Nombre de usuario y Contraseña, no es necesario 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 v2.0 de Microsoft y tu aplicación no se llamará en ningún URI específico.
   • Al trabajar con Microsoft 365 en un proyecto de UiPath Studio dirigido a .NET 5.0, añade http://localhost al URI redireccionamiento de tus aplicaciones personalizadas.

     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. Una configuración de ejemplo está disponible en la siguiente imagen.

   Nota: esta configuración es solo un ejemplo. Sigue los pasos descritos en la documentación y realiza selecciones según las políticas de tu organización.
   
   

   

   
   

¡Listo! Ahora, agreguemos permisos de API a su aplicación registrada.

Agregar permisos de API

1. Desde la página de tu aplicación registrada (Portal de Azure > Azure Active Directory > Registros de aplicaciones > Office365App), selecciona Permisos de API en el panel de navegación de la izquierda.
2. Una vez que se abra la página de permisos de API, haz clic en + Añadir un permiso (se abre la ventana Solicitar permisos de API ).
3. En Seleccionar una API, haz clic en API de Microsoft (puede estar abierto de forma predeterminada).

4. En API de Microsoft usadas habitualmente, haz clic en Microsoft Graph.

5. En ¿Qué tipo de permisos requiere tu aplicación?, haz clic en Permisos delegados o Permisos de aplicación para mostrar la lista de permisos. Selecciona Permisos de aplicación si utilizas el tipo de autenticación ApplicationIdAndSecret o ApplicationIdAndCertificate. Los otros tipos de autenticación disponibles en la actividad Ámbito de Microsoft 365 requieren permisos delegados.

   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. Use la barra de búsqueda o desplácese hacia abajo en la lista alfabética y seleccione los siguientes permisos:

   Nota: estos permisos no todos son obligatorios. La lista proporcionada representa el conjunto completo de permisos necesarios para ejecutar todas las actividades de Microsoft 365. Puedes restringir los permisos dependiendo de tu caso de uso en particular. Consulta las páginas de documentación de actividades para aprender 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

   • Compartidos (ámbitos necesarios para acceder a recursos que se comparten con, pero no son propiedad del usuario).

     • Correo.Leer.Compartido
     • Correo.LeerEscribir.Compartido
     • Correo.Enviar.Compartido
     • Calendarios.Leer.Compartido
     • Calendarios.LeerEscribir.Compartir

   • Selecciona Añadir permisos para volver a tu lista de permisos de API.

     
     

     

     
     

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

   
   

   

   
   

Cree su proyecto en Studio Desktop

1. Crear un nuevo proyecto de automatización.

   1. Abra UiPath Studio.

   2. En Nuevo proyecto, haz clic en Proceso. Esto abre una ventana Nuevo proceso en blanco.

   3. Introduce un Nombre, una Ubicacióny una Descripcióndel proyecto.

   4. Elija la compatibilidad. Windows está seleccionado de forma predeterminada.

   5. Haz clic en Crear.

2. Instale el paquete UiPath.MicrosoftOffice365.Activities .

   1. Desde la cinta Diseño, selecciona Gestionar paquetes.
   2. En Todos los paquetes, en la barra de búsqueda , escribe Office 365 o Microsoft.
   3. Selecciona la versión del paquete que deseas y luego selecciona Instalar.
   4. Haz clic en el botón " Guardar ".
   Para obtener más información sobre los paquetes de UiPath Studio, consulta Gestionar paquetes en la Guía de Studio.

¡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 ejemplos de trabajo 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.