Connecteur Confluence Cloud Microsoft 365 Copilot

2025-06-18

Le connecteur Confluence Cloud Microsoft 365 Copilot permet à votre organization d’indexer le contenu Confluence. Après avoir configuré le connecteur et les données d’index à partir du site Confluence, les utilisateurs finaux peuvent rechercher ce contenu dans Recherche Microsoft et Microsoft 365 Copilot.

Cet article est destiné aux administrateurs Microsoft 365 qui sont responsables de la configuration, de l’exécution et de la surveillance du connecteur Confluence Cloud Copilot. Il complète les instructions générales fournies lors de la configuration des connecteurs Microsoft Copilot dans le Centre d’administration Microsoft 365.

Fonctionnalités

Les utilisateurs peuvent poser des questions en langage naturel sur le contenu wiki dans Copilot, telles que la synthèse du document d’architecture ou l’accès à un portail.
Les utilisateurs peuvent effectuer des requêtes en langage naturel pour obtenir des réponses précises.

Configuration requise

Vous devez être l’administrateur du locataire Microsoft 365 de votre organization et l’administrateur du site Confluence de votre organization.
Vérifiez que vous disposez des informations d’identification d’authentification avec l’accès approprié.

Importante

En janvier 2024, Atlassian a déprécié un ensemble d’API cloud Confluence (version 1) et a publié de nouvelles API (version 2). Pour plus d’informations, consultez mises à jour du journal des modifications et mises à jour générales. Certaines de ces API v1 déconseillées sont utilisées par le connecteur pour les connexions OAuth uniquement. Par conséquent, après cette modification, vos connexions Confluence existantes peuvent cesser de fonctionner.
En décembre 2023, un nouvel ensemble d’API v2 a été publié pour tous les clients. Après la mise en production, vos connexions existantes nécessitaient une réauthentification. Les nouvelles API v2 nécessitent également des étendues supplémentaires (par rapport aux API v1 précédentes), qui doivent être fournies lors de la réauthentification. Nouvel ensemble d’étendues requises (liste complète) : , , , , , , et read:content.metadata:confluenceread:page:confluence. Read:permission:confluenceread:audit-log:confluenceRead:space:confluenceread:content-details:confluenceread:user:confluenceread:group:confluence
À partir de juillet 2025, confluence Cloud connector prend en charge l’indexation des commentaires et de l’attchement sur les pages. Pour tirer parti de cette nouvelle fonctionnalité, vos connexions existantes nécessitaient une réauthentification et deux autres étendues ( read:comment:confluence, read:attachment:confluence) doivent être ajoutées à l’application d’tégation OAuth 2.

Prise en main

1. Nom d’affichage

Un nom d’affichage est utilisé pour identifier chaque référence dans Copilot, ce qui permet aux utilisateurs de reconnaître facilement le fichier ou l’élément associé. Le nom d’affichage indique également le contenu approuvé. Le nom d’affichage est également utilisé comme filtre de source de contenu. Une valeur par défaut est présente pour ce champ, mais vous pouvez la personnaliser avec un nom que les utilisateurs de votre organization reconnaître.

2. URL Confluence Cloud

Pour vous connecter à votre site Confluence, utilisez l’URL de votre site. Une URL de site cloud Confluence ressemble généralement à https://< organization_name.atlassian.net/>.

3. Type d’authentification

Pour authentifier et synchroniser le contenu de Confluence sur site, choisissez l’une des deux méthodes prises en charge :

Conseil

Vérifiez que le compte de service a accès au contenu Confluence que vous souhaitez indexer.

a. Authentification de base
Pour vous authentifier à l’aide de l’authentification de base, entrez votre nom d’utilisateur (généralement votre adresse e-mail) et votre jeton d’API. Pour générer un jeton d’API, consultez le guide d’Atlassian.

b. OAuth 2.0 (recommandé)
Inscrivez une application dans Confluence Cloud afin que l’application Recherche Microsoft et Microsoft 365 Copilot puissent accéder à la instance. Pour en savoir plus, consultez la documentation du support Atlassian sur l’activation d’OAuth 2.0.

Les étapes suivantes fournissent des conseils sur l’inscription de l’application :

Connectez-vous à la console Atlassian Developer avec votre compte d’administrateur Atlassian Confluence.
Cliquez sur Créer , puis sélectionnez OAuth 2.0 integration.
Fournissez un nom approprié pour l’application et créez-la.

Accédez à à Permissions partir du volet de navigation à gauche. Cliquez sur Ajouter pour Confluence API. Une fois ajouté, cliquez sur Configurer et Modifier les étendues, puis sélectionnez les étendues suivantes.

Nom de l'étendue	Code	Description
Afficher les détails du contenu	`read:content-details:confluence`	Contenu d’analyse répondant aux critères.
Afficher les groupes	`read:group:confluence`	Pour accéder aux autorisations de groupe du contenu.
Afficher les détails de l’utilisateur	`read:user:confluence`	Pour accéder aux détails d’un utilisateur individuel pour prendre en charge les autorisations.
Afficher les enregistrements d’audit	`read:audit-log:confluence`	Pour accéder aux enregistrements d’audit des événements Confluence afin de prendre en charge les autorisations.
Afficher les pages	`read:page:confluence`	Pour accéder aux détails du contenu de la page pour prendre en charge les autorisations.
Afficher les espaces	`read:space:confluence`	Pour accéder aux détails de l’espace pour prendre en charge les autorisations.
Afficher les résumés de contenu	`read:content.metadata:confluence`	Pour accéder aux informations sur le contenu pour prendre en charge les autorisations.
Afficher les restrictions de contenu et les autorisations d’espace	`read:permission:confluence`	Pour accéder aux restrictions de contenu et aux détails des autorisations d’espace pour prendre en charge les autorisations.
Afficher les commentaires	`read:comment:confluence`	Afficher les commentaires sur les pages ou les billets de blog.
Afficher et télécharger des pièces jointes de contenu	`read:attachment:confluence`	Affichez et téléchargez les pièces jointes d’une page ou d’un billet de blog auquel vous avez accès.

Cliquez sur Save (Enregistrer).
Accédez à à Authorization partir du volet de navigation à gauche. Ajoutez l’URL de rappel, pour Microsoft 365 Entreprise : https://gcs.office.com/v1.0/admin/oauth/callback, pour Microsoft 365 Government : https://gcsgcc.office.com/v1.0/admin/oauth/callback et enregistrez les modifications.
Accédez à Paramètres dans le volet de navigation à gauche. Vous obtenez l’ID client et le secret à partir de cette page.

Effectuez l’étape des paramètres de connexion à l’aide de l’ID client et du secret.

6. Déploiement auprès d’un public limité

Déployez cette connexion sur une base d’utilisateurs limitée si vous souhaitez la valider dans Copilot et d’autres surfaces de recherche avant d’étendre le déploiement à un public plus large. Pour en savoir plus sur le déploiement limité, cliquez ici.

À ce stade, vous êtes prêt à créer la connexion pour Confluence Knowledge. Vous pouvez cliquer sur le bouton « Créer » pour que le connecteur Confluence Cloud Microsoft Graph démarre l’indexation à partir de votre compte Confluence.

Pour d’autres paramètres, tels que les autorisations d’accès, les règles d’inclusion de données, le schéma, la fréquence d’analyse, etc., nous définissons les valeurs par défaut en fonction de ce qui fonctionne le mieux avec les données Confluence. Les valeurs par défaut sont les suivantes :

Utilisateurs
Autorisations d’accès	Uniquement les personnes ayant accès au contenu dans la source de données.
Mapper des identités	Identités de source de données mappées à l’aide d’ID de Microsoft Entra.

Contenu
Inclure/exclure de l’espace	All
Gérer les propriétés	Pour case activée propriétés par défaut et leur schéma, cliquez ici

Synchronisation
Analyse incrémentielle	Fréquence : toutes les 15 minutes
Analyse complète	Fréquence : Tous les jours

Si vous souhaitez modifier l’une de ces valeurs, vous devez choisir l’option Custom Setup .

Configuration personnalisée

Dans l’installation personnalisée, vous pouvez modifier l’une des valeurs par défaut pour les utilisateurs, le contenu et la synchronisation.

Utilisateurs

Autorisations d’accès

Le connecteur Confluence Cloud Copilot prend en charge les autorisations de recherche visibles pour tout le monde ou uniquement pour les personnes ayant accès à cette source de données. Si vous choisissez Tout le monde, les données indexées apparaissent dans les résultats de la recherche pour tous les utilisateurs. Si vous choisissez Uniquement les personnes ayant accès à cette source de données, les données indexées apparaissent dans les résultats de la recherche pour les utilisateurs qui y ont accès. Dans Confluence Cloud, les autorisations de sécurité pour les utilisateurs et les groupes sont définies à l’aide des autorisations d’espace et des restrictions de page. Les restrictions au niveau de la page, le cas échéant, sont prioritaires sur les autorisations d’espace.

S’il n’existe aucune restriction de page, le connecteur vérifie les autorisations au niveau de l’espace :

Si l’accès « utilisateurs anonymes » est activé dans l’espace, le contenu est visible par tous les utilisateurs de votre locataire.
Si l’accès anonyme n’est pas activé, les autorisations au niveau de l’espace sont respectées.
Si les autorisations au niveau de l’espace ne sont pas définies, le contenu n’est visible par aucun utilisateur de votre locataire.

Importante

Les autorisations sont gérées uniquement au niveau de l’espace et de la page, et les autorisations de page parente ne sont pas prises en compte.

Si vous choisissez Uniquement les personnes ayant accès à cette source de données, vous devez choisir davantage si votre site Confluence a Microsoft Entra ID utilisateurs provisionnés ou non AAD.

Pour identifier l’option qui convient à votre organization :

Choisissez l’option Microsoft Entra ID si l’ID d’e-mail des utilisateurs Confluence est identique à l’UTILISATEURPrincipalName (UPN) des utilisateurs dans Microsoft Entra ID.
Choisissez l’option non-AAD si l’ID d’e-mail des utilisateurs Confluence est différent de l’UtilisateurPrincipalName (UPN) des utilisateurs dans Microsoft Entra ID.

Remarque

Si vous choisissez Microsoft Entra ID comme type de source d’identité, le connecteur mappe les ID d’e-mail des utilisateurs obtenus à partir de Confluence directement à la propriété UPN de Microsoft Entra ID.
Si vous avez choisi « Non-AAD » pour le type d’identité, consultez Mapper vos identités non-Azure AD pour obtenir des instructions sur le mappage des identités. Vous pouvez utiliser cette option pour fournir l’expression régulière de mappage de l’ID d’e-mail à l’UPN.
Mises à jour aux utilisateurs ou aux groupes qui régissent les autorisations d’accès sont synchronisées uniquement dans des analyses complètes. Les analyses incrémentielles ne prennent actuellement pas en charge le traitement des mises à jour des autorisations.

Contenu

Inclure ou exclure des données que vous souhaitez indexer

Avec une chaîne CQL (Confluence Query Language), vous pouvez spécifier des conditions pour la synchronisation des pages. C’est comme une clause Where dans une instruction SQL Select . Par exemple, vous pouvez choisir d’indexer uniquement les pages qui ont été modifiées au cours des deux dernières années. Pour en savoir plus sur la création de votre propre chaîne de requête, consultez Recherche avancée à l’aide de CQL. Le connecteur indexe tous les blogs et pages par défaut.

Conseil

Vous pouvez utiliser le filtre CQL pour indexer le contenu modifié après un certain temps à l’aide de, lastModified >= « 2018/12/31 »

Utilisez le bouton d’aperçu des résultats pour vérifier les exemples de valeurs des propriétés sélectionnées et de la chaîne CQL.

Gérer les propriétés

Pour ajouter ou supprimer des propriétés disponibles à partir de votre Aha !, affectez un schéma à la propriété (définissez si une propriété peut faire l’objet d’une recherche, peut être interrogeable, récupérable ou refinable), modifiez l’étiquette sémantique et ajoutez un alias à la propriété. Les propriétés suivantes sont indexées par défaut.

Propriété par défaut	Étiquette	Description
des auteurs	`authors`	Nom des personnes qui ont participé ou collaboré sur l’élément dans la source de données.
CreatedByName	`createdBy`	Nom de la personne qui a récemment modifié l’élément dans la source de données.
CreatedOn	`createdDateTime`	Date et heure de création de l’élément dans la source de données.
IconUrl	`iconUrl`	URL de l’icône associée de l’élément.
Titre	`title`	Titre de l’élément que vous souhaitez afficher dans la recherche et d’autres expériences.
UpdatedByName	`lastModifiedBy`	Nom de la personne qui a récemment modifié l’élément dans la source de données.
UpdatedOn	`lastModifiedDateTime`	Date et heure de la dernière modification de l’élément dans la source de données.
Url	`url`	L’URL cible de l’élément dans la source de données.

Afficher un aperçu des données

Utilisez le bouton d’aperçu des résultats pour vérifier les propriétés et les filtres sélectionnés.

Synchronisation

L’intervalle d’actualisation détermine la fréquence à laquelle vos données sont synchronisées entre la source de données et l’index du connecteur Confluence Cloud Copilot. Il existe deux types d’intervalles d’actualisation : l’analyse complète et l’analyse incrémentielle. Pour plus d’informations, cliquez ici. Vous pouvez modifier les valeurs par défaut de l’intervalle d’actualisation à partir d’ici si vous le souhaitez.

Passer en revue et tester votre connexion

Pour les tests, vous pouvez choisir de publier sur un public limité
Rechercher et valider votre contenu et vos autorisations indexés à l’aide de l’explorateur d’index
Vous trouverez peut-être des réponses aux questions courantes dans notre section FAQ

Pour Recherche Microsoft, si vous avez besoin de personnaliser la page des résultats de recherche. Pour en savoir plus sur la personnalisation des résultats de recherche, consultez Personnaliser la page des résultats de recherche.

Si vous rencontrez des problèmes ou si vous souhaitez fournir des commentaires, contactez Microsoft Graph | Support.

Partager via