Autenticación de Microsoft OneDrive y SharePoint

Conecta UiPath a Microsoft OneDrive y SharePoint utilizando la autenticación de certificado de cliente, el código de autorización OAuth 2.0 u otras opciones de autenticación basadas en Microsoft Graph.

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:

• Autenticación de certificado de cliente : se conecta utilizando un certificado de cliente en lugar de un secreto de cliente.
• Código de autorización OAuth 2.0 : se conecta a la aplicación pública de UiPath.
• Credenciales de cliente OAuth 2.0 : se conecta utilizando una cuenta de servicio.
• Traiga su propia aplicación OAuth 2.0 : se conecta a una aplicación privada que cree.

Al registrar tu aplicación en Microsoft Azure, utiliza el tipo de permiso que corresponda a tu método de autenticación:

Tipo de Autenticación	Tipo de permiso de Microsoft
Autenticación de certificado del cliente	Aplicación
Código de autorización OAuth 2.0	Delegado
Credenciales de cliente OAuth 2.0	Aplicación
Traiga su propia aplicación OAuth 2.0	Delegado

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 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 del administrador antes de que los usuarios puedan conectarse a aplicaciones externas. 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.

Si tu organización exige el consentimiento del administrador, puedes encontrar un error durante la creación de la conexión que indique que la aplicación necesita permiso para acceder a los recursos de tu organización, y que solo un administrador puede otorgar ese acceso. Este error no se debe a un problema del producto, requiere la acción de su administrador de Azure.

Para obtener información general, 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.

Solicitando la aprobación del administrador

Si te encuentras con el error, envía una solicitud de aprobación directamente desde la pantalla de inicio de sesión de Microsoft:

1. En la pantalla Aprobación requerida , introduce una justificación empresarial en el campo Motivo de la solicitud de acceso.
2. Selecciona Solicitar aprobación.

Tu administrador recibe la solicitud por correo electrónico y puede revisarla en el centro de administración de Microsoft Entra.

Aprobar la solicitud (admin)

Requisitos previos

• Tienes el rol de Administrador global, Administrador de aplicaciones o Administrador de aplicaciones en la nube en Microsoft Entra ID.

Para aprobar una solicitud de consentimiento de administrador pendiente:

1. Inicia sesión en el centro de administración de Microsoft Entra.
2. Ve a Entra ID y luego a Aplicaciones empresariales.
3. En Actividad, en la navegación izquierda, selecciona Solicitudes de consentimiento de administrador.
4. Selecciona la pestaña Mis solicitudes pendientes y, a continuación, selecciona la solicitud pendiente de la lista.
5. Revisa los permisos que solicita la aplicación.
6. Selecciona Revisar permisos y consentimiento para ver los permisos que se solicitan y, a continuación, selecciona Aceptar para conceder el consentimiento.
7. Para rechazar, selecciona Denegar y proporciona una justificación.

El usuario que envió la solicitud es notificado de la decisión.

Para obtener más información sobre el proceso de aprobación, consulta Revisar las solicitudes de consentimiento del administrador 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 determinada. Si compartes la conexión, cada cambio realizado con esa conexión se realiza en nombre de ese usuario.

Si quieres que el usuario de conexión sea el mismo que el usuario autenticado, aplica una de las siguientes opciones:

• Selecciona la opción Consentimiento en nombre de tu organización durante el proceso de consentimiento.
• Actualiza la configuración de consentimiento en Microsoft Entra ID después de que se haya registrado la aplicación. Esto es necesario para que la configuración de consentimiento coincida con la configuración cuando un administrador otorga consentimiento en nombre de la organización. A continuación, puedes volver a crear la conexión.

Autenticación de certificado del cliente

Ámbitos

El conector requiere el siguiente conjunto completo de ámbitos para que todas las actividades funcionen: 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, User.Read.

Para añadir permisos más granulares, consulta la documentación de las actividades.

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 Orchestrator en el lanzador de productos.

2. Selecciona una carpeta y luego navega a la pestaña Conexiones .

3. Selecciona Añadir conexión.

4. Para abrir la página de creación de conexiones, selecciona el conector de la lista. Puedes utilizar la barra de búsqueda para encontrar el conector.

5. Selecciona el tipo de autenticación Autenticación de certificado de cliente .

6. Configure los siguientes campos:

   • ID de cliente : puedes encontrar el ID en la sección Información general del registro de tu aplicación de Microsoft Azure.

   • Contraseña para el certificado : la contraseña que estableces durante la creación del certificado.

   • Certificado de cliente OAuth base64 : el certificado de cliente se genera en un archivo .pfx que debes convertir a formato codificado en Base64 y proporcionarlo en este campo.

   • ID de tenant : puedes encontrar el ID de tenant de Microsoft Azure para una aplicación en la sección Información general del registro de tu aplicación de Microsoft Azure.

   • Entorno : opcionalmente, 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
     • China Selecciona Office 365 (predeterminado) para todas las regiones, y solo cambia a Gobierno o China para implementaciones en la nube.
     Nota:

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

   • Cuenta : introduce el nombre principal de usuario (UPN) de la cuenta o buzón de correo compartido que el sistema debe utilizar en la conexión. Esto es necesario para que se establezca la conexión.

7. Select Connect.

   Cuando esté disponible, selecciona el menú junto a un campo y elige Usar activo de credenciales o Usar activo de Orchestrator para hacer referencia a un activo de Orchestrator en lugar de introducir el valor directamente. Para obtener más información, consulta Usar activos de credenciales para las conexiones.

8. Autentícate con tu dirección de correo electrónico y contraseña de Microsoft.

Código de autorización OAuth 2.0

Ámbitos

Ámbitos obligatorios: openid, email, offline_access, Files.Read.

El conector requiere los siguientes ámbitos mínimos para crear una conexión: openid, offline_access, email y Files.Read.

El conector requiere el siguiente conjunto completo de ámbitos para que todas las actividades funcionen: 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, User.Read.

Para añadir permisos más granulares, consulta la documentación de las actividades.

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 Orchestrator en el lanzador de productos.
2. Selecciona una carpeta y luego navega a la pestaña Conexiones .
3. Selecciona Añadir conexión.
4. Para abrir la página de creación de conexiones, selecciona el conector de la lista. Puedes utilizar la barra de búsqueda para encontrar el conector.
5. Selecciona el tipo de autenticación Código de autorización OAuth 2.0 .
6. Configura lo siguiente:
   • Ámbito : opcionalmente, añade o elimina permisos para tu conector.
   • Entorno : opcionalmente, 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
     • China Selecciona Office 365 (predeterminado) para todas las regiones, y solo cambia a Gobierno o China para implementaciones en la nube.
     Nota:

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

7. Select Connect.
8. 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. Las automatizaciones no pueden ejecutarse sin arreglar 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

El conector requiere el siguiente conjunto completo de ámbitos para que todas las actividades funcionen: 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, User.Read.

Para añadir permisos más granulares, consulta la documentación de las actividades.

Para limitar la aplicación a sitios de SharePoint específicos en lugar de conceder permisos para todo el tenant, consulta Restringir el acceso a sitios de SharePoint específicos.

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 Orchestrator en el lanzador de productos.

2. Selecciona una carpeta y luego navega a la pestaña Conexiones .

3. Selecciona Añadir conexión.

4. Para abrir la página de creación de conexiones, selecciona el conector de la lista. Puedes utilizar la barra de búsqueda para encontrar el conector.

5. Selecciona el tipo de autenticación Credenciales de cliente OAuth 2.0 .

6. Configura lo siguiente:

   • ID de cliente : puedes encontrar el ID en la sección Información general del registro de tu aplicación de Microsoft Azure.

   • Secreto de cliente : el secreto de cliente de la sección Certificados y secretos de tu aplicación Microsoft Azure.

   • ID de tenant : el ID de tenant de Microsoft Azure para una aplicación de la sección Información general.

   • Entorno : opcionalmente, 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
     • China Selecciona Office 365 (predeterminado) para todas las regiones, y solo cambia a Gobierno o China para implementaciones en la nube.
     Nota:

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

   • Cuenta : proporciona la cuenta utilizada para suplantar a un usuario.

7. Select Connect.

   Cuando esté disponible, selecciona el menú junto a un campo y elige Usar activo de credenciales o Usar activo de Orchestrator para hacer referencia a un activo de Orchestrator en lugar de introducir el valor directamente. Para obtener más información, consulta Usar activos de credenciales para las conexiones.

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 de Tenant único .
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 obligatorios: openid, email, offline_access, Files.Read.
• El conector requiere los siguientes ámbitos mínimos para crear una conexión: openid, offline_access, email y Files.Read.
• Los desencadenadores de OneDrive requieren los siguientes ámbitos mínimos:
  • Para eventos en sitios de SharePoint: openid, offline_access y User.Read.All o User.Read y Sites.Read.All. Para usar Sites.Selected en lugar de Sites.Read.All, consulta Restringir el acceso a sitios de SharePoint específicos.
  • Para eventos en grupos y calendarios: Group.Read.All
  • Para todos los tipos de eventos restantes: Files.Read.All

El conector requiere el siguiente conjunto completo de ámbitos para que todas las actividades funcionen: 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, User.Read.

Para añadir permisos más granulares, consulta la documentación de las actividades.

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 Orchestrator en el lanzador de productos.

2. Selecciona una carpeta y luego navega a la pestaña Conexiones .

3. Selecciona Añadir conexión.

4. Para abrir la página de creación de conexiones, selecciona el conector de la lista. Puedes utilizar la barra de búsqueda para encontrar el conector.

5. Selecciona el tipo de autenticación Trae tu propia aplicación OAuth 2.0 .

6. Configura lo siguiente:

   • ID de cliente : puedes encontrar el ID en la sección Información general del registro de tu aplicación de Microsoft Azure.
   • Secreto de cliente : el secreto de cliente de la sección Certificados y secretos de tu aplicación Microsoft Azure.
   • Ámbito : opcionalmente, añade o elimina permisos para tu conector.
   • ID de tenant : el ID de tenant de Microsoft Azure para una aplicación de la sección Información general.
     Nota:

     • Si utilizas una aplicación multitenant, mantén el valor predeterminado común.
     • Si utilizas una aplicación de tenant único, recupera el ID de tenant de Azure. Para obtener más información, consulta Cómo encontrar tu ID de tenant de Microsoft Entra.
   • Entorno : opcionalmente, 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
     • China Selecciona Office 365 (predeterminado) para todas las regiones, y solo cambia a Gobierno o China para implementaciones en la nube.
     Nota:

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

7. Select Connect.

   Cuando esté disponible, selecciona el menú junto a un campo y elige Usar activo de credenciales o Usar activo de Orchestrator para hacer referencia a un activo de Orchestrator en lugar de introducir el valor directamente. Para obtener más información, consulta Usar activos de credenciales para las conexiones.

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. Las automatizaciones no pueden ejecutarse sin arreglar 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 oficial 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.

Restringir el acceso a sitios de SharePoint específicos

Si tu organización no permite permisos para todo el tenant como Sites.Read.All o Files.Read.All, utiliza el permiso Sites.Selected de Microsoft Graph en su lugar. Con Sites.Selected, la aplicación puede acceder solo a los sitios de SharePoint que un administrador de SharePoint le otorga explícitamente.

Para obtener más información sobre cómo funciona Sites.Selected , consulta Descripción general de los permisos seleccionados en OneDrive y SharePoint en la documentación de Microsoft.

Tipos de autenticación compatibles

Tipo de Autenticación	Permiso para añadir al registro de la aplicación	Otros ámbitos necesarios
Credenciales de cliente OAuth 2.0	Sites.Selected (Aplicación)	Ninguno
Traiga su propia aplicación OAuth 2.0	Sites.Selected (Delegado)	Los ámbitos obligatorios: openid, email, offline_access, Files.Read

Con Trae tu propia aplicación OAuth 2.0, la conexión solo puede acceder a los sitios a los que tienen acceso tanto la aplicación como el usuario que ha iniciado sesión.

Requisitos previos

• Un administrador de Microsoft Entra ID ha concedido el consentimiento de administrador para el permiso Sites.Selected .
• Un administrador de SharePoint ha concedido acceso a la aplicación a cada sitio de SharePoint que utilizan tus automatizaciones, a través de una solicitud POST /sites/{site-id}/permissions en Microsoft Graph. Para obtener el formato de la solicitud y los permisos necesarios para enviarla, consulta Crear permiso en la documentación de Microsoft.
• El rol otorgado en el sitio coincide con lo que hacen sus automatizaciones. El rol read es suficiente para leer archivos y utilizar desencadenadores de eventos. Las actividades que crean o modifican archivos necesitan el rol write .

Seleccione una ubicación de SharePoint con Sites.Seleccionado

Microsoft Graph no devuelve una lista de sitios a una aplicación que solo tiene el permiso Sites.Selected . Como resultado, cuando buscas una ubicación, la carpeta Bibliotecas de documentos de SharePoint está vacía. Cuando esté disponible, introduce la URL de la ubicación en su lugar.

Donde se selecciona la ubicación	Entrada de URL disponible
Desencadenadores desconectados (desencadenadores de eventos creados en Orchestrator)	Disponible. Consulta Desencadenadores desconectados.
Desencadenadores conectados (actividades de desencadenador en un proceso)	Disponible. Consulta Desencadenadores conectados.
Índices de contextualización	No disponible

En todos los casos, utiliza la URL de una biblioteca de documentos o una carpeta, por ejemplo https://example.sharepoint.com/sites/example/Shared%20Documents. La URL del sitio en sí, como https://example.sharepoint.com/sites/example, no se puede resolver.

Desencadenadores desconectados

Para introducir la URL de ubicación de un desencadenador desconectado:

1. En el campo En la ubicación del desencadenador de evento, selecciona el menú junto al campo y luego selecciona Introducir URL.
2. Pegue la URL de una biblioteca de documentos o una carpeta en un sitio al que tenga acceso la aplicación.
3. Selecciona Validar.

Nota:

Si Validar no se muestra, la URL se resuelve cuando pasas a otro campo.

La URL se reemplaza por el ID de la unidad y el ID del elemento de la ubicación.

Desencadenadores conectados

Al diseñar el proceso, la propiedad de ubicación de la actividad del desencadenador ofrece la misma opción Introducir URL .

Para establecer o cambiar la ubicación de un proceso implementado:

1. En Orchestrator, edita el proceso.
2. Ve al paso Requisitos del paquete .
3. Expande la entrada Desencadenador de eventos en la conexión de Microsoft OneDrive & SharePoint.
4. En el campo En la ubicación , selecciona el menú junto al campo y luego selecciona Introducir URL.
5. Pegue la URL de una biblioteca de documentos o una carpeta en un sitio al que tenga acceso la aplicación.
6. Selecciona Validar.

Nota:

Si Validar no se muestra, la URL se resuelve cuando pasas a otro campo.

La URL se reemplaza por el ID de la unidad y el ID del elemento de la ubicación.

Solución de problemas de Sites.Conexiones seleccionadas

La carpeta Bibliotecas de documentos de SharePoint está vacía

Síntoma: al buscar una ubicación, la carpeta Bibliotecas de documentos de SharePoint está vacía o aparece el mensaje No hay elementos en la ruta actual .

Causa: la aplicación solo tiene el permiso Sites.Selected , por lo que Microsoft Graph no enumera los sitios. Este es el comportamiento esperado.

Acción: introduce la URL de la ubicación, como se describe en Seleccionar una ubicación de SharePoint con Sites.Selected.

Error al resolver la URL compartida (código de estado 403)

Síntoma: después de introducir la URL de la ubicación, aparece el error No se pudo resolver la URL compartida: la solicitud falló con el código de estado 403 .

Causa: no se ha concedido acceso al sitio a la aplicación. Con Trae tu propia aplicación OAuth 2.0, es posible que el usuario que ha iniciado sesión tampoco tenga acceso al sitio.

Acción: pide a tu administrador de SharePoint que conceda acceso a la aplicación al sitio y confirma que el usuario que ha iniciado sesión puede abrir el sitio.