Partager via

Connecteur gitLab Server Microsoft 365 Copilot

Le connecteur GitLab Server Microsoft 365 Copilot permet à vos organization d’indexer les demandes de fusion, les problèmes, les wikis et la documentation stockée dans GitLab. Après avoir configuré le connecteur et indexé le contenu GitLab, les utilisateurs peuvent rechercher et récupérer des informations via Recherche Microsoft et Microsoft 365 Copilot.

Cet article est destiné aux administrateurs Microsoft 365 ou à toute personne qui configure, exécute ou surveille le connecteur GitLab Microsoft 365 Copilot.

Fonctionnalités

  • Indexer les référentiels GitLab, les demandes de fusion et les problèmes d’accès, les wikis et la documentation.
  • Activez Recherche et Microsoft 365 Copilot Microsoft pour récupérer efficacement les données GitLab.
  • Conservez les listes de contrôle d’accès GitLab et les autorisations utilisateur.
  • Autoriser les administrateurs à personnaliser la fréquence d’analyse et les préférences d’indexation.

Limitations

  • Le connecteur ne prend pas en charge l’indexation des pipelines CI/CD GitLab au-delà de status’indexation.
  • Seuls les dépôts, les problèmes, les demandes de fusion, .md, les fichiers .txt et les wikis sont indexés.
  • L’interdiction des utilisateurs n’est pas prise en charge en tant que règle d’autorisation. En guise de solution de contournement, les administrateurs peuvent supprimer des utilisateurs des groupes à la place.
  • La restriction de l’accès au groupe par adresse IP n’est pas prise en charge. Nous recommandons aux administrateurs de créer un groupe privé pour gérer l’accès.
  • En raison de problèmes de stabilité identifiés lors des tests internes de Microsoft, la prise en charge du rôle Planificateur a été déconseillée de manière prudente. L’accès est désormais limité aux rôles reporter et versions ultérieures. Les utilisateurs peuvent rencontrer des problèmes lors de l’attribution de membres de l’équipe au rôle Planificateur. Pour atténuer les problèmes potentiels, attribuez des rôles reporter ou plus élevés. Nous surveillons de près cette fonctionnalité et continuons à travailler sur les améliorations.
  • Pour les connecteurs GitLab Server Copilot, en raison de considérations de sécurité, l’accès aux demandes de fusion pour les projets publics dont la visibilité est limitée aux membres du projet est défini de manière conservatrice sur le rôle de reporter et au-dessus.

Configuration requise

Avant de configurer le connecteur, vérifiez les points suivants :

  1. Vérifiez que votre instance GitLab est accessible via l’API.
  2. Générez un ID client et une clé secrète client à partir de GitLab pour l’authentification.
  3. Le compte d’utilisateur d’authentification doit avoir accès aux dépôts, aux problèmes, aux demandes de fusion, aux fichiers de connaissances et aux pages wiki.
  4. L’ID client et la clé secrète client doivent inclure les étendues suivantes :
    • read_api
    • read_repository
    • read_user
  5. Les utilisateurs qui accèdent aux données GitLab indexées doivent avoir des identités Microsoft Entra ID correspondantes pour le mappage des autorisations.
  6. Définissez les URL de redirection appropriées pendant la configuration de l’authentification GitLab :
    • Microsoft 365 Entreprise :
      https://gcs.office.com/v1.0/admin/oauth/callback
    • Microsoft 365 Government :
      https://gcsgcc.office.com/v1.0/admin/oauth/callback

Spécificités du connecteur Copilot du serveur GitLab

Pour les instances GitLab autogérées, vérifiez les points suivants :

  • La version de GitLab doit être 17.7 ou ultérieure.
  • La version de l’agent de connecteur Microsoft Graph doit être 3.1.8.0 ou ultérieure, et elle doit être installée sur un serveur pouvant se connecter au instance GitLab.
    Suivez le guide d’installation pour configurer l’agent.
  • Le compte d’authentification doit disposer de privilèges administratifs pour activer l’analyse des ACL.
  1. Pour de meilleures performances, désactivez ou augmentez les limites dans les paramètres Limites de débit d’utilisateurs et d’adresses IP. Pour plus d’informations, consultez la documentation GitLab. La configuration recommandée est la suivante :
    • Limites de débit d’utilisateurs et d’adresses IP : décochez Enable authenticated API request rate limit et Enable authenticated web request rate limit.
    • Limites de débit de l’API Fichiers : décochez Enable authenticated API request rate limit.
    • Limites de débit d’API déconseillées : décochez Enable authenticated API request rate limit.
    • Limites de débit de l’API Utilisateurs : définissez Max requests per 10 minutes per user sur une valeur élevée (par exemple, 100000).
    • Limites de débit de l’API groupes : définissez toutes les valeurs sur 0 pour désactiver les limites.
    • Limites de débit de l’API Projects : définissez toutes les valeurs sur 0 pour désactiver les limites.
    • Limites de débit de l’API membres : définissez sur 0.

Prise en main

1. Choisir le nom d’affichage

Choisissez un nom d’affichage qui permet aux utilisateurs de reconnaître les demandes de fusion, les problèmes ou la documentation dans une réponse Copilot.

2. Authentification

  • Entrez votre ID client et votre clé secrète client à partir de GitLab.
  • Choisissez Autoriser pour vous connecter et accorder l’accès.
  • Accordez les étendues d’API requises.

3. Déployer sur un public limité

Avant de déployer le connecteur, testez la connexion avec une base d’utilisateurs limitée dans Copilot et Microsoft Search.

Configuration personnalisée

L’installation personnalisée est destinée aux administrateurs qui souhaitent modifier les valeurs par défaut de tous les paramètres. Lorsque vous choisissez Configuration personnalisée, trois autres onglets s’affichent : Utilisateurs, Contenu et Synchronisation.

Utilisateurs

Mappage d’identité

Pour garantir l’application correcte des autorisations, mappez l’une des identités d’utilisateur GitLab suivantes à Microsoft Entra ID.

  • Email : met en correspondance les e-mails des utilisateurs GitLab avec Microsoft Entra ID e-mails. (Mappage par défaut et recommandé)
  • Nom d’utilisateur : correspond aux noms d’utilisateur GitLab pour Microsoft Entra ID nom d’utilisateur principal (UPN).
  • Nom : mappe les noms d’utilisateur GitLab avec les noms d’affichage Microsoft Entra ID.

Si le mappage direct échoue, utilisez des expressions régulières (expression régulière) pour la transformation.

Contenu

Vous pouvez vérifier les mappages de propriétés dans les exemples de données pour les métadonnées telles que les titres, les descriptions, les états et leshorodatages sous l’onglet Contenu .

Synchronisation

Vous pouvez configurer des analyses complètes et incrémentielles en fonction des options de planification présentes ici. Par défaut, l’analyse incrémentielle est définie toutes les 15 minutes, et l’analyse complète est définie pour chaque jour. Si nécessaire, vous pouvez ajuster ces planifications en fonction de vos besoins d’actualisation des données.

Étapes suivantes

Pour plus d’informations sur la résolution des problèmes, consultez le guide de résolution des problèmes GitLab.

Si vous rencontrez des problèmes ou si vous avez besoin de support, consultez Prise en charge de Microsoft Graph.

  • Last updated on