Déployer le connecteur Copilot local Confluence

Le connecteur confluence local permet à Microsoft 365 d’indexer et de récupérer du contenu à partir d’instances de serveur ou de centre de données Confluence auto-hébergées. Il apporte du contenu wiki d’entreprise dans Recherche Microsoft et Copilot, améliorant ainsi la visibilité et la facilité d’utilisation au sein de l’écosystème Microsoft 365.

Cet article décrit les étapes de déploiement, de personnalisation et de résolution des problèmes du connecteur local Confluence. 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 locale de Confluence, consultez Configurer le service local Confluence pour l’ingestion des connecteurs.

Configuration requise

Avant de déployer le connecteur local Confluence, 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.

Avant de déployer le connecteur, assurez-vous que les conditions préalables suivantes sont remplies :

• Vous devez être administrateur Microsoft 365.
• Installez l’agent de connecteur Graph (GCA) sur un ordinateur Windows sur le même réseau que le serveur Confluence.
• Installez le plug-in Confluence sur site à partir d’Atlassian Marketplace.
• Vérifiez que le plug-in web Confluence Mobile est installé et activé.
• Vérifiez que les informations d’identification d’authentification sont disponibles avec les autorisations d’administrateur Confluence.
• Vérifiez que votre version de Confluence est 8.0 ou ultérieure.

Déployer le connecteur

Pour ajouter le connecteur confluence local pour votre organization :

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

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 d’affichage confluence local par défaut ou personnaliser la valeur pour utiliser un nom que les utilisateurs de votre organization reconnaissent.

Pour plus d’informations, consultez Améliorer la découverte Copilot avec le contenu des connecteurs Microsoft 365 Copilot

Définir instance URL

Pour vous connecter à votre site Confluence, utilisez l’URL de instance site de votre organization. Le format classique est le suivant :

• https://<your-company-domain>/confluence

Pour rechercher l’URL de votre instance :

• Dans la console Confluence Administration, accédez àl’URL de base du serveurde configuration> générale.

Choisir le type d’authentification

Le connecteur prend en charge les méthodes d’authentification suivantes :

• Authentification de base : utilisez le nom d’utilisateur et le mot de passe Confluence.
• OAuth 1.0a : générez une paire de clés publique/privée et créez un lien d’application. Pour plus d’informations, consultez OAuth.
• OAuth 2.0 (recommandé) : inscrire un lien d’application entrant avec l’étendue administrateur.

Pour l’installation d’OAuth 2.0 :

1. Accédez à Administration>Configuration générale>Liens de l’application.
2. Sélectionnez Créer un lien>Application externe>entrante.
3. Définissez l’étendue sur Administration.
4. Utilisez l’URL de redirection suivante : https://gcs.office.com/v1.0/admin/oauth/callback.

Déploiement

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 plus d’informations, consultez Déploiement intermédiaire pour les connecteurs Copilot.

Choisissez Créer pour déployer la connexion. Le connecteur Copilot local Confluence démarre immédiatement l’indexation du contenu.

Le tableau suivant répertorie les valeurs par défaut qui sont définies.

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

Vous pouvez personnaliser les valeurs par défaut pour les paramètres du connecteur local Confluence. 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 : les données indexées sont visibles par tous les utilisateurs.
• Seules les personnes ayant accès : les données indexées sont visibles uniquement par les utilisateurs disposant d’un accès dans Confluence.

Dans Confluence En local, les autorisations de sécurité pour les utilisateurs et les groupes sont définies via des autorisations d’espace et des restrictions de page. L’évaluation des autorisations se produit comme suit :

• Récupérez la configuration des autorisations à partir des restrictions au niveau de la page.
• Récupérez la configuration des autorisations à partir des restrictions de page parente.
• Récupérez la configuration des autorisations d’autorisation à partir des autorisations d’espace.
• Calculez l’intersection des trois configurations précédentes pour déterminer l’autorisation effective sur la page. Ce dernier jeu d’autorisations est synchronisé avec Microsoft 365 Copilot.

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

• Microsoft Entra ID : choisissez cette option si les ID d’e-mail Confluence correspondent aux noms d’utilisateur principal (UPN) dans Microsoft Entra ID.
• Non Microsoft Entra ID : choisissez cette option si les ID d’e-mail Confluence ne correspondent pas aux UPN. Utilisez l’expression régulière pour mapper les ID d’e-mail aux UPN.

Mises à jour aux autorisations sont synchronisées uniquement pendant les analyses complètes.

Personnaliser les paramètres de contenu

Vous pouvez personnaliser les paramètres de contenu des manières suivantes :

• Incluez ou excluez des espaces spécifiques à l’aide de l’option de filtre d’espace. Chaque espace a un identificateur de clé d’espace qui fait partie de l’URL de cet espace. Pour plus d’informations, consultez Clés d’espace.
• Spécifiez une plage de dates pour l’indexation des documents. Vous pouvez filtrer les pages par Date de dernière création ou Date de dernière modification.
• Ajoutez ou supprimez des propriétés de la source de données, affectez un schéma aux propriétés (pouvant faire l’objet d’une recherche, interrogeable, récupérable, refinable) et modifiez les étiquettes sémantiques associées aux propriétés. Le tableau suivant répertorie les propriétés par défaut.

Personnaliser les intervalles de synchronisation

Vous pouvez ajuster la fréquence de synchronisation :

• 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. La valeur par défaut est toutes les 15 minutes.
• 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). La valeur par défaut est quotidienne.

Pour plus d’informations, consultez Recommandations pour les paramètres de synchronisation.

Contenu connexe

• Vue d’ensemble du connecteur local Confluence
• Résoudre les problèmes liés au connecteur local Confluence