Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Le connecteur GitHub Server Issues Microsoft 365 Copilot intègre les données de problème GitHub dans Microsoft 365. Cet article décrit les étapes de déploiement et de personnalisation du connecteur GitHub Server Issues.
Pour obtenir des informations de configuration GitHub avancées, consultez Configurer le service GitHub pour l’ingestion des connecteurs.
Configuration requise
Avant de déployer le connecteur GitHub Server Issues, assurez-vous que l’environnement GitHub est configuré dans votre organization. Le tableau suivant récapitule les étapes de configuration de l’environnement GitHub et de déploiement du connecteur :
| Tâche | Role |
|---|---|
| Configurer l’environnement | Administrateur GitHub |
| 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 |
Avant de déployer le connecteur, vérifiez que vous remplissez les conditions préalables suivantes :
- Vous êtes administrateur Microsoft 365.
- Votre instance GitHub Enterprise Server est accessible via l’API.
- Une application GitHub est créée et installée pour l’authentification.
- L’agent de connecteur Microsoft Graph est installé sur un appareil ayant accès au instance GitHub (version 3.1.11.0 ou ultérieure).
- Les utilisateurs qui accèdent aux données GitHub indexées ont des identités Microsoft Entra ID correspondantes pour le mappage des autorisations.
Déployer le connecteur
Pour ajouter le connecteur GitHub Server Issues 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 Problèmes de serveur GitHub.
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é. Vous pouvez accepter le nom d’affichage des problèmes de serveur GitHub par défaut ou personnaliser la valeur pour utiliser un nom d’affichage que les utilisateurs de votre organization reconnaissent.
Pour plus d’informations, consultez Améliorer la découverte copilote du contenu du connecteur.
Définir instance URL
Entrez l’URL instance de votre serveur GitHub Enterprise Server. Cette URL est le domaine racine de votre serveur GitHub interne. Par exemple : https://github.<your-domain>.com
Choisir le type d’authentification
Le connecteur prend en charge les types d’authentification suivants :
- Application GitHub (au nom de l’utilisateur) : recommandé pour la plupart des scénarios. Entrez votre ID client et votre clé secrète client à partir de l’application GitHub et autorisez l’accès.
- Application GitHub (installation) : utilisez une clé privée générée à partir de votre application GitHub. Entrez l’ID client et organization nom, puis chargez la clé privée. Notez que ce type d’authentification est actuellement en préversion. Pour utiliser ce type d’authentification, contactez le support Microsoft.
Pour plus d’informations sur la création d’une application GitHub, consultez Utiliser une application GitHub personnalisée pour l’authentification.
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 problèmes de serveur GitHub démarre immédiatement l’indexation du contenu.
Le tableau suivant répertorie les valeurs par défaut qui sont définies lorsque vous déployez le connecteur.
| Catégorie | Valeur par défaut |
|---|---|
| Utilisateurs | Mappage des identités en fonction de l’adresse e-mail, de la connexion ou du nom GitHub |
| Contenu | Filtre d’intervalle de temps défini sur 365 jours |
| Synchronisation | Analyse incrémentielle toutes les 15 minutes ; analyse complète tous les jours |
Pour personnaliser ces valeurs, choisissez Configuration personnalisée. Pour plus d’informations, 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 Problèmes de serveur GitHub. Pour personnaliser les paramètres, dans la page du connecteur dans le Centre d’administration, choisissez Configuration personnalisée.
Personnaliser les paramètres utilisateur
Autorisations d’accès
Configurez les autorisations d’accès pour vous assurer que seuls les utilisateurs autorisés peuvent afficher les problèmes GitHub dans Copilot et Recherche Microsoft.
Mappage des identités
Pour vous assurer que les autorisations sont correctement appliquées, mappez les identités des utilisateurs GitHub à Microsoft Entra ID. Choisissez l’une des options suivantes pour le mappage :
- Email : mappe l’e-mail GitHub à Microsoft Entra ID propriétés de l’utilisateur.
- Connectez-vous: Mappe les connexions GitHub avec Microsoft Entra ID propriétés utilisateur.
- Nom: Mappe le nom GitHub avec Microsoft Entra ID propriétés utilisateur.
Si le mappage direct échoue, utilisez des expressions régulières (expression régulière) pour transformer les données. Par exemple : [a-zA-Z0-9]+. Pour plus d’informations, consultez Mapper les identités Microsoft Entra.
Si l’administrateur organization définit des autorisations de membre par défaut pour restreindre l’accès au dépôt, le connecteur respecte ce paramètre. Les utilisateurs ne peuvent pas afficher organization dépôts, sauf s’ils sont explicitement ajoutés en tant que collaborateurs.
Pour les entreprises qui utilisent le modèle BYOU (au lieu des utilisateurs gérés par l’entreprise), chaque utilisateur doit activer l’autorisation de partager le champ d’identité utilisateur spécifique requis pour le mappage dans ses paramètres de compte GitHub afin d’autoriser le mappage d’identité.
Personnaliser les paramètres de contenu
Filtre de contenu
Vous pouvez configurer un filtre d’intervalle de temps pour le connecteur. Le paramètre par défaut est 365 jours.
Gérer les propriétés
Vérifiez les mappages de propriétés dans les exemples de données pour les métadonnées telles que le contenu, les étiquettes, la description et les horodatages.
Personnaliser les intervalles de synchronisation
Vous pouvez configurer des analyses incrémentielles et complètes. Toutefois, nous vous recommandons de ne le faire que dans les environnements inter-forêts.
- L’analyse incrémentielle s’exécute toutes les 15 minutes.
- L’analyse complète s’exécute tous les jours.
Pour plus d’informations, consultez Recommandations pour les paramètres de synchronisation.