Partager via

Connecteur Microsoft Graph local Confluence

  • Article

Le connecteur Microsoft Graph local Confluence permet à votre organization d’indexer le contenu du serveur Confluence ou du centre de données. Après avoir configuré le connecteur et les données d’index à partir du site Confluence, les utilisateurs finaux peuvent rechercher ces contenus 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 Microsoft Graph local Confluence. Il complète les instructions générales fournies dans configurer les connecteurs Microsoft Graph dans le Centre d’administration Microsoft 365.

Avantages

  • Fonctionnalités de recherche améliorées : les utilisateurs peuvent poser des questions en langage naturel sur le contenu Wiki dans Copilot, par exemple :
    • Résumer le document sur l’architecture
    • Comment accéder à un portail
  • Prise en charge de la recherche sémantique : les utilisateurs peuvent effectuer des requêtes en langage naturel pour obtenir des réponses précises.
  • Compatibilité : prend en charge les versions confluence supérieures à 8.0.

Configuration requise

  1. Installer GCA [agent de connecteur Graph] : vérifiez que le GCA est installé sur un ordinateur Windows au sein du même réseau que la source de données, accessible via l’URL Confluence. Vous trouverez plus d’informations sur l’agent de connecteur Microsoft Graph.
  2. Installer le plug-in : téléchargez et installez le plug-in confluence local à partir d’Atlassian Marketplace sur votre configuration confluence. Obtenir le plug-in à partir du plug-in Local Confluence des connecteurs Microsoft Graph | Place de marché Atlassian
  3. Authentification : vérifiez que vous disposez des informations d’identification d’authentification avec un accès approprié.

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 locale Confluence

Pour vous connecter à vos données locales Confluence, vous avez besoin de l’URL confluence instance de votre organization. L’URL confluence instance de votre organization ressemble généralement à « ».https://contoso.atlassian.net

3. Agent de connecteur Graph (GCA)

Pour indexer le contenu de votre serveur Confluence ou de votre centre de données, vous devez installer et inscrire l’agent de connecteur. Pour plus d’informations, consultez Installer l’agent de connecteur Microsoft Graph . Vous devez être l’administrateur du locataire Microsoft 365 de votre organization et l’administrateur du site Confluence de votre organization.

Remarque

GCA peut être installé sur un autre ordinateur Windows et ne doit pas nécessairement se trouver sur le même ordinateur que celui du serveur local. La machine peut aider à générer l’ID d’application et le secret qui peuvent être utilisés pour l’installation. Vous devez vous assurer que la machine GCA est activée pendant l’analyse. Vous trouverez peut-être des réponses aux questions courantes de GCA dans la section FAQ .

4. Installer le plug-in local Confluence

Vérifiez que le plug-in Local Confluence des connecteurs Microsoft Graph est installé. Vous n’avez pas besoin d’installer le plug-in pour chaque connecteur Confluence ; s’il est déjà installé dans votre instance Confluence, vous pouvez ignorer cette étape pour les connexions confluence locales ultérieures.

Remarque

Le plug-in est pris en charge pour la version confluence supérieure à 8.0.

5. Type d’authentification

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

a. Authentification de base
Pour vous authentifier auprès de votre instance, entrez le nom d’utilisateur et le mot de passe du compte Confluence.

b. OAuth1.0a
Générez une paire de clés publique/privée et créez un lien d’application dans le site local Confluence afin que l’agent de connecteur puisse accéder au instance. Pour en savoir plus, consultez l’étape 1 de la documentation des développeurs Atlassian sur la configuration d’OAuth 1.0a.

c. OAuth 2.0 (recommandé)
Les étapes suivantes fournissent des conseils sur la façon d’inscrire l’application Configurer un lien entrant.

  1. Accédez à Administration > Configuration générale > Liens de l’application.
  2. Sélectionnez Créer un lien
  3. Sélectionnez Application externe, puis choisissez Entrant comme direction.
  4. Renseignez le
  • URL de redirection : https://gcs.office.com/v1.0/admin/oauth/callback
  • Étendue : Administration ou Lecture
  1. 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 ServiceNow Knowledge. Vous pouvez cliquer sur le bouton « Créer » pour que le connecteur 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.
Content  
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

L’installation personnalisée est destinée aux administrateurs qui souhaitent modifier les valeurs par défaut des paramètres répertoriés dans le tableau par défaut. Une fois que vous avez cliqué sur l’option Custom Setup , trois onglets supplémentaires s’affichent : Utilisateurs, Contenu et Synchronisation.

Utilisateurs

Autorisations d’accès

Le connecteur Microsoft Graph local Confluence 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 En local, 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. Le connecteur Microsoft Graph local Confluence applique les autorisations effectives fournies par l’API de restrictions de contenu

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 :

  1. 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.
  2. 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.

Importante

  • 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

Dans cette étape, vous pouvez ajouter ou supprimer des propriétés disponibles de votre source de données Confluence. Microsoft 365 sélectionne quelques propriétés. Par défaut, le connecteur indexe tous les espaces. Toutefois, vous pouvez choisir d’inclure ou d’exclure des espaces spécifiques à l’aide de l’option de filtre d’espace.

Entrez la liste des clés d’espace que vous souhaitez inclure ou exclure, et vous voyez un aperçu des résultats. Entrer la clé d’espace : chaque espace Confluence a une clé d’espace, qui est un identificateur court et unique qui fait partie de l’URL de cet espace. Pour obtenir la clé d’espace, contactez l’administrateur confluence. Pour plus d’informations, consultez : Clés d’espace

Filtre de page

Dans cette étape, vous pouvez spécifier la plage de dates pour l’indexation de vos documents. Les paramètres sont les suivants :

  • Date de la dernière création : date de création d’un document. Seuls les documents modifiés après cette date sont indexés.
  • Date de la dernière modification : date à laquelle un document a été modifié. Seuls les documents modifiés après cette date sont indexés.

Importante

  • Vérifiez que les dates sont dans l’ordre chronologique. La « Date de la dernière création » ne doit pas être postérieure à la « Date de dernière modification ».
  • Si aucune date n’est spécifiée, tous les documents sont considérés pour l’indexation.

Gérer les propriétés

Ici, vous pouvez ajouter ou supprimer les propriétés disponibles de votre source de données locale Confluence. Affectez un schéma à la propriété (définissez si une propriété peut faire l’objet d’une recherche, s’il est interrogeable, récupérable ou refinable). En outre, vous pouvez modifier l’étiquette sémantique et ajouter un alias à la propriété . Les propriétés par défaut sont les suivantes :

Source, propriété Étiquette Schéma
Auteur authors Requête, récupération
Contenu Recherche
CreatedByName Créé par Rechercher, Interroger, Récupérer
CreatedOn Date et heure de création Requête, récupération
ID Requête, récupération
PageTree Récupérer
SpaceName Rechercher, Interroger, Récupérer
Titre title Rechercher, Récupérer
UpdatedByName lastModifiedBy Récupérer
UpdatedOn lastModifiedDateTime Interroger, récupérer, affiner
URL url Récupérer

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.

Remarque

Notez que la préversion respecte uniquement le filtrage au niveau de l’espace.

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 Graph. 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.

Vérifier et tester votre connexion

Pour RECHERCHE MS, 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.

Limitations

  • N’indexe pas les blogs, les fichiers en pièce jointe ou les commentaires.
  • Indexe uniquement les pages actuelles ; les pages archivées sont exclues.
  • CQL[Confluence Query Language] n’est pas pris en charge pour Confluence en local, mais nous prenons en charge un filtre au niveau de l’espace et de la page

Résolution des problèmes

Après avoir publié votre connexion, vous pouvez consulter la status sous l’onglet Sources de données dans le Centre d’administration. Pour savoir comment effectuer des mises à jour et des suppressions, consultez Gérer votre connecteur. Vous trouverez les étapes de résolution des problèmes courants ici.

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