Les connecteurs de connaissances SharePoint

Introduction

Connectez des bibliothèques de documents SharePoint pour faire de leur contenu des connaissances consultables dans Docebo.

Ce connecteur synchronise les fichiers stockés dans les bibliothèques de documents SharePoint avec Docebo Knowledge, afin que leur contenu puisse être recherché et exploité par les assistants et agents IA. Il couvre uniquement les fichiers — pas les pages, les listes ni les autres contenus du site.

1. Informations de base

Contenus synchronisés

Contenus extraits

Types de fichiers pris en charge pour l’extraction de contenu

Les fichiers de plus de 50 Mo sont synchronisés avec leurs métadonnées uniquement — leur contenu n’est pas analysé.

Un connecteur SharePoint Sites distinct, couvrant les pages de site et les autres contenus du site plutôt que les fichiers, est prévu. Ce connecteur est limité aux fichiers.

2. Prérequis dans le système source

Rôle obligatoire

Pour effectuer la configuration, vous devez disposer de l’un des rôles Microsoft Entra ID (Azure AD) suivants :

• Administrateur général, ou
• Administrateur d’application ou Administrateur d’application cloud, associé à un rôle permettant d’accorder le consentement administrateur (par exemple, Administrateur de rôle privilégié)

Vous devez également disposer d’un accès Propriétaire de site ou Administrateur SharePoint sur chaque site que vous souhaitez synchroniser.

Paramètres obligatoires

Les bibliothèques de documents que vous souhaitez synchroniser ne doivent pas être protégées par une étiquette de confidentialité Microsoft Purview ou une stratégie de gestion des droits relatifs à l’information (IRM) qui bloque l’extraction de contenu via l’API.

Les stratégies d’accès conditionnel ne doivent pas empêcher le principal de service de l’application d’accéder à Microsoft Graph.

3. Préparation dans le système source

Créer l’enregistrement de l’application

Connectez-vous au portail Azure, puis accédez à Microsoft Entra ID → Enregistrements d’applications → Nouvel enregistrement. Nommez l’application (par exemple, « Connecteur Docebo Knowledge »), laissez le champ Types de comptes pris en charge défini sur locataire unique, et renseignez dès maintenant le champ URI de redirection — choisissez Web et saisissez l’URL de rappel. Vous vous épargnerez ainsi une étape par la suite. L’URL suit toujours ce modèle : https://[YOUR-DOCEBO-PLATFORM-URL]/knowledge/v1/integrations/connections/callback — par exemple, https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback. Sélectionnez Enregistrer.

Enregistrement d’une application, avec l’URI de redirection déjà saisi.

Attribuer les droits d’API

Ouvrez l’application → Droits d’API → Ajouter un droit, puis ajoutez les droits ci-dessous depuis Microsoft Graph et SharePoint. Une fois tous les droits ajoutés, sélectionnez Accorder un consentement d’administrateur pour les approuver en une seule fois.

Microsoft Graph

SharePoint

Droits configurés — droits Microsoft Graph et SharePoint, tous accordés.

Ajouter un secret client

Accédez à Certificats & secrets → Nouveau secret client. Saisissez une description et une date d’expiration, puis sélectionnez Ajouter. Une fois le secret créé, copiez la valeur affichée dans la colonne Valeur — et non dans la colonne ID de secret, qui lui ressemble mais ne permet pas l’authentification. Vous ne pourrez plus voir cette valeur une fois que vous aurez quitté cette page.

Les secrets client expirent selon le calendrier que vous définissez ici. Si un secret expire sans avoir été remplacé au préalable, la connexion SharePoint cesse de fonctionner — programmez un rappel avant la date d’expiration.

Ajout d’un secret client, avec une description et une date d’expiration définies.

Ajouter un certificat

L’accès direct à l’API SharePoint nécessite un certificat en plus d’un secret. Générez un certificat auto-signé et une clé privée avec 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

Vous pouvez également utiliser la fonctionnalité intégrée pour que le certificat et la clé privée soient créés automatiquement.

Ces commandes créent sharepoint-cert.pem (le certificat) et sharepoint-key.pem (la clé privée), puis copient la clé privée dans votre presse-papiers. Accédez à Certificats & secrets → Certificats → Téléverser certificat, puis téléversez sharepoint-cert.pem. Une fois le certificat téléversé, notez la valeur du champ Empreinte numérique affichée dans la liste — vous en aurez besoin dans Docebo, ainsi que de la clé privée que vous venez de copier.

Onglet Certificats affichant le certificat téléversé et son empreinte numérique.

4. Actions obligatoires dans Docebo

Autoriser le connecteur

1. Accédez à Modules et intégrations → Connecteurs de connaissances → Créer → SharePoint - Files. Ce menu n’est visible que par les Superadmins.
2. Saisissez l’ID de l’annuaire (locataire) et l’URL de votre site SharePoint — sans le préfixe https:// ni barre oblique finale.

Connexion de SharePoint - Files, avec les champs ID locataire et URL SharePoint.

3. Saisissez l’ID client, le secret client, l’empreinte numérique du certificat et la clé privée de votre application Azure, puis sélectionnez Connecter.

Connexion de SharePoint - Files, avec les champs ID client, Secret client, Empreinte numérique du certificat et Clé privée.

4. Donnez votre consentement dans la fenêtre contextuelle de Microsoft.
5. Sur l’écran du champ d’application, sélectionnez les sites dont les fichiers doivent être disponibles, afin de pouvoir les ajouter ultérieurement à des sélections de connaissances, puis enregistrez votre sélection.

Sélection du champ d’application — choix des sites dont les fichiers seront synchronisés.