Introduction
Connectez des sites, des pages web et des actualités SharePoint pour que leur contenu devienne des connaissances accessibles dans Docebo.
Ce connecteur synchronise le contenu des sites et des pages web, ainsi que les actualités stockées sur des sites SharePoint sélectionnés, dans Docebo Knowledge. Ce contenu devient ainsi consultable par la recherche et exploitable par les assistants et agents IA. Il ne couvre que les pages de site, les listes et les autres contenus de site. Un connecteur dédié est disponible pour les fichiers SharePoint.
1. Informations de base
Contenus synchronisés
| Type de contenu | Statut | Remarque |
|---|---|---|
| Sites | Synchronisé | |
| Pages web | Synchronisé | |
| Actualités et annonces | Synchronisé | |
| Fichiers des bibliothèques de documents | Non synchronisé | Pris en charge par le connecteur de fichiers SharePoint |
Contenus extraits
| Contenu | Statut |
|---|---|
| Titre et corps du texte du site | Extrait |
| Listes et éléments qu’elles contiennent | Extrait |
| Textes des actualités et des annonces | Extrait |
| Nom, URL et hiérarchie du site (métadonnées) | Extrait |
2. Prérequis dans le système source
Rôle requis
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 du site ou Administrateur SharePoint sur chaque site à synchroniser.
Paramètres requis
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’inscription de l’application
Connectez-vous au portail Azure et accédez à Microsoft Entra ID → Inscriptions d’applications → Nouvelle inscription. Nommez l’application (par exemple, « Connecteur Docebo Knowledge »), conservez l’option locataire unique pour Types de comptes pris en charge et configurez dès maintenant l’URI de redirection : choisissez Web et saisissez l’URL de rappel. Effectuer cette opération dès l’enregistrement vous évitera une étape plus tard. 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 après saisie de l’URI de redirection.
Attribuer des droits d’API
Ouvrez l’application → Autorisations 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 le consentement administrateur pour les approuver en une seule fois.
Microsoft Graph
| Droit | Type | Description |
|---|---|---|
| Group.Read.All | Application | Lire tous les groupes |
| GroupMember.Read.All | Application | Lire toutes les appartenances aux groupes |
| Sites.Read.All | Application | Lire les éléments de toutes les collections de sites |
| User.Read.All | Application | Lire les profils complets de tous les utilisateurs |
SharePoint
| Droit | Type | Description |
|---|---|---|
| Sites.Read.All | Application | Lire les éléments de toutes les collections de sites |
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 : celle-ci semble similaire, mais ne permet pas l’authentification. Vous ne pourrez plus voir cette valeur après avoir quitté cette page.
Les secrets client expirent selon le calendrier défini ici. Si un secret expire sans avoir été remplacé au préalable, la connexion SharePoint cesse de fonctionner : pensez à programmer un rappel avant la date d’expiration.
Ajout d’un secret client avec une description et une date d’expiration.
Ajouter un certificat
L’accès direct à l’API SharePoint nécessite un certificat en plus d’un secret.
Nous vous recommandons d’utiliser la fonctionnalité intégrée pour générer automatiquement le certificat et la clé privée en cliquant sur le bouton Générer le certificat.
Cette opération crée sharepoint-cert.pem (le certificat) et remplit automatiquement les champs Empreinte du certificat et Clé privée. Il vous suffit d’ajouter le certificat à l’enregistrement de votre application sous Certificats & secrets → Certificats → Charger le certificat, puis de téléverser sharepoint-cert.pem.
Onglet Certificats affichant le certificat téléversé et son empreinte numérique.
Vous pouvez également générer un certificat autosigné 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
Cette méthode génère également la clé privée et le certificat, mais vous devez ensuite copier manuellement la clé privée dans le champ correspondant, puis copier l’Empreinte numérique après avoir téléversé le certificat dans l’enregistrement de votre application afin de la saisir dans le champ prévu à cet effet.
4. Actions requises dans Docebo
| Informations à saisir | Où les trouver | Remarque |
|---|---|---|
| ID de l’annuaire (locataire) | Enregistrement de l’application Azure → Aperçu | |
| URL du site SharePoint | Adresse de votre site SharePoint, sans le préfixe https:// ni barre oblique finale — par exemple, yourcompany.sharepoint.com | |
| ID client | Enregistrement de l’application Azure → Aperçu | |
| Secret client | Enregistrement de l’application Azure → Certificats & secrets → Secrets client — au moment de la création, copiez la colonne Valeur, et non l’ID de secret | |
| Empreinte du certificat | Enregistrement de l’application Azure → Certificats & secrets → Certificats, après avoir téléversé votre certificat | Si vous utilisez notre option intégrée pour générer le certificat, ces champs sont remplis automatiquement |
| Clé privée | Le fichier de clé privée généré avec votre certificat — conservez-le en lieu sûr, car Azure ne le stocke pas et ne l’affiche plus | Si vous utilisez notre option intégrée pour générer le certificat, ces champs sont remplis automatiquement |
Autorisation du connecteur
- Accédez à Modules et intégrations → Connecteurs de connaissances → Créer → SharePoint - Sites. Ce menu n’est visible que par les Superadmins.
- Saisissez l’ID de l’annuaire (locataire) et l’URL de votre site SharePoint, sans le préfixe https:// ni barre oblique finale.
- Saisissez l’ID client, le secret client, l’empreinte du certificat et la clé privée de votre application Azure, puis sélectionnez Connecter.
- Accordez votre consentement dans la fenêtre contextuelle Microsoft.
- Sur l’écran Champ d’application, sélectionnez les sites à rendre disponibles pour les ajouter ultérieurement à des collections de connaissances, puis enregistrez votre sélection.