Autenticación de Microsoft Outlook 365

Requisitos previos

In Integration Service, when you create a connection to one of our Microsoft Graph-based connectors, you can choose between the following authentication options:

• Código de autorización OAuth 2.0 : se conecta a la aplicación pública de UiPath.
• OAuth 2.0 Client credentials – uses a service account.
• Traiga su propia aplicación OAuth 2.0 : se conecta a una aplicación privada que cree.

• Código de autorización OAuth 2.0: tus credenciales de cuenta de Microsoft y, opcionalmente, tu buzón de correo compartido.

Nota:

For more details regarding the different authentication types, check How to connect to Microsoft 365 activities.

Entorno

Cuando accedes por primera vez a la pantalla Autenticación, puedes seleccionar un Entorno. Las opciones disponibles son:

• Office 365 (predeterminado)
• Gobierno de EE. UU. L4: dominio del sector público
• Gobierno de EE. UU. L5: dominio del sector público
• China

For details, check Microsoft Graph and Graph Explorer service root endpoints.

Consentimiento del administrador

Nota: Esta sección solo se aplica a las opciones de autenticación Código de autorización OAuth 2.0 y Trae tu propia aplicación OAuth 2.0 .

Many organizations require the consent of an administrator before you create a connection to an external application. The admin consent workflow requires an admin to approve the app registration to specific users or groups before a connection is established. For more details, chek Overview of admin consent workflow and User and admin consent in Microsoft Entra ID in the Microsoft documentation.

Nota:

Integration Service impersonates the user that creates the connection. The credentials of the user offer access to all of the same resources that they have in the given application. If you share the connection, every change made to Microsoft SharePoint or OneDrive with that connection is made on behalf of that user.

Ámbitos

The connector requests the following permissions or scopes:

• Código de autorización OAuth 2.0: Mail.Read, Mail.Read.Shared, Mail.ReadWrite, Mail.ReadWrite.Shared, Mail.Send, Mail.Send.Shared MailboxSettings.ReadWrite Calendars.Read, Calendars.Read.Shared, Calendars.ReadWrite, Calendars.ReadWrite.Shared, profile, openid, email, offline_access, User.Read.
• Credenciales de cliente OAuth 2.0:
  • Ámbitos mínimos necesarios para crear una conexión: Mail.Read, User.Read.
• Traiga su propia aplicación OAuth 2.0:
  • Ámbitos mínimos necesarios para crear una conexión: openid, offline_access, Mail.Read.
  • Lista mínima de ámbitos necesarios para los desencadenadores de Outlook:
    • openid, offline_access, Mail.Read, Mail.Read.Shared : para desencadenadores de buzón compartido.
    • Calendars.Read : para eventos en calendarios.
    • Calendars.Read.Shared : para eventos en calendarios compartidos.

Note: If you authenticate through Bring your own OAuth 2.0 app, you benefit by default from the scopes configured at app creation. If you want to use the default app permissions, declare a common scope. This means you use only the permissions configured for that application in Azure. To declare additional scopes at connection creation, use the Scopes field. Next, you are prompted to grant the additional consent during sign-in.

Agregar la conexión de Microsoft Outlook 365

To create a connection to your Microsoft Outlook 365 instance, perform the following steps:

1. Selecciona Integration Service de Automation Cloud^TM.

2. En la lista Conectores , selecciona Microsoft Outlook 365. También puedes utilizar la barra de búsqueda para encontrar el conector.
3. Selecciona el botón Conectar a Microsoft Outlook 365 .
4. Ahora se le redirige a la página de conexión.

   Choose between the following authentication types: OAuth 2.0 Authorization code, OAuth Client credentials, or Bring your own OAuth 2.0 app.

   • For OAuth 2.0 Authorization code, select Connect, and authenticate with your Microsoft email address and password.
     Nota:

     • All Outlook activities inherit the shared mailbox you enter in the Shared mailbox field once you connect.
     • Enter your shared mailbox in the Shared mailbox field, which all Outlook activities inherit once you connect.
     • Si seleccionas Credenciales de cliente OAuth 2.0, debes proporcionar una cuenta. Esto representa la cuenta utilizada para suplantar a un usuario.
   • For Bring your own OAuth 2.0 app, you must provide a Client ID and Client secret, the Tenant ID, and the scopes required to interact with different activities. Check out the activities' documentation to learn what scopes they require.
     Note: If you use a multitenant application, keep the default value for the Tenant ID (common). If you use a single tenant application, retrieve the Tenant ID from Azure. For more details, check How to find your Microsoft Entra tenant ID.
5. Se ha agregado su conexión.

En caso de que te encuentres con algún error durante el proceso de inicio de sesión, se recomienda que te contactes con tu administrador de Microsoft Outlook 365.

Para obtener más información, consulta la documentación del conector de Office 365 Outlook.

Traiga su propia aplicación OAuth 2.0

Para aprender a crear una aplicación, ve a la documentación oficial de Microsoft y sigue los pasos descritos: Registrar una aplicación con la plataforma de identidad de Microsoft.

Nota: Esta es una funcionalidad avanzada y requiere privilegios de administrador en la aplicación de destino. Trabaja con tu administrador de TI para configurar tu aplicación correctamente.

Requisitos

Al crear tu propia aplicación para usarla con Integration Service, debes tener en cuenta los siguientes requisitos:

1. Debes configurar la aplicación como una aplicación Multitenant o Single tenant .
2. Debes configurar una aplicación web .
3. Debes configurar un URI de redirección web . El URI de redirección (o URL de devolución de llamada) para tu aplicación OAuth 2.0 se proporciona en la pantalla de autenticación al crear una conexión: https://cloud.uipath.com/provisioning_/callback.
4. Debes configurar los permisos delegados. Para obtener más información, consulta Permisos en la documentación oficial de Microsoft.
5. Genera un secreto de cliente para tu aplicación.

Importante: La ventaja de utilizar tu aplicación OAuth privada es que puedes personalizar los permisos en función de tus necesidades reales. Para saber qué ámbitos son necesarios para cada actividad en el paquete de Microsoft 365, consulta Trabajar con ámbitos y consulta la documentación de las actividades .

El conector utiliza la API de Microsoft Graph. Consulta la página de referencia de permisos de Microsoft Graph para obtener más información sobre todos los permisos.

Después de crear tu aplicación, utiliza su ID de cliente y Secreto de cliente para crear una conexión con los conectores de Microsoft.

Actualizar tokens para aplicaciones OAuth

Microsoft puede invalidar o revocar los tokens de actualización para las aplicaciones OAuth en cualquier momento. Esto puede ocurrir por diferentes motivos, como los tiempos de espera y las revocaciones. Para obtener más información, consulta la documentación oficial de Microsoft.

Advertencia: la invalidación del token da como resultado conexiones fallidas y las automatizaciones no pueden ejecutarse sin reparar las conexiones.

Asegúrate de seguir las mejores prácticas de Microsoft al crear tus aplicaciones OAuth. Para obtener más información sobre cómo crear una aplicación OAuth de Microsoft, consulta la documentación de Microsoft.

Este problema afecta no solo al conector OneDrive y SharePoint, sino a todos los conectores basados en Microsoft Graph, como Outlook o Teams.