Autenticación de Microsoft OneDrive y SharePoint

Requisitos previos

Dependiendo del tipo de autenticación que selecciones, necesitarás uno de los siguientes:

• La dirección de correo electrónico y la contraseña de tu cuenta de Microsoft.
• El ID de cliente y el Secreto de cliente de tu aplicación, los Ámbitos y el ID de tenant.

Además, debe conceder permisos a las aplicaciones de terceros para que accedan a su información. En caso de error, póngase en contacto con su administrador de Microsoft OneDrive y SharePoint.

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.

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

Conceder permisos a aplicaciones de terceros

Antes de establecer la conexión, asegúrate de que se conceden permisos para las aplicaciones integradas, como se explica en la documentación oficial de Microsoft: Configurar los ajustes de consentimiento del usuario.

Ámbitos

El conector solicita los siguientes á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.

Esto representa la lista completa de ámbitos necesarios.

Nota: Colabore con su equipo de TI para conceder estos privilegios a su usuario y aplicación.

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

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

1. Selecciona Integration Service en Sector público de 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 & SharePoint .
4. Ahora se te redirige a la página de conexión. Puedes elegir entre dos tipos de autenticación: Código de autorización OAuth 2.0 o Trae tu propia aplicación OAuth 2.0.
   • Si seleccionas Código de autorización OAuth 2.0, haz clic en Conectar y, a continuación, autentícate con tu dirección de correo electrónico y contraseña de Microsoft.
   • Si seleccionas Traer tu propia aplicación OAuth 2.0, debes proporcionar un ID de cliente y un Secreto de cliente, el ID de tenant y los ámbitos que puedas necesitar para interactuar con diferentes actividades. Consulta la documentación de las actividades para ver qué ámbitos requieren.
     Nota: si utilizas una aplicación multitenant, mantén el valor predeterminado para el ID de tenant (common). Si utilizas una aplicación de tenant único, recupera el ID de tenant de Azure. Consulta Cómo encontrar tu ID de tenant de Microsoft Entra.
5. Se ha agregado su conexión.

Traiga su propia aplicación OAuth 2.0

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

• Código de autorización OAuth 2.0: que se conecta a la aplicación pública de UiPath.
• Traiga su propia aplicación OAuth 2.0, que se conecta a una aplicación privada que cree.

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 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://govcloud.uipath.us/provisioning_/callback.
3. Debes configurar los permisos delegados. Para obtener más información, consulta Permisos en la documentación oficial de Microsoft.
   Nota: 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, ve a 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 sobre la caducidad del token.

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 2.0, consulta la documentación de Microsoft.

Nota: Este problema afecta a todos los conectores basados en Microsoft Graph.