Con el conector Microsoft® OneDrive®, puedes utilizar comandos en cadena para gestionar archivos y carpetas en Microsoft OneDrive o SharePoint®. Por ejemplo, con este conector, puedes:
- Copia, elimina y busca archivos y carpetas
- Descargar y subir archivos.
- Lista de unidades disponibles
Nota: Este conector ha sido creado por Workiva y conecta con un sistema de terceros. Aunque nuestro equipo de asistencia puede ayudarte a configurar este conector dentro de tu espacio de trabajo, no podemos solucionar ni ayudar de ningún otro modo con los problemas que se originen fuera de la plataforma Workiva.
Requisitos previos
Para habilitar la conexión, el conector utiliza la API Graph de Microsoft. Para asegurar la conexión, el conector utiliza la autenticación OAuth a través de una aplicación designada registrada en el portal de registro de aplicaciones de Microsoft o en Azure® Active Directory®.
Para configurar el conector, necesitarás:
- Una aplicación registrada en el portal de registro de aplicaciones de Microsoft o en Azure Active Directory. Registra tu ID de solicitud.
- ID y secreto de cliente OAuth de la aplicación Azure
- Ámbitos de la aplicación Azure, adecuados a los comandos que ejecutará el conector.
-
Tipo e ID de la unidad a conectar.
Nota : Puedes utilizar el Graph Explorer de Microsoft ( ) para recuperarlos desde SharePoint.
- URI de redireccionamiento del proyecto:
Ejemplo de configuración de Microsoft Azure para OneDrive
Registrar una aplicación
- Inicia sesión en tu Portal de Microsoft Azure:
https://azure.microsoft.com/en-us/account/ - Accede a los servicios de Azure Active Directory de .
- Accede a , en la sección «App Registrations» ( ), dentro de «Manage», y haz clic en « » (New Registration) .
- Introduce el nombre que desees para la aplicación « » y, a continuación, pulsa . Regístrate en .
Configurar la Autenticación de la Aplicación
- Inicia sesión en tu Portal de Microsoft Azure:
https://azure.microsoft.com/en-us/account/ - Accede a los servicios de Azure Active Directory de .
- Accede a , en la sección «Registros de aplicaciones» ( ), dentro de «Gestionar».
- Accede a « » (Autenticación) en el panel «Manage» (Gestionar) actualizado.
- En «Tipos de cuentas compatibles», selecciona «Cuentas de » en cualquier directorio de la organización (cualquier inquilino de Microsoft Entra ID - Multitenant) .
- En la sección «Añadir una plataforma», selecciona « » (Web) .
- En el campo « » (URI de redirección de ), , introduce la URL de devolución de llamada válida indicada anteriormente.
- Asegúrate de marcar la casilla « » (MultiTenant) en la sección « » (Tipos de cuentas admitidos) .
Nota: Como el conector OneDrive requiere que esté activada la opción MultiTenant, corresponde a los administradores de Azure asegurarse de que las aplicaciones están correctamente configuradas para el cumplimiento de la seguridad. Esta opción, cuando se utiliza correctamente con la seguridad Azure, no abre la aplicación a todo el mundo. A continuación se ofrecen sugerencias sobre las etapas adicionales que pueden darse.
- Consulta la documentación de Microsoft sobre el servicio « » ( ) relativa a la configuración multitenant.
- Activa la seguridad en la aplicación concreta siguiendo las instrucciones de Microsoft en sobre cómo restringir el acceso a tu aplicación a un grupo determinado de usuarios .
- Asigna o concede acceso a la aplicación a los usuarios siguiendo las instrucciones de Microsoft que se encuentran en , donde se explica cómo asignar la aplicación a usuarios y grupos: .
Configurar certificados y secretos
- Inicia sesión en tu Portal de Microsoft Azure:
https://azure.microsoft.com/en-us/account/ - Accede a los servicios de Azure Active Directory de .
- Accede a , en la sección «App Registrations» ( ), dentro de « » (Manage) ( ).
- Accede a « » (Certificados) en el panel actualizado « » (Gestionar) .
- Haz clic en « » (Nueva clave secreta de cliente) en el panel central.
- Tras introducir una breve descripción de « » ( ) y la fecha de caducidad de « » ( ), aparecerá un «Client Secret». Es necesario guardarlo para su custodia y para introducirlo en el conector de Microsoft OneDrive.
Establecer permisos de la API
- Inicia sesión en tu Portal de Microsoft Azure:
https://azure.microsoft.com/en-us/account/ - Accede a los servicios de Azure Active Directory de .
- Accede a , en la sección «App Registrations» ( ), dentro de « » (Manage) ( ).
- Accede a «Permisos de la API de » ( ) en el panel actualizado « » (Gestionar ).
- Haz clic en « » y añade un permiso « » en el panel central.
- Selecciona « » (Microsoft Graph) en « » (Microsoft APIs) .
- Selecciona « » (Permisos de delegado) como tipo de solicitud « » (Solicitar permiso) .
- De la lista de permisos, necesitarás:
User.Read, todo lo que aparece enFILESyOpenId.offline_access . - Haz clic en « » (Consentimiento de la administración de la subvención) .
- Define el nivel de acceso requerido por el conector. El conector de Microsoft OneDrive es compatible con los
siguientes ámbitos de :Archivos.LecturaEscritura.SeleccionadoArchivos.LecturaYEscritura.CarpetaDeAplicacionesArchivos.LecturaEscritura.TodosArchivos.LecturaEscrituraFiles.Read.SelectedFiles.Read.AllFiles.Readacceso sin conexión
Como mínimo, se requiere un ámbito de offline_access .
¿Por qué son necesarios Files.Read.All y Files.ReadWrite.All?
El conector de Workiva para OneDrive se comunica con tu entorno de Microsoft a través de la API de Microsoft Graph utilizando permisos delegados de OAuth, lo que significa que el conector se autentica y actúa en nombre de un usuario autenticado.
Por qué no se puede utilizar Sites.Selected
«Sites.Selected » es un permiso específico de SharePoint diseñado para flujos de acceso a nivel de aplicación (solo para aplicaciones); no es compatible con el modelo de permisos delegados que utiliza el conector de Workiva. Además, restringe el acceso únicamente a los sitios de SharePoint previamente aprobados, lo que impide que el conector realice operaciones dinámicas basadas en rutas, como «Buscar», «Copiar elemento» y «Eliminar elemento».
Habilitar la seguridad
- Inicia sesión en tu Portal de Microsoft Azure:
https://azure.microsoft.com/en-us/account/ - Accede a los servicios de Azure Active Directory de .
- Haz clic en « » (Aplicaciones empresariales) en Manage .
- Selecciona tu solicitud de la lista para iniciar el proceso de edición. Si tu aplicación no aparece en la lista por defecto, haz clic en « » (Todas las aplicaciones) , en « » (Gestionar) .
- Haz clic en « » (Propiedades) en « » (Gestionar) .
- En la pantalla « » (Propiedades) , configura las siguientes propiedades para permitir el uso del acceso a la API creado anteriormente:
¿Se permite a los usuarios iniciar sesión? = Sí
¿Es necesaria la asignación de usuarios? = Sí
(Opcional) ¿Visible para los usuarios? = No
- Haz clic en « », «Usuarios y grupos» ( ) en « », «Gestionar» ( ).
- Ahora puedes utilizar los procesos estándar de Azure AD para añadir usuarios según sea necesario. Esta
es la lista de usuarios que tienen permiso para utilizar OneDrive y disponen de una licencia válida de Microsoft OneDrive.
Establece el conector de Microsoft OneDrive
Nota: Para que el conector esté disponible para su uso en las cadenas de tu organización, un administrador de seguridad de la organización primero lo habilita desde Configuración.
- Desde Chain Builder , haz clic en Connections , a continuación, en Create en la esquina superior derecha.
- En « » (Conectores), en «Connection» (Conexión) , selecciona « » (Conexión de OneDrive de Microsoft) y el valor predeterminado «CloudRunner».
- En Información básica, ingresa un nombre único y una descripción para ayudar a identificar el conector.
- En OAuth, introduce el ID de cliente OAuth y el secreto de la aplicación Azure del conector.
- Para determinar el nivel de acceso del conector, introduce el ámbito de autenticación de la aplicación Azure .
Como mínimo, se requiere el ámbito «offline_access ». - Para autorizar la conexión y las credenciales OAuth, haz clic en Conecta.
-
En Propiedades, ingresa los detalles de la conexión:
Propiedad Detalles Tipo de accionamiento Selecciona el tipo de unidad a la que conectarte, como Unidad, Grupo, Usuario o Sitio. Para
conectarte a tu propia unidad de usuario, selecciona « » (Unidades de usuario) > «Current User (Me)» (Usuario actual [Yo]) > « » (Unidad de usuario).ID del tipo de unidad Introduce el ID de la unidad a la que te vas a conectar, según Tipo de unidad. Por ejemplo, si el tipo de unidad de ( ) es «Usuario», introduce el ID de usuario; si es «Sitio», introduce el ID del sitio. Nota: Puedes utilizar el Graph Explorer de Microsoft ( ) para recuperarlos desde SharePoint.
- Selecciona los entornos que vas a utilizar con la conexión y haz clic en Guardar.
- Para probar la conexión, crea y ejecuta una cadena con el comando Descargar de archivosdel conector, y comprueba que devuelve una salida válida.
Solución de problemas
Si falla la conexión a Microsoft OneDrive o SharePoint:
- Verifica que las credenciales OAuth de la aplicación Azure del conector están presentes, son correctas y válidas. Las credenciales de OAuth tienen fechas de caducidad definidas, y es posible que el certificado haya caducado. Si es así, tendrás que crear un nuevo certificado e introducir el nuevo secreto de cliente en el Conector. Consulta
Configuración de certificados y secretos para obtener más información sobre cómo crear un nuevo secreto. - Comprueba el Tipo de unidad y el ID introducidos para el conector. Puedes utilizar el Graph Explorer de Microsoft ( ) para recuperarlos de SharePoint.
- Verifica el URI de redireccionamiento del proyecto: