Introduction
Connectez des espaces Confluence pour que le contenu des pages devienne une source de connaissances accessible via la recherche dans Docebo.
Ce connecteur synchronise des espaces Confluence entiers, c’est-à-dire le contenu et la hiérarchie des pages, plutôt que des fichiers individuels ; c’est pourquoi il figure parmi les connecteurs de type « Sites ». C’est la principale différence par rapport aux connecteurs SharePoint et Google Drive.
1. Informations de base
Contenu synchronisé
| Type de contenu | Statut | Message |
|---|---|---|
| Pages publiées dans un espace sélectionné | Synchronisé | |
| Étiquettes de page | Synchronisé | |
| Fichiers et pièces jointes dans les pages | Non synchronisé | Hors du champ d’application — ce connecteur couvre uniquement le contenu des pages, pas les fichiers |
| Commentaires | Non synchronisé | |
| Pages en brouillon ou dépubliées | Non synchronisé | |
| Espaces archivés | Non synchronisé |
Contenu extrait
| Contenu | Statut |
|---|---|
| Titre et corps de texte de la page | Extrait |
| Nom de l’espace, clé et URL de la page | Extrait |
| Métadonnées et hiérarchie des pages (structure parent/enfant, horodatages) | Extrait |
| Étiquettes de page | Extrait |
| Images intégrées, diagrammes et rendu des macros | Non extrait |
| Commentaires | Non extrait |
| Historique des pages et comparaisons de versions | Non extrait |
| Contenu des pièces jointes | Non extrait |
2. Prérequis dans le système source
Rôle requis
Vous avez besoin d’un compte d’administrateur d’organisation Atlassian — avoir un compte admin de site Confluence ne suffit pas. Seul un accès administrateur d’organisation permet au connecteur d’identifier correctement les utilisateurs et d’accéder à tous les espaces ; un compte d’administrateur de site ne peut garantir ni l’un ni l’autre.
Paramètres requis
- Ce connecteur prend uniquement en charge Confluence Cloud. Confluence Data Center n’est pas pris en charge.
- Si votre organisation utilise une liste d’autorisation d’applications, ajoutez-y la nouvelle application OAuth avant de procéder à l’autorisation.
3. Préparation du système source
Créer l’application
Accédez à l’Atlassian Developer Console, sélectionnez Créer → Intégration OAuth 2.0, puis nommez l’application (par exemple, « Docebo Knowledge Connector »). Choisissez un type d’accès : dans la plupart des cas, utilisez Niveau du compte — ce type accorde l’accès à tous les sites de l’organisation Atlassian du client. Ne choisissez Niveau de la ressource que si l’organisation dispose de plusieurs sites distincts et que vous souhaitez précisément n’en connecter qu’un seul.
Création d’une nouvelle intégration OAuth 2.0 (3LO), avec le choix du type d’accès.
Ajouter des droits
Ouvrez l’application → Droits, puis ajoutez à la fois l’API d’identité utilisateur et l’API Confluence. Pour l’API Confluence, ajoutez les champs d’application figurant dans les deux onglets, Champs d’application classiques et Champs d’application granulaires — le connecteur Docebo utilise ces deux types de champs.
API d’identité utilisateur
| Nom du champ d’application | Description | Code |
|---|---|---|
| Afficher le profil de l’utilisateur actif | Afficher les détails du profil de l’utilisateur actuellement connecté. | read:me |
| Afficher les profils utilisateur | Requis pour afficher les profils des utilisateurs. | read:account |
API d’identité utilisateur — champs d’application sélectionnés dans l’Atlassian Developer Console.
API Confluence — Champs d’application classiques
| Nom du champ d’application | Code |
|---|---|
| Lire le résumé de l’espace Confluence | read:confluence-space.summary |
| Lire les propriétés du contenu Confluence | read:confluence-props |
| Lire le contenu détaillé de Confluence | read:confluence-content.all |
| Lire le résumé du contenu Confluence | read:confluence-content.summary |
| Rechercher dans le contenu et les résumés d’espaces Confluence | search:confluence |
| Lire les droits sur le contenu dans Confluence | read:confluence-content.permission |
| Lire l’utilisateur | read:confluence-user |
| Lire les groupes d’utilisateurs | read:confluence-groups |
| Télécharger les pièces jointes du contenu | readonly:content.attachment:confluence |
API Confluence — onglet Champs d’application classiques dans l’Atlassian Developer Console.
API Confluence — Champs d’application granulaires
| Nom du champ d’application | Code |
|---|---|
| Afficher le contenu détaillé | read:content:confluence |
| Afficher les détails du contenu | read:content-details:confluence |
| Afficher les détails de l’espace | read:space-details:confluence |
| Afficher les pages | read:page:confluence |
| Afficher les groupes | read:group:confluence |
| Afficher les informations sur l’utilisateur | read:user:confluence |
| Afficher les espaces | read:space:confluence |
| Afficher les propriétés de l’espace | read:space.property:confluence |
| Afficher les paramètres de l’espace | read:space.setting:confluence |
| Vérifier les droits sur le contenu | read:content.permission:confluence |
| Afficher les restrictions de contenu et les droits de l’espace | read:permission:confluence |
| Lire l’adresse e-mail | read:email-address:confluence |
API Confluence — onglet Champs d’application granulaires dans l’Atlassian Developer Console.
Configurer l’authentification
Ouvrez Autorisation, activez OAuth 2.0 (3LO), puis définissez l’URL de callback. L’URL de callback 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 les modifications.
Onglet Autorisation avec le champ URL de callback et le générateur d’URL d’autorisation.
Définir la distribution
Ouvrez Distribution, puis définissez le Statut de distribution sur Partage — c’est ce qui permet à n’importe quel compte Atlassian d’autoriser le connecteur, et pas uniquement au compte qui a créé l’application. Renseignez les informations sur le fournisseur et la sécurité demandées : nom du fournisseur, URL de la politique de confidentialité, URL des conditions d’utilisation et contact du support client. Sous Déclaration des données personnelles, indiquez si l’application stocke des données personnelles, puis sélectionnez Enregistrer les modifications.
Paramètres de modification de la distribution, avec l’option Partage sélectionnée et les informations sur le fournisseur renseignées.
4. Actions requises dans Docebo
| Informations à saisir | Où les trouver |
|---|---|
| URL du site Confluence | Votre adresse Confluence Cloud, par exemple yourcompany.atlassian.net |
| ID client | Atlassian Developer Console → application → Paramètres → Détails de l’authentification |
| Secret client | Atlassian Developer Console → application → Paramètres → Détails de l’authentification |
Autoriser le connecteur
- Accédez à Modules et intégrations → Connecteurs de connaissances → Créer → Confluence. Ce menu n’est visible que par les Superadmins.
- Saisissez l’URL Confluence (par exemple, https://yourcompany.atlassian.net), puis sélectionnez Continuer.
Connecter Confluence — onglet Configuration avec le champ URL Confluence.
- Saisissez l’ID client et le secret client de votre application Atlassian (Paramètres → Détails de l’authentification), puis sélectionnez S’authentifier.
Connecter Confluence — onglet Authentification avec les champs ID client et Secret client.
- Dans la fenêtre pop-up Atlassian, vérifiez l’accès demandé, puis sélectionnez Accepter.
Écran de consentement Atlassian pour le connecteur Docebo.
- Dans l’onglet Champ d’application, sélectionnez les espaces que vous souhaitez rendre disponibles pour les ajouter ultérieurement à des sélections de connaissances, puis enregistrez votre sélection.
Connecter Confluence — onglet Champ d’application pour sélectionner les espaces à synchroniser.