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

• Interactive Token authentication type can be used for attended automation and when multi-factor authentication (MFA) is required. This is the default option and what we use in our examples. If you're interested in trying out the activity package, this option is easy to configure and works well for personal accounts (using the default redirect URI noted in step 7 of the Register your application section of the guide).

• You have the option of registering and using your own Azure app (i.e., OAuthApplication = UiPath) or the one provided by UiPath (OAuthApplication = Custom):
  • UiPath Public App registration: The advantage of using the UiPath public app is that you don't need to configure or maintain the application Note: UiPath does not store any user data. The authentication token is saved only on your machine or in your Orchestrator bucket. See UiPath Public App registration.
  • Custom App registration: The advantage of using your own custom app is that you can manage, customize, and assign permissions within your organization more granularly. See How to create an application for Microsoft 365 Scope connections.
• When you create a custom application, you must select an application type. For interactive token authentication, use a mobile/desktop application (which uses OAuth 2.0 authorization code flow).
• When you run the Microsoft 365 activity for the first time using this authentication type, you are prompted to authorize access to the resources (you granted permissions to when registering your app) via a consent dialogue box. See Get access on behalf of a user.
• A single organization can have multiple application (client) IDs. Each application (client) ID contains its own permissions and authentication requirements. For example, you and your colleague can both register a Microsoft 365 application in your company's Azure Active Directory with different permissions. Your app can be configured to authorize permissions to interact with files only, while your colleague's app is configured to authorize permissions to interact with files, mail, and calendar.

• If you select this authentication type in Microsoft 365 Scope, leave the Username and Password fields empty. If you're using a single tenant app, configure the Tenant field. If you're using a multitenant app (the UiPath public app is multitenant), you can leave the Tenant field empty.

Scopes for Interactive token

When you add an activity to Microsoft 365 Scope, its required scopes are automatically detected. You can also choose to allow additional scopes or fewer scopes. If fewer scopes are selected, some activity functionalities might not work. For more information, see Working with activity scopes.

UiPath Public App registration

The UiPath Public App is registered with the following information:

• Name: UiPathStudioO365App
• Client ID: f2f43f65-16a6-4319-91b6-d2a342a88744
• Scopes: 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, Presence.Read, Presence.Read.All, profile, Sites.Read.All, Sites.ReadWrite.All, User.Read, User.Read.All.

How to create an application for Microsoft 365 Scope connections

To enable the Microsoft 365 classic activities, your app must be integrated with the Microsoft identity platform and have the correct Microsoft Graph API permissions assigned to it.

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 de Windows integrada 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.