Configurar tu aplicación Microsoft 365 Azure

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

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 de Microsoft 365, Active Directory de Azure asigna un ID de aplicación único (cliente) que introduces en la actividad Ámbito de Microsoft Office 365 junto con los servicios a los que asignaste permisos (por ejemplo, archivos, correo, calendario).

Configuración

Registre su aplicación

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 más te convenga. Para obtener más información sobre qué opción seleccionar, a continuación se presentan las recomendaciones de Microsoft:

   • Solo cuentas en este directorio de la organización: usa esta opción si el público de destino es interno de tu organización.
   • Cuentas en cualquier directorio de la organización (Cualquier directorio de Azure AD - Multitenant): usa esta opción si tu público objetivo son clientes empresariales o educativos y para habilitar el multitenemento.
   • Cuentas de cualquier directorio de la organización (cualquier directorio de Azure AD - Multitenant) y cuentas personales de Microsoft (p. Ej. Skype, xbox): usa esta opción para dirigirte al conjunto más amplio de identidades de Microsoft y habilitar el tenant múltiple.

7. En URI de redirección (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. 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 sobre este tema, consulta la sección Automatización desatendida y atendida en la página de detalles de la actividad Ámbito de Microsoft 365 ).
   • En nuestro ejemplo, la organización admite la autenticación de tenant múltiple y solo puede usar 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 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 necesitarás registrar un URI de redirección para tu aplicación. Estos flujos viajan de vuelta al punto final de la plataforma de identidad de Microsoft v2.0 y no se volverá a llamar a tu aplicación en ningún URI específico.
   • Al trabajar con Microsoft 365 en un proyecto de UiPath Studio dirigido a .NET 5.0, los clientes deben añadir http://localhosta la URI de redireccionamiento de sus 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. Haz clic en Registrar. En la siguiente captura de pantalla hay disponible un ejemplo de configuración.

   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 la aplicación registrada (Azure Portal> Azure Active Directory> Registros de aplicaciones> Office365App), haz clic en 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 su aplicación?, haz clic en Permisos delegados o Permisos de la aplicación para mostrar la lista de permisos. Los permisos de la aplicación deben establecerse cuando el valor de AuthenticationType en la actividad de ámbito de Microsoft Office 365 se establece en ApplicationIdAndSecret o ApplicationIdAndCertificate. Los otros tipos de autenticación disponibles en la actividad de ámbito de Microsoft Office 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.

   Importante:

   Algunas actividades no admiten el tipo de autenticación ApplicationIdAndSecret o ApplicationIdAndCertificate (por ejemplo, Buscar horas de reunión).

   Para las actividades de correo electrónico, es obligatorio especificar un valor para el parámetro Cuenta (es decir, qué buzón de todos los buzones de correo de los tenant desea usar).

   Al usar este tipo de autenticación, la aplicación tiene acceso a todos los buzones de correo desde tu tenant. El permiso de la API de la aplicación Mail.Read significa Leer correo en todos los buzones de correo y Mail.ReadWrite significa Leer y escribir correo en todos los buzones de correo.

   Una solución es restringir los permisos de la aplicación a buzones de correo específicos, para que la aplicación tenga acceso solo a los buzones de correo especificados.

   Para obtener más información, consulta Determinar el alcance de los permisos de la aplicación para buzones de correo específicos de Exchange Online.

   Usar sitios. Permiso de la aplicación seleccionada para permitir que la aplicación acceda solo a colecciones de sitios de SharePoint específicas en lugar de a todas.

6. Use la barra de búsqueda o desplácese hacia abajo en la lista alfabética y seleccione los siguientes permisos:

   • 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

   • Compartido\ *

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

     • Calendarios.LeerEscribir.Compartir

       \ * Ámbitos necesarios para acceder a los recursos que se comparten con el usuario, pero que no son de su propiedad.

   • Haz clic en Añadir permisos (volviendo a tu lista de permisos de API)

     
     

     

     
     

7. Verifique que sus permisos de API incluyan sus permisos agregados para Calendarios, Archivosy Correo .

   
   

   

   
   

Cree su proyecto en Studio Desktop

1. Crear un nuevo proyecto de automatización.

   • Abra UiPath Studio.
   • En Nuevo proyecto, haz clic en Proceso (se abre una ventana Nuevo proceso en blanco ).
   • Introduce un Nombre, una Ubicacióny una Descripcióndel proyecto.
   • Elija la compatibilidad. Windows está seleccionado de forma predeterminada.

   • Haz clic en Crear.

     

2. Instale el paquete UiPath.MicrosoftOffice365.Activities .

   • En la cinta Diseño , haz clic en Administrar paquetes (se abre la ventana Administrar paquetes ).
   • En Todos los paquetes, en la barra de búsqueda , escribe Office 365 o Microsoft.
   • Selecciona la versión del paquete que deseas y haz clic en Instalar.
   • 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 de actividades y los enlaces a las páginas detalladas de la actividad.