Autenticación de Microsoft Outlook 365

Información general

En Integration Service, al crear una conexión a uno de nuestros conectores basados en Microsoft Graph, puedes elegir entre las siguientes opciones de autenticación:

• Client Certificate Authentication – connects using a client certificate instead of a client secret.
• OAuth 2.0 Authorization code – connects to the UiPath public application with your Microsoft account credentials.
• OAuth 2.0 Client credentials – connects using a service account.
• Traiga su propia aplicación OAuth 2.0 : se conecta a una aplicación privada que cree.

Nota:

Para obtener más información sobre los diferentes tipos de autenticación, consulta Cómo conectarse a las actividades de Microsoft 365.

En caso de que encuentres algún error durante el proceso de inicio de sesión, te recomendamos que te pongas en contacto con tu administrador de Microsoft Outlook 365. Para obtener más información, consulta la documentación del conector de Office 365 Outlook.

Consentimiento del administrador

Nota:

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

Muchas organizaciones requieren el consentimiento de un administrador antes de crear una conexión a una aplicación externa. El flujo de trabajo de consentimiento del administrador requiere que un administrador apruebe el registro de la aplicación para usuarios o grupos específicos antes de establecer una conexión. Para obtener más información, consulta Información general sobre el flujo de trabajo de consentimiento del administrador y Consentimiento de usuario y administrador en Microsoft Entra ID en la documentación de Microsoft.

Nota:

Integration Service suplanta al usuario que crea la conexión. Las credenciales del usuario ofrecen acceso a todos los mismos recursos que tienen en la aplicación dada. Si compartes la conexión, cada cambio realizado en Microsoft SharePoint o OneDrive con esa conexión se realiza en nombre de ese usuario.

Autenticación de certificado del cliente

Ámbitos

The connector requires the following minimum scopes to create a connection: Mail.Read and User.Read.All.

The connector requires the following scopes for all activities to function: User.Read, User.Read.All, 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, and offline_access.

To add more granular permissions, refer to the activities documentation.

Añadir la conexión de Microsoft Outlook 365

Para crear una conexión a tu instancia de Microsoft Outlook 365, realiza los siguientes pasos:

1. In Automation Cloud, select Integration Service from the rail menu.
2. En la lista Conectores , selecciona Microsoft Outlook 365 o utiliza la barra de búsqueda para encontrar el conector.
3. Select Connect to Microsoft Outlook 365, which redirects you to the connection page.
4. Select the Client Certificate Authentication authentication type.
5. Configure los siguientes campos:

   • Client ID - You can find the ID in the Overview section of your Microsoft Azure application registration.

   • Password for the certificate - The password you set during the certificate creation.

   • OAuth base64 client certificate - The client certificate is generated in a .pfx file format, which you must convert to Base64-encoded format and provide it in this field.

   • Tenant ID - You can find the Microsoft Azure tenant ID for an app in the Overview section of your Microsoft Azure application registration.

   • Environment - Optionally, select an environment from the dropdown list:

     • Office 365 (predeterminado)
     • US Government L4 - Public Sector domain
     • US Government L5 - Public Sector domain
     • China Select Office 365 (default) for all regions, and only switch to Government or China for cloud deployments.
     Nota:

     Para obtener más información sobre los entornos, consulta Puntos finales de la raíz del servicio Microsoft Graph y Graph Explorer.

   • Account - Enter the user principal name (UPN) of the account or shared mailbox that the system should use in the connection. This is required for the connection to be established.

6. Seleccione Conectar.
7. Autentícate con tu dirección de correo electrónico y contraseña de Microsoft.

Código de autorización OAuth 2.0

Ámbitos

The connector requires the following minimum scopes to create a connection: openid, offline_access, User.Read, Mail.Read, and email.

The connector requires the following full set of scopes for all activities to function: User.Read, User.Read.All, 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, and offline_access.

To add more granular permissions, refer to the activities documentation.

Añadir la conexión de Microsoft Outlook 365

Para crear una conexión a tu instancia de Microsoft Outlook 365, realiza los siguientes pasos:

1. In Automation Cloud, select Microsoft Outlook 365 from the rail menu.
2. From the Connectors list, select Microsoft Outlook 365. You can also use the search bar to narrow down the connector.
3. Select the Connect to Microsoft Outlook 365 button, which redirects you to the connection page.
4. Selecciona el tipo de autenticación Código de autorización OAuth 2.0 .
5. Configura lo siguiente:
   • Scope - Add or remove permissions for your connector.
   • Environment - Optionally, select an environment from the dropdown list:
     • Office 365 (predeterminado)
     • US Government L4 - Public Sector domain
     • US Government L5 - Public Sector domain
     • China Select Office 365 (default) for all regions, and only switch to Government or China for cloud deployments.
     Nota:

     Para obtener más información sobre los entornos, consulta Puntos finales de la raíz del servicio Microsoft Graph y Graph Explorer.

   • Shared mailbox - Optionally, enter your shared mailbox.
   Nota:

   All Outlook activities inherit the shared mailbox once you connect.

6. Select Connect.
7. Autentícate con tu dirección de correo electrónico y contraseña 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 razones, como los tiempos de espera y las revocaciones. Para obtener más información, consulta la documentación oficial de Microsoft.

Nota:

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

Make sure to follow best practices from Microsoft when creating your OAuth applications. For full details on how to create a Microsoft OAuth app, check the Microsoft documentation.

This issue affects not only the OneDrive and SharePoint connector, but all Microsoft Graph-based connectors, such as Outlook or Teams.

Credenciales de cliente OAuth 2.0

Ámbitos

The connector requires the following minimum scopes to create a connection: Mail.Read and User.Read.All.

The connector requires the following full set of scopes for all activities to function: User.Read, User.Read.All, 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, and offline_access.

To add more granular permissions, refer to the activities documentation.

Añadir la conexión de Microsoft Outlook 365

Para crear una conexión a tu instancia de Microsoft Outlook 365, realiza los siguientes pasos:

1. In Automation Cloud, select Integration Service from the rail menu.
2. From the Connectors list, select Microsoft Outlook 365. You can also use the search bar to narrow down the connector.
3. Select the Connect to Microsoft Outlook 365 button, which redirects you to the connection page.
4. Selecciona el tipo de autenticación Credenciales de cliente OAuth 2.0 .
5. Configura lo siguiente:

   • Client ID - You can find the ID in the Overview section of your Microsoft Azure application registration.

   • Client Secret - The client secret from the Certificates & secrets section of your Microsoft Azure application.

   • Tenant ID - The Microsoft Azure tenant ID for an app from the Overview section.

   • Environment - Optionally, select an environment from the dropdown list:

     • Office 365 (predeterminado)
     • US Government L4 - Public Sector domain
     • US Government L5 - Public Sector domain
     • China Select Office 365 (default) for all regions, and only switch to Government or China for cloud deployments.
     Nota:

     Para obtener más información sobre los entornos, consulta Puntos finales de la raíz del servicio Microsoft Graph y Graph Explorer.

   • Account - Provide the account used to impersonate a user. Specify the user principal name (UPN) of the account or shared mailbox that the system should use in the connection. This is required for the connection to be established.

6. Select Connect.
7. Autentícate con tu dirección de correo electrónico y contraseña de Microsoft.

Traiga su propia aplicación OAuth 2.0

Información general

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 el ID de cliente y el Secreto de cliente para crear una conexión con los conectores de Microsoft.

Ámbitos

• The connector requires the following minimum scopes to create a connection: openid, offline_access, User.Read, Mail.Read, and email.
• Outlook triggers require the following minimum scopes:
  • Para desencadenadores de buzón compartido: openid, offline_access, Mail.Read, Mail.Read.Shared.
  • Para eventos en calendarios: Calendars.Read.
  • Para eventos en calendarios compartidos: Calendars.Read.Shared.

The connector requires the following full set of scopes for all activities to function: User.Read, User.Read.All, 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, and offline_access.

To add more granular permissions, refer to the activities documentation.

Añadir la conexión de Microsoft Outlook 365

Para crear una conexión a tu instancia de Microsoft Outlook 365, realiza los siguientes pasos:

1. In Automation Cloud, select Integration Service from the rail menu.
2. From the Connectors list, select Microsoft Outlook 365. You can also use the search bar to narrow down the connector.
3. Select the Connect to Microsoft Outlook 365 button, which redirects you to the connection page.
4. Selecciona el tipo de autenticación Trae tu propia aplicación OAuth 2.0 .
5. Configura lo siguiente:
   • Client ID - You can find the ID in the Overview section of your Microsoft Azure application registration.
   • Client Secret - The client secret from the Certificates & secrets section of your Microsoft Azure application.
   • Tenant ID - The Microsoft Azure tenant ID for an app from the Overview section.
     Nota:

     • If you use a multi-tenant application, keep the default value 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.
   • Scope - Add or remove permissions for your connector.
   • Environment - Optionally, select an environment from the dropdown list:
     • Office 365 (predeterminado)
     • US Government L4 - Public Sector domain
     • US Government L5 - Public Sector domain
     • China Select Office 365 (default) for all regions, and only switch to Government or China for cloud deployments.
     Nota:

     Para obtener más información sobre los entornos, consulta Puntos finales de la raíz del servicio Microsoft Graph y Graph Explorer.

   • Shared mailbox - Add or remove permissions for your connector.

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 razones, como los tiempos de espera y las revocaciones. Para obtener más información, consulta la documentación oficial de Microsoft.

Nota:

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

Make sure to follow best practices from Microsoft when creating your OAuth applications. For full details on how to create a Microsoft OAuth app, check the Microsoft documentation.

This issue affects not only the OneDrive and SharePoint connector, but all Microsoft Graph-based connectors, such as Outlook or Teams.