Presentación
Conecte sitios de SharePoint, páginas web y elementos de noticias para que su contenido se convierta en conocimiento recuperable en Docebo.
Este conector sincroniza el contenido de sitios y páginas web, así como los elementos de noticias almacenados en los sitios de SharePoint seleccionados, con Docebo Knowledge, de modo que dicho contenido pueda buscarse y utilizarse mediante asistentes y agentes de IA. Solo incluye páginas de sitios, listas u otro contenido de sitios. Existe un conector específico para archivos de SharePoint.
1. Información básica
Contenido que se sincroniza
| Tipo de contenido | Estado | Nota |
|---|---|---|
| Sitios | Sincronizado | |
| Páginas web | Sincronizado | |
| Noticias y anuncios | Sincronizado | |
| Archivos en bibliotecas de documentos | No sincronizado | Incluido en el conector de archivos de SharePoint |
Contenido que se extrae
| Contenido | Estado |
|---|---|
| Título del sitio y texto principal | Extraído |
| Listas y elementos incluidos | Extraído |
| Textos de noticias y anuncios | Extraído |
| Nombre, URL y jerarquía del sitio (metadatos) | Extraído |
2. Requisitos previos en el sistema de origen
Rol necesario
Necesita uno de los siguientes 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 políticas 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: seleccione 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, vaya a Permisos de API → Añadir 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
| Permiso | Tipo | Descripción |
|---|---|---|
| Group.Read.All | Aplicación | Leer todos los grupos |
| GroupMember.Read.All | Aplicación | Leer todas las pertenencias a grupos |
| Sites.Read.All | Aplicación | Leer elementos de todas las colecciones de sitios |
| User.Read.All | Aplicación | Leer los perfiles completos de todos los usuarios |
SharePoint
| Permiso | Tipo | Descripción |
|---|---|---|
| Sites.Read.All | Aplicación | Leer elementos de todas las colecciones de sitios |
Añadir un secreto del cliente
Vaya a Certificados y secretos → Nuevo secreto del cliente. Asígnele una descripción y una fecha de expiración y, a continuación, seleccione Añadir. 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.
Añadir un certificado
El acceso directo a la API de SharePoint requiere un certificado además de un secreto.
Se recomienda utilizar la funcionalidad integrada para que el certificado y la clave privada se creen automáticamente haciendo clic en el botón Generar certificado.
Esto crea sharepoint-cert.pem —el certificado— y completa automáticamente los campos Huella digital del certificado y Clave privada. Solo tendrá que añadir el certificado al registro de la aplicación en Certificados y secretos → Certificados → Cargar certificado y cargar sharepoint-cert.pem.
Pestaña Certificados que muestra el certificado cargado y su huella digital.
Como alternativa, puede generar 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
Esto también genera la clave privada y el certificado, pero deberá asegurarse de copiar manualmente la clave privada en el campo correspondiente y copiar la Huella digital después de cargar el certificado en el registro de la aplicación para introducirla también en el campo correspondiente.
4. Acciones necesarias en Docebo
| Información a introducir | Dónde encontrarla | Nota |
|---|---|---|
| Id. de directorio (inquilino) | Registro de la aplicación de Azure → Información general | |
| URL del sitio de SharePoint | Dirección de su sitio de SharePoint, sin el prefijo https:// ni una barra diagonal final; por ejemplo, yourcompany.sharepoint.com | |
| Id. de cliente | Registro de la aplicación de Azure → Información general | |
| Secreto de cliente | Registro de la aplicación de Azure → Certificados y secretos → Secretos de cliente; copia la columna Valor, no el Id. de secreto, al crearlo | |
| Huella digital del certificado | Registro de la aplicación de Azure → Certificados y secretos → Certificados, después de cargar el certificado | Si utiliza nuestra opción integrada para generar el certificado, estos campos se rellenan automáticamente por usted |
| Clave privada | Archivo de clave privada generado junto con el certificado; consérvelo en un lugar seguro, ya que Azure no lo almacena ni vuelve a mostrarlo | Si utiliza nuestra opción integrada para generar el certificado, estos campos se rellenan automáticamente por usted |
Autorizar el conector
- Vaya a Complementos e integraciones → Conectores de conocimientos → Crear → SharePoint - Sitios. Este menú solo está visible para los Superadministradores.
- Introduzca el Id. de directorio (inquilino) y la URL de su sitio de SharePoint, sin el prefijo https:// ni una barra diagonal final.
- 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, a continuación, seleccione Conectar.
- Conceda el consentimiento en la ventana emergente de Microsoft.
- En la pantalla del ámbito, seleccione los sitios que desee poner a disposición para añadirlos posteriormente a las colecciones de conocimientos y, a continuación, guarde la selección.