Autenticación de Microsoft OneDrive y SharePoint

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:

• Código de autorización OAuth 2.0 : se conecta a la aplicación pública de UiPath.
• Credenciales de cliente OAuth 2.0 : utiliza una cuenta de servicio.
• 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 la guía Cómo conectarse a las actividades de Microsoft 365 .

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 .

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.

Código de autorización OAuth 2.0

Ámbitos

El conector solicita los siguientes permisos o ámbitos: offline_access, Files.Read, Files.Read.All, Files.ReadWrite, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, profile, openid, email, User.Read.All o User.Read.

Añadir la conexión de Microsoft OneDrive y SharePoint

Para crear una conexión a tu instancia de Microsoft OneDrive y SharePoint, realiza los siguientes pasos:

1. Selecciona Integration Service en Automation Cloud^TM.

2. En la lista Conectores , selecciona Microsoft OneDrive y SharePoint. También puedes utilizar la barra de búsqueda para acotar el conector.
3. Selecciona el botón Conectar a Microsoft OneDrive y SharePoint .
4. Ahora se le redirige a la página de conexión.
5. Selecciona el tipo de autenticación Código de autorización OAuth 2.0 .
6. Añade los permisos necesarios en el campo Ámbito .
7. Selecciona un entorno de la lista desplegable: Office 365 (predeterminado), Gobierno de EE. UU. L4 - Dominio del sector público, Gobierno de EE. UU. L5 - Dominio del sector público o China.
   Nota: Para obtener más información sobre los entornos, consulta Puntos finales de la raíz del servicio de Microsoft Graph y Graph Explorer.
8. Selecciona Conectar y autenticar 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 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.

Credenciales de cliente OAuth 2.0

Ámbitos

Ámbitos mínimos para crear una conexión: User.Read.All o User.Read, Files.Read.

Añadir la conexión de Microsoft OneDrive y SharePoint

Para crear una conexión a tu instancia de Microsoft OneDrive y SharePoint, realiza los siguientes pasos:

1. Selecciona Integration Service en Automation Cloud^TM.

2. En la lista Conectores , selecciona Microsoft OneDrive y SharePoint. También puedes utilizar la barra de búsqueda para acotar el conector.
3. Selecciona el botón Conectar a Microsoft OneDrive y SharePoint .
4. Ahora se le redirige a la página de conexión.
5. Selecciona el tipo de autenticación Credenciales de cliente OAuth 2.0 .
6. Rellena y configura los siguientes campos: ID de cliente, Secreto de cliente, ID de tenant, Entorno y Cuenta (proporciona la cuenta utilizada para suplantar a un usuario).
7. Seleccione Conectar.

Traiga su propia aplicación OAuth 2.0

Información general

Para aprender a crear una aplicación, consulta la documentación oficial de Microsoft: 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

Cuando crees tu propia aplicación para usarla con Integration Service, asegúrate de cumplir los siguientes requisitos:

1. Configura la aplicación como una aplicación multitenant o monotenant .
2. Configura una aplicación web .
3. Configura 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.

Ámbitos

• Ámbitos mínimos para crear una conexión: openid, offline_access, User.Read.All o User.Read, Files.Read.
• Lista mínima de ámbitos necesarios para los desencadenadores de OneDrive:
  • openid, offline_access, User.Read.All o User.Read, Sites.Read.All : para eventos en sitios de SharePoint.
  • Group.Read.All : para eventos en grupos y calendarios.
  • Files.Read.All : para todos los tipos de eventos restantes.

Añadir la conexión de Microsoft OneDrive y SharePoint

Para crear una conexión a tu instancia de Microsoft OneDrive y SharePoint, realiza los siguientes pasos:

1. Selecciona Integration Service en Automation Cloud^TM.

2. En la lista Conectores , selecciona Microsoft OneDrive y SharePoint. También puedes utilizar la barra de búsqueda para acotar el conector.
3. Selecciona el botón Conectar a Microsoft OneDrive y SharePoint .
4. Ahora se le redirige a la página de conexión.
5. Selecciona el tipo de autenticación Trae tu propia aplicación OAuth 2.0 .
6. Rellena y configura los siguientes campos: ID de cliente, Secreto de cliente, Ámbito, ID de tenant y Entorno.
   Nota:

   • Para Ámbito, añade los permisos que puedas necesitar para interactuar con diferentes actividades. Consulta la documentación de las actividades para saber qué ámbitos requieren.
   • Si utilizas una aplicación multitenant, mantén el valor predeterminado para el ID de tenant (common). Si utilizas una aplicación de un solo tenant, recupera el ID de tenant de Azure. Consulta Cómo encontrar tu ID de tenant de Microsoft Entra.
7. Seleccione Conectar.

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.