Autenticación de Microsoft OneDrive y SharePoint

Requisitos previos

You need the following credentials:

• Bring your own OAuth 2.0 app: Application Client ID and Client secret, Scopes, and Tenant ID

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

Para obtener más información, consulta Puntos finales de servicio de Microsoft Graph y Graph Explorer.

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.

Ámbitos

El conector solicita los siguientes permisos/ámbitos:

• Traiga su propia aplicación OAuth 2.0:
  • Ámbitos mínimos para crear una conexión: openid, offline_access, User.Read.All, Files.Read.
  • Lista mínima de ámbitos necesarios para los desencadenadores de OneDrive:
    • openid, offline_access, User.Read.All, 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.

Nota: Si te autenticas utilizando Trae tu propia aplicación OAuth 2.0, te beneficiarás de forma predeterminada de los ámbitos configurados en la creación de la aplicación. Si quieres utilizar los permisos de aplicación predeterminados, puedes declarar un ámbito common . Esto significa que solo utilizas los permisos configurados para esa aplicación en Azure. También puedes declarar ámbitos adicionales en la creación de la conexión, utilizando el campo Ámbitos . A continuación, se te pedirá que concedas el consentimiento adicional durante el inicio de sesió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. Select Integration Service from Automation Suite.

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 le redirige a la página de conexión.
   Enter the required credentials. You must provide a Client ID and Client secret, the Tenant ID, and the Scopes you may need to interact with different activities. Check out the activities' documentation to see what scopes they require. If you are using a multitenant application, keep the default value for the Tenant ID (common). If you are using a single tenant application, retrieve the Tenant ID from Azure. Refer to How to find your Microsoft Entra tenant ID.

5. Se ha agregado su conexión.

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. You must configure a Web Redirect URI. The Redirect URI (or callback URL) for your OAuth 2.0 application is provided in the authentication screen when creating a connection: https://{yourDomain}/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 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.