Connecteur Confluence Cloud Microsoft Graph

Confluence Cloud Microsoft Graph connecteur permet à votre organisation d’indexer le contenu Confluence. Une fois que vous avez configuré le connecteur et les données d’index à partir du site Confluence, les utilisateurs finaux peuvent rechercher ces contenus dans Recherche Microsoft.

Cet article s’applique aux administrateurs Microsoft 365 ou à toute personne qui configure, exécute et surveille un connecteur Confluence Cloud. Il complète les instructions générales fournies dans la section Configurer les connecteurs Microsoft Graph de l’article Centre d'administration Microsoft 365. Si vous ne l’avez pas déjà fait, lisez l’article entier pour comprendre le processus d’installation générale.

Chaque étape du processus d’installation est répertoriée ci-dessous, ainsi qu’une note indiquant que vous devez suivre les instructions générales de configuration ou d’autres instructions qui s’appliquent uniquement au connecteur Confluence Cloud, y compris des informations sur la résolution des problèmes et les limitations.

Avant de commencer

Vous devez être l’administrateur du locataire Microsoft 365 de votre organisation et l’administrateur du site Confluence de votre organisation.

Étape 1 : Ajouter un connecteur dans le Centre d'administration Microsoft 365

Suivez les instructions générales de configuration.

Étape 2 : Nommer la connexion

Suivez les instructions générales de configuration.

Étape 3 : Configurer les paramètres de connexion

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/. Vous pouvez choisir l’authentification de base ou OAuth 2.0 (recommandé) pour vous authentifier auprès de votre site Confluence.

Conseil

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

Authentification de base

Entrez le nom d’utilisateur de votre compte (généralement l’ID d’e-mail) et le jeton d’API pour vous authentifier à l’aide de l’authentification de base. Pour en savoir plus sur la génération d’un jeton d’API, consultez la documentation d’Atlassian sur la gestion des jetons d’API pour votre compte Atlassian.

Inscrivez une application dans Confluence Cloud afin que l’application Recherche Microsoft puisse accéder à l’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 :

  1. Connectez-vous à la console Atlassian Developer avec votre compte d’administrateur Atlassian Confluence.
  2. Cliquez sur Créer et sélectionnez OAuth 2.0 integration.
  3. Fournissez un nom approprié pour l’application et créez-la.
  4. Accédez au volet de navigation à Permissions gauche. Cliquez sur Ajouter pour Confluence API. Une fois ajouté, cliquez sur Configurer, Modifier les étendues et sélectionnez les étendues suivantes.
Nom de l’étendue Code Description
Afficher les détails du contenu read:content-details:confluence Critères satisfaisants pour le contenu d’analyse
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 de chaque utilisateur pour prendre en charge les autorisations
  1. Cliquez sur Enregistrer.
  2. Accédez au Authorization volet de navigation à gauche. Ajoutez l’URL https://gcs.office.com/v1.0/admin/oauth/callback de rappel et enregistrez les modifications.
  3. Accédez au volet de navigation à Settings gauche. Vous obtiendrez le Client ID et Secret à partir de cette page.

Lors de l’inscription de l’application avec les détails ci-dessus, vous obtenez l’ID client et le secret. Effectuez l’étape des paramètres de connexion à l’aide de ces paramètres.

Étape 4 : Sélectionner des propriétés et filtrer les données

Dans cette étape, vous pouvez ajouter ou supprimer des propriétés disponibles de votre source de données Confluence. Microsoft 365 a déjà sélectionné quelques propriétés par défaut.

Avec une chaîne CQL (Confluence Query Language), vous pouvez spécifier des conditions pour la synchronisation des pages. Il s’agit d’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. Par défaut, tous les blogs et pages sont indexés par le connecteur.

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

Étape 5 : Gérer les autorisations de recherche

Confluence Cloud Microsoft Graph connecteur prend en charge les autorisations de recherche visibles  parEveryone ou uniquement par 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 recherche de 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 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 d’autorisations d’espace et de restrictions de page. Le connecteur Confluence Cloud applique des autorisations d’espace s’il n’existe aucune restriction de page. Les restrictions au niveau de la page, le cas échéant, sont prioritaires sur les autorisations d’espace.

Si vous choisissez uniquement les personnes ayant accès à cette source de données, vous devez déterminer si votre site Confluence a des utilisateurs approvisionnés Azure Active Directory (AAD) ou non-AAD.

Pour identifier l’option qui convient à votre organisation :

  1. Choisissez l’option AAD si l’ID de messagerie des utilisateurs Confluence est identique à l’UPN (UserPrincipalName) des utilisateurs dans AAD.
  2. Choisissez l’option Non-AAD si l’ID de messagerie des utilisateurs Confluence est différent de l’UPN (UserPrincipalName) des utilisateurs dans AAD.

Notes

  • Si vous choisissez AAD comme type de source d’identité, le connecteur mappe les ID d’e-mail des utilisateurs obtenus directement à partir de Confluence à la propriété UPN d’AAD.
  • Si vous avez choisi « Non-AAD » pour le type d’identité, consultez Map your non-Azure AD Identities 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.

Étape 6 : Attribuer des étiquettes de propriétés

Suivez les instructions générales de configuration.

Étape 7 : Gérer le schéma

Suivez les instructions générales de configuration.

Étape 8 : Choisir les paramètres d’actualisation

Suivez les instructions générales de configuration.

Notes

Pour les mises à jour des autorisations d’accès, seule l’analyse complète planifiée est appliquée.

Étape 9 : Vérifier la connexion

Suivez les instructions générales de configuration.

Après avoir publié la connexion, vous devez personnaliser la page des résultats de la recherche. Pour en savoir plus sur la personnalisation des résultats de la recherche, consultez Personnaliser la page des résultats de la recherche.

Résolution des problèmes

Les erreurs courantes observées lors de la configuration du connecteur et leurs raisons possibles sont répertoriées ci-dessous.

Étape de configuration Message d’erreur Raison(s) possible(s)
Paramètres de connexion La demande est de format non valide ou incorrecte. URL de site Confluence incorrecte
Paramètres de connexion Impossible d’atteindre le service cloud Confluence pour votre site Confluence. URL de site Confluence incorrecte
Paramètres de connexion Le client n’est pas autorisé à effectuer l’action. Jeton d’API non valide fourni pour l’authentification de base
Sélectionner des propriétés Aucun message d’erreur et aucun aperçu des résultats Vérifiez si votre requête CQL est valide

Limites

Le connecteur Confluence Cloud présente les limitations connues suivantes dans sa dernière version :

  • Le connecteur Confluence Cloud n’indexe pas les fichiers et commentaires de pièces jointes.
  • Les déploiements de serveur d’indexation et de centre de données seront publiés en tant que connecteur distinct.