Conector de conocimientos de archivos de SharePoint

Presentación

Conecte bibliotecas de documentos de SharePoint para que su contenido se convierta en conocimientos que se pueda buscar en Docebo.

Este conector sincroniza archivos almacenados en bibliotecas de documentos de SharePoint con Docebo Knowledge, de modo que su contenido se pueda buscar y utilizar con asistentes y agentes de IA. Solo incluye archivos; no páginas de sitios, listas ni otros contenidos del sitio.

1. Información básica

Contenido que se sincroniza

Contenido que se extrae

Tipos de archivos compatibles para la extracción de contenido

Los archivos de más de 50 MB se sincronizan solo con sus metadatos; su contenido no se analiza.

Está previsto un conector independiente de SharePoint Sites, que incluirá páginas de sitios y otro contenido del sitio, en lugar de archivos. Este conector solo incluye archivos.

2. Requisitos previos en el sistema de origen

Rol necesario

Necesitará uno de estos roles de Microsoft Entra ID (Azure AD) para completar la configuración:

• Administrador global, o
• Administrador de aplicaciones o Administrador de aplicaciones en la nube, combinado con un rol que pueda conceder el consentimiento del administrador (por ejemplo, Administrador de roles con privilegios)

También necesita acceso como Propietario del sitio o Administrador de SharePoint en cada sitio que desee sincronizar.

Configuración necesaria

Las bibliotecas de documentos que desee sincronizar no deberán estar protegidas por una etiqueta de confidencialidad de Microsoft Purview ni por una directiva de Information Rights Management (IRM) que bloquee la extracción de contenido basada en API.

Las directivas de acceso condicional no deben impedir que la entidad de servicio de la aplicación acceda a Microsoft Graph.

3. Preparación en el sistema de origen

Crear el registro de la aplicación

Inicie sesión en el portal de Azure y vaya a Microsoft Entra ID → Registros de aplicaciones → Nuevo registro. Asigne un nombre a la aplicación (por ejemplo, "Conector de conocimientos de Docebo"), mantenga Tipos de cuentas compatibles configurado como inquilino único y establezca ahora el URI de redireccionamiento: elija Web e introduzca la URL de devolución de llamada. Si lo hace durante el registro, se ahorrará un paso más adelante. La URL siempre sigue este patrón: https://[YOUR-DOCEBO-PLATFORM-URL]/knowledge/v1/integrations/connections/callback; por ejemplo, https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback. Seleccione Registrar.

Registro de una aplicación con el URI de redireccionamiento ya introducido.

Asignar permisos de API

Abra la aplicación → Permisos de API → Agregar un permiso y añada los permisos siguientes tanto de Microsoft Graph como de SharePoint. Cuando los haya añadido todos, seleccione Conceder el consentimiento del administrador para aprobarlos de una sola vez.

Microsoft Graph

SharePoint

Permisos configurados: permisos de Microsoft Graph y SharePoint, todos concedidos.

Agregar un secreto del cliente

Vaya a Certificados y secretos → Nuevo secreto del cliente. Introduzca una descripción y una fecha de caducidad, y seleccione Agregar. Una vez creado, copie el valor que aparece en la columna Valor, no el de la columna Id. de secreto, que tiene un aspecto similar, pero no funcionará para la autenticación. No podrá volver a ver el valor cuando abandone esta página.

Los secretos de clientes caducan según el plazo que establezca aquí. Si un secreto caduca y no se reemplaza antes, la conexión de SharePoint deja de funcionar. Configure un recordatorio antes de la fecha de caducidad.

Adición de un secreto del cliente con una descripción y una fecha de caducidad configuradas.

Agregar un certificado

El acceso directo a la API de SharePoint requiere un certificado además de un secreto. Genere un certificado autofirmado y una clave privada con OpenSSL:

openssl req -x509 -newkey rsa:2048 -keyout sharepoint-key.pem -out sharepoint-cert.pem -days 180 -nodes -subj "/CN=my-custom-cn"

cat sharepoint-key.pem | pbcopy

También puede usar la funcionalidad integrada para crear el certificado y la clave privada.

Esto crea sharepoint-cert.pem (el certificado) y sharepoint-key.pem (la clave privada), y copia la clave privada al portapapeles. Vaya a Certificados y secretos → Certificados → Cargar certificado y cargue sharepoint-cert.pem. Una vez cargado, anote la Huella digital que aparece en la lista; la necesitará en Docebo junto con la clave privada que acaba de copiar.

Pestaña Certificados que muestra el certificado cargado y su huella digital.

4. Acciones necesarias en Docebo

Autorizar el conector

1. Vaya a Complementos e integraciones → Conectores de conocimientos → Crear → SharePoint - Archivos. Este menú solo es visible para los Superadministradores.
2. Introduzca el Id. de directorio (inquilino) y la URL de su sitio de SharePoint, sin el prefijo https:// ni una barra diagonal final.

Conectar SharePoint - Archivos, con los campos Id. de inquilino y URL de SharePoint.

3. Introduzca el Id. de cliente, el secreto del cliente, la huella digital del certificado y la clave privada de su aplicación de Azure, y seleccione Conectar.

Conectar SharePoint - Archivos, con los campos Id. de cliente, Secreto de cliente, Huella digital del certificado y Clave privada.

4. Conceda el consentimiento en la ventana emergente de Microsoft.
5. En la pantalla de ámbito, seleccione los sitios desde los que desee que estén disponibles los archivos para agregarlos posteriormente a las colecciones de conocimientos y, después, guarde la selección.

Selección del ámbito: elección de los sitios cuyos archivos se sincronizarán.