Déployer le connecteur Confluence Cloud Copilot dans le Centre d’administration Microsoft 365

Le connecteur Confluence Cloud Microsoft 365 Copilot intègre le contenu Confluence dans Microsoft 365, ce qui permet à Copilot, Copilot Search et Microsoft Search de faire apparaître des pages wiki et des blogs pertinents directement dans des applications telles que Teams, Outlook et SharePoint.

Cet article décrit les étapes de déploiement, de personnalisation et de résolution des problèmes du connecteur Confluence Cloud Copilot. Pour obtenir des informations générales sur le déploiement du connecteur Copilot, consultez Configurer des connecteurs Copilot dans le Centre d’administration Microsoft 365.

Pour obtenir des informations avancées sur la configuration de Confluence Cloud, consultez Configurer le service Confluence Cloud pour l’ingestion des connecteurs.

Configuration requise

Avant de déployer le connecteur Confluence Cloud, assurez-vous que l’environnement Confluence est configuré dans votre organization. Le tableau suivant récapitule les étapes de configuration de l’environnement Confluence et de déploiement du connecteur.

Tâche	Role
Configurer l’environnement	Administrateur confluence
Configurer les prérequis	Administrateur confluence/Administrateur réseau
Déployer le connecteur dans le Centre d’administration Microsoft 365	Microsoft 365 pour les administrateurs
Personnaliser les paramètres du connecteur (facultatif)	Microsoft 365 pour les administrateurs

Pour déployer le connecteur, vous devez remplir les conditions préalables suivantes :

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

Déployer le connecteur

Pour ajouter le connecteur Confluence Cloud pour votre organization :

Dans le Centre d’administration Microsoft 365, dans le volet gauche, choisissezConnecteursCopilot>.
Accédez à l’onglet Connecteurs , puis dans le volet gauche, choisissez Galerie.
Dans la liste des connecteurs disponibles, choisissez Confluence Cloud.

Définir le nom d’affichage

Le nom d’affichage est utilisé pour identifier les références dans les réponses Copilot afin d’aider les utilisateurs à reconnaître le fichier ou l’élément associé. Le nom d’affichage indique également le contenu approuvé et est utilisé comme filtre source de contenu.

Vous pouvez accepter le nom complet Confluence Cloud par défaut ou personnaliser la valeur pour utiliser un nom d’affichage que les utilisateurs de votre organization reconnaissent.

Pour plus d’informations sur les noms d’affichage et les descriptions des connecteurs, consultez Améliorer la découverte Copilot avec Microsoft 365 Copilot contenu des connecteurs.

Définir instance URL

Pour vous connecter à votre site Confluence, utilisez l’URL de votre site, qui est généralement la suivante : https://<organization_name>.atlassian.net.

La <organization_name> valeur est l’identificateur unique de votre site Confluence Cloud.

Choisir le type d’authentification

Pour authentifier et synchroniser le contenu de Confluence, choisissez l’un des types d’authentification suivants :

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 Gérer les jetons d’API pour votre compte Atlassian.

OAuth 2.0 (recommandé) : inscrivez une application dans Confluence Cloud afin que Recherche microsoft et Microsoft 365 Copilot puissent accéder aux instance. Pour plus d’informations, consultez Activation d’OAuth 2.0 (3LO).

Pour inscrire l’application :

Connectez-vous à la console Atlassian Developer avec votre compte d’administrateur Atlassian Confluence.
Choisissez Créer et sélectionnez Intégration OAuth 2.0.
Fournissez un nom pour l’application et créez-la.
Dans le volet gauche, choisissez Autorisations, puis en regard de API Confluence, choisissez Ajouter.

Choisissez Configurer Modifier>les étendues, puis sélectionnez les étendues répertoriées dans le tableau suivant.

Nom de l’étendue	Code	Description
Afficher les détails du contenu	read :content-details :confluence	Contenu d’analyse qui répond aux critères.
Afficher les groupes	read :group :confluence	Accéder aux autorisations de groupe de contenu.
Afficher les détails de l’utilisateur	read :user :confluence	Accédez aux détails d’un utilisateur individuel pour prendre en charge les autorisations.
Afficher les enregistrements d’audit	read :audit-log :confluence	Accédez aux enregistrements d’audit pour les événements Confluence afin de prendre en charge les autorisations.
Afficher les pages	read :page :confluence	Accéder aux détails du contenu de la page pour prendre en charge les autorisations.
Afficher les espaces	read :space :confluence	Accéder aux détails de l’espace pour prendre en charge les autorisations.
Afficher les restrictions de contenu et les autorisations d’espace	read :permission :confluence	Afficher les restrictions de contenu et les autorisations d’espace.
Afficher les résumés de contenu	read :content.metadata :confluence	Accéder aux informations sur le contenu pour prendre en charge les autorisations.
Afficher les commentaires	read :comment :confluence	Afficher les commentaires sur des pages ou des 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 Enregistrer.
Dans le volet gauche, accédez à Autorisation. Ajoutez l’URL de rappel pour Microsoft 365, comme suit :
- Microsoft 365 Entreprise -https://gcs.office.com/v1.0/admin/oauth/callback
- Microsoft 365 Government - https://gcsgcc.office.com/v1.0/admin/oauth/callback 
Cliquez sur Enregistrer.
Dans le volet gauche, accédez à Paramètres. Copiez l’ID client et le secret. Effectuez l’étape des paramètres de connexion à l’aide de l’ID client et du secret.

Conseil

Assurez-vous que le compte de service a accès au contenu Confluence que vous souhaitez indexer.

Déploiement

Déployez la connexion à un ensemble limité d’utilisateurs pour la valider dans Copilot et d’autres surfaces de recherche avant de la déployer auprès d’un public plus large. Pour plus d’informations, consultez Déploiement intermédiaire pour les connecteurs Microsoft 365 Copilot.

Pour effectuer un déploiement sur un public limité, choisissez le bouton bascule en regard de Déploiement sur une audience limitée et spécifiez les utilisateurs et les groupes sur lesquels déployer le connecteur.

Pour déployer le connecteur, choisissez Créer dans le Centre d’administration Microsoft 365. Le connecteur Confluence Cloud Copilot démarre immédiatement l’indexation des pages de votre compte Confluence.

Le tableau suivant répertorie les valeurs par défaut qui sont définies. Ces valeurs fonctionnent mieux avec les données Confluence.

Catégorie	Setting	Valeur par défaut
Utilisateurs	Autorisations d’accès	Seules les personnes ayant accès au contenu dans la source de données.
Utilisateurs	Identités des cartes	Identités de source de données mappées à l’aide d’ID de Microsoft Entra.
Contenu	Inclure/exclure de l’espace	tous
Contenu	Gérer les propriétés	Pour connaître les propriétés et les schémas par défaut, consultez Gérer les propriétés.
Synchronisation	Analyse incrémentielle	Fréquence : toutes les 15 minutes
Synchronisation	Analyse complète	Fréquence : tous les jours

Pour personnaliser ces valeurs, consultez Personnaliser les paramètres.

Après avoir créé votre connexion, vous pouvez consulter les status dans la section Connecteurs du Centre d’administration Microsoft 365.

Personnaliser les paramètres (facultatif)

Vous pouvez personnaliser les valeurs par défaut pour les paramètres du connecteur Confluence Cloud. Pour personnaliser les paramètres, dans la page du connecteur dans le Centre d’administration, choisissez Configuration personnalisée.

Personnaliser les paramètres utilisateur

Le connecteur Confluence Cloud prend en charge les autorisations de recherche utilisateur suivantes :

Tout le monde
Seules les personnes ayant accès à cette source de données (par défaut)

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.

Si aucune restriction de page n’est spécifiée, le connecteur vérifie les autorisations au niveau de l’espace et applique les éléments suivants :

Si l’accès des 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é dans l’espace, 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. Les autorisations de page parente ne sont pas appliquées.

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

Choisissez l’option Microsoft Entra ID si l’ID de messagerie des utilisateurs Confluence est identique au nom d’utilisateur principal (UPN) dans Microsoft Entra ID.
Choisissez l’option ID non-Entra si l’ID de messagerie des utilisateurs Confluence est différent de l’UPN dans Microsoft Entra ID.

Remarque

Si vous choisissez Microsoft Entra ID comme source d’identité, le connecteur mappe les ID d’e-mail utilisateur de Confluence à la propriété UPN dans Microsoft Entra ID.
Si vous choisissez un ID non-Entra comme source d’identité, fournissez une expression régulière pour mapper l’ID d’e-mail à l’UPN. Pour plus d’informations, consultez Mapper vos identités d’ID non Entra.
Mises à jour aux utilisateurs ou aux groupes qui régissent les autorisations d’accès sont synchronisés uniquement dans des analyses complètes. Les analyses incrémentielles ne prennent actuellement pas en charge le traitement des mises à jour des autorisations.

Personnaliser les paramètres de contenu

Vous pouvez personnaliser les données incluses et exclues et personnaliser les propriétés du connecteur par défaut.

Inclure ou exclure des données

Par défaut, le connecteur Confluence Cloud indexe tous les blogs et pages. Vous pouvez inclure ou exclure des données que vous souhaitez indexer. Vous pouvez utiliser une chaîne CQL (Confluence Query Language) pour spécifier des conditions de synchronisation des pages. Par exemple, vous pouvez choisir d’indexer uniquement les pages qui ont été modifiées au cours des deux dernières années. Pour plus d’informations, consultez Recherche avancée à l’aide de CQL.

Conseil

Vous pouvez utiliser le filtre CQL pour indexer le contenu modifié après un certain temps en utilisant, par exemple, lastModified >= "2024/12/31".

Choisissez 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 connecteur Confluence Cloud, affectez un schéma à la propriété (définissez si une propriété peut faire l’objet d’une recherche, peut être interrogé, 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 public des personnes qui ont participé ou collaboré sur l’élément dans la source de données.
CreatedByName	`createdBy`	Nom public de la personne qui a récemment modifié 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 public 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.

Choisissez le bouton Aperçu des résultats pour vérifier les propriétés et les filtres sélectionnés.

Personnaliser les intervalles de 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. Les connecteurs Copilot utilisent deux types d’intervalles d’actualisation :

Analyse complète : effectue une synchronisation complète de tout le contenu. Les analyses complètes détectent les éléments supprimés et synchronisent les modifications de la liste de contrôle d’accès (ACL). Par défaut, les analyses complètes s’exécutent toutes les 24 heures.
Analyse incrémentielle : synchronise le contenu nouveau et modifié. Les analyses incrémentielles ne sélectionnent pas les modifications de liste de contrôle d’accès ou les éléments supprimés. Par défaut, les analyses incrémentielles s’exécutent toutes les 15 minutes.

Vous pouvez modifier les valeurs par défaut des intervalles d’actualisation. Pour plus d’informations, consultez Recommandations pour les paramètres de synchronisation.

Last updated on 2026-01-05

Partager via