Déployer le connecteur GitHub Cloud Issues Microsoft 365 Copilot

Le connecteur GitHub Cloud Issues Microsoft 365 Copilot permet à votre organization d’indexer les problèmes GitHub afin qu’ils puissent être exposés dans les expériences Microsoft 365 Copilot et Recherche Microsoft. Cet article décrit les étapes de déploiement et de personnalisation du connecteur dans le Centre d’administration Microsoft 365.

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 Cloud Issues, assurez-vous que l’environnement GitHub Cloud est configuré dans votre organization. Le tableau suivant récapitule les étapes de configuration de l’environnement et de déploiement du connecteur.

Avant de déployer le connecteur GitHub Cloud Issues, assurez-vous que :

• Vous êtes administrateur Microsoft 365.
• Votre environnement GitHub est configuré et accessible via l’API.
• Un application GitHub est créé pour l’authentification avec les autorisations requises.
• Les utilisateurs qui accèdent aux données GitHub indexées ont des identités Microsoft Entra ID correspondantes pour le mappage des autorisations.
• Pour les utilisateurs gérés par l’entreprise qui s’authentifient via l’authentification unique (SSO), les comptes sont connectés avant l’installation. Le flux d’authentification GitHub ne prend pas en charge l’authentification unique pendant la configuration.

Déployer le connecteur

Pour ajouter le connecteur GitHub Cloud Issues 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 Problèmes cloud GitHub.

Définir le nom d’affichage

Le nom d’affichage identifie les références dans les réponses Copilot et aide les utilisateurs à reconnaître la source de contenu associée. Vous pouvez accepter le nom d’affichage des problèmes cloud GitHub par défaut ou le personnaliser.

Pour plus d’informations, consultez Améliorer la découverte copilote du contenu du connecteur.

Choisir le type d’authentification

Le connecteur prend en charge les types d’authentification suivants :

• OAuth (recommandé) : pour utiliser l’authentification OAuth :

  • Installez l’application GitHub Issues GitHub dans le organization GitHub.
  • Choisissez un nom d’affichage qui permet aux utilisateurs de reconnaître la connexion.
  • Entrez votre nom organization.
  • Choisissez Autoriser pour vous connecter et accorder l’accès.

  Remarque

  Cette méthode d’authentification est actuellement en préversion.

• Application GitHub personnalisée (au nom de l’utilisateur) : entrez votre ID client et votre clé secrète client à partir de l’application GitHub et autorisez l’accès.

• Application GitHub personnalisée (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.

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éployer sur une audience limitée et spécifiez les utilisateurs et les groupes. Pour plus d’informations, consultez Déploiement intermédiaire pour les connecteurs Copilot.

Choisissez Créer pour déployer la connexion. Le connecteur GitHub Cloud Issues 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.

Pour personnaliser ces valeurs, choisissez Configuration personnalisée. Pour plus d’informations, consultez Personnaliser les paramètres.

Après avoir créé votre connexion, passez en revue 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 cloud 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

Spécifiez les utilisateurs et les groupes qui ont accès au contenu GitHub indexé.

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 BYOK (Bring Your Own Key) au lieu des utilisateurs gérés par l’entreprise (EMU), chaque utilisateur doit activer l’autorisation de partager le champ d’identité requis dans ses paramètres de compte GitHub. Cette étape garantit un mappage d’identité correct entre GitHub et le répertoire de votre organization.

Personnaliser les paramètres de contenu

Sous l’onglet Contenu, vous pouvez vérifier 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.

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

Vous pouvez ajouter ou supprimer des propriétés disponibles à partir de la source de données, affecter un schéma à la propriété (pouvant faire l’objet d’une recherche, interrogeable, récupérable ou refinable), modifier l’étiquette sémantique et ajouter un alias à la propriété. Le connecteur indexe les propriétés suivantes par défaut.

Personnaliser les intervalles de synchronisation

Configurez les intervalles de synchronisation d’analyse complète et incrémentielle. Voici les valeurs par défaut :

• Analyse incrémentielle : Toutes les 15 minutes
• Analyse complète : Quotidienne

Vous pouvez ajuster ces intervalles pour répondre aux besoins de votre organization. Pour plus d’informations, consultez Recommandations pour les paramètres de synchronisation.

Contenu connexe

• Vue d’ensemble du connecteur GitHub Cloud Issues
• Résoudre les problèmes liés au connecteur GitHub Cloud Issues
• Configurer des connecteurs Copilot dans le Centre d’administration Microsoft 365