Skip to main content

SharePoint en Waidok: elementos necesarios para la conexión

Para que Waidok pueda conectarse con SharePoint y subir documentos, es necesario registrar previamente una aplicación en el tenant de Microsoft Entra ID del cliente.

1. Requisitos previos

La configuración debe realizarla un administrador del tenant del cliente con permisos para:

  • Registrar aplicaciones en Microsoft Entra ID.
  • Asignar permisos de acceso a Microsoft Graph o SharePoint.
  • Conceder el consentimiento de administrador para los permisos solicitados.
  • Acceder y configurar el sitio de SharePoint de destino.

2. Registro de la aplicación en Microsoft Entra ID

Debe registrarse una aplicación en el tenant de Microsoft Entra ID, anteriormente denominado Azure Active Directory, del cliente.

Esta aplicación será utilizada por Waidok para autenticarse y acceder al sitio de SharePoint.

Durante la configuración será necesario obtener los siguientes valores:

Dato Descripción
Tenant ID Identificador único del tenant de Microsoft Entra ID donde se encuentra el SharePoint.
Client ID Identificador de la aplicación registrada. También puede aparecer como Application (client) ID.
Client Secret Valor del secreto generado para la aplicación.
Importante: debe facilitarse el valor del Client Secret, no el identificador interno del secreto. El valor solo se muestra una vez, justo después de crearlo.

3. Permisos requeridos

La aplicación registrada debe disponer de los siguientes permisos:

  • Files.ReadWrite.All
  • Sites.ReadWrite.Allwaidok_sharepoint.png
Nota: dependiendo del tipo de permisos configurado, puede ser necesario que un administrador del tenant conceda el consentimiento mediante la opción Grant admin consent.

4. Configuración del módulo de SharePoint en Waidok

Una vez registrada la aplicación y concedidos los permisos, deben configurarse las siguientes claves en el módulo de SharePoint de Waidok:

Clave Obligatoria Descripción
TenantId Sí Identificador del tenant de Microsoft Entra ID donde se encuentra el sitio de SharePoint.
ClientId Sí Identificador de la aplicación registrada en Microsoft Entra ID.
ClientSecret Sí Valor del secreto generado para la aplicación.
SiteUrl Sí URL completa del sitio de SharePoint. Debe incluir la ruta del sitio.
Library Sí Nombre de la biblioteca de documentos donde se subirán los ficheros.
Path No Ruta interna opcional dentro de la biblioteca donde se guardarán los documentos.

Ejemplo de SiteUrl

https://7l5t7p.sharepoint.com/sites/Upload

La propiedad SiteUrl no debe contener únicamente el dominio general de SharePoint. Debe incluir también la ruta concreta del sitio, por ejemplo /sites/Upload.

Ejemplo de configuración

{
  "TenantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "ClientId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "ClientSecret": "valor-del-secreto-generado",
  "SiteUrl": "https://7l5t7p.sharepoint.com/sites/Upload",
  "Library": "Documentos compartidos",
  "Path": "Waidok/Documentos"
}

5. Información que debe facilitar el cliente

Para completar la configuración en Waidok, el cliente deberá proporcionar:

  • Tenant ID.
  • Client ID de la aplicación registrada.
  • Valor del Client Secret.
  • URL completa del sitio de SharePoint.
  • Nombre exacto de la biblioteca documental.
  • Ruta de destino dentro de la biblioteca, cuando corresponda.

6. Comprobaciones recomendadas

Antes de dar por finalizada la configuración, deben realizarse las siguientes comprobaciones:

  • Verificar que el secreto no ha caducado.
  • Confirmar que se ha copiado el valor del secreto y no su identificador.
  • Comprobar que los permisos requeridos están asignados.
  • Confirmar que se ha concedido el consentimiento de administrador.
  • Validar que la URL del sitio incluye la ruta completa.
  • Comprobar que el nombre de la biblioteca coincide exactamente con el existente en SharePoint.
  • Realizar una prueba de subida de un documento desde Waidok.
Seguridad: el Client Secret debe tratarse como una credencial sensible. No debe enviarse por canales públicos, incluirse en capturas de pantalla ni almacenarse en documentación accesible sin restricciones.

No comments to display

Back to top