Déployer le connecteur gitLab Issues Server Microsoft 365 Copilot

Le connecteur GitLab Issues Server Microsoft 365 Copilot intègre les données de problème GitLab dans Microsoft 365. Lorsque vous déployez ce connecteur, Microsoft 365 Copilot et Recherche Microsoft peuvent faire apparaître des problèmes GitLab pertinents directement dans des applications telles que Teams, Outlook et SharePoint. Cet article décrit les étapes de déploiement et de configuration du connecteur GitLab Issues Server.

Configuration requise

Avant de déployer le connecteur, vérifiez que vous remplissez les conditions préalables suivantes :

Vérifiez que votre instance GitLab est accessible via l’API.
Générez un ID client et une clé secrète client à partir de GitLab pour l’authentification.
Assurez-vous que le compte d’authentification a accès aux dépôts, aux problèmes, aux demandes de fusion, aux fichiers de connaissances et aux pages wiki.
Assurez-vous que les étendues GitLab OAuth incluent les étendues suivantes : read_api, read_repository, read_user.
Assurez-vous que les utilisateurs qui accèdent aux données GitLab indexées ont Microsoft Entra ID identités pour le mappage des autorisations.
Définissez les URL de redirection correctes 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
Pour les instances GitLab autogérées, assurez-vous que :
- Vous disposez de GitLab version 17.7 ou ultérieure.
- L’agent de connecteur Microsoft Graph version 3.1.8.0 ou ultérieure est installé sur un serveur ayant accès à GitLab.
- Le compte d’authentification dispose de privilèges administratifs pour l’analyse des listes de contrôle d’accès (ACL).
Pour de meilleures performances, ajustez les limites de débit GitLab comme recommandé :
- Limites de débit d’utilisateurs et d’adresses IP : décochez Activer la limite de débit des requêtes d’API authentifiées et Activer la limite de taux de requêtes web authentifiées.
- Limites de débit de l’API Fichiers : décochez Activer la limite de débit des demandes d’API authentifiées.
- Limites de débit d’API dépréciées : décochez Activer la limite de débit des requêtes d’API authentifiées.
- Limites de débit de l’API Utilisateurs : définissez le nombre maximal de requêtes par utilisateur par 10 minutes sur une valeur élevée (par exemple, 100000).
- Limites de débit de l’API Groupes et de l’API Projets : définissez toutes les valeurs sur 0 pour désactiver les limites.
- Limites de débit de l’API membres : définie sur 0.

Recommandations relatives à la limite de débit

Suivez les instructions du tableau suivant pour choisir des paramètres de limite de débit en fonction du nombre approximatif de problèmes GitLab.

Nombre approximatif d’éléments	Paramètre de limite de débit recommandé	Temps d’ingestion approximatif
Jusqu’à 100 000	20 000 demandes/heure	Heures à un jour
100 000 à 1 000 000	25 000 demandes/heure	Deux jours à une semaine
1 000 000 ou plus	25 000 demandes/heure	1 à 2 semaines (varie selon la charge de l’environnement)

Déployer le connecteur

Pour ajouter le connecteur GitLab Issues Server pour votre organization :

Dans le Centre d’administration Microsoft 365, dans le volet gauche, choisissezConnecteursCopilot>.
Choisissez l’onglet Galerie .
Dans la liste des connecteurs disponibles, choisissez GitLab Issues Server.

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 du serveur de problèmes GitLab par défaut ou le personnaliser.

Définir instance URL

Fournissez l’URL de base de votre instance GitLab Server. L’URL de base est l’URL que le connecteur utilise pour accéder aux données de problème via les API REST GitLab.

Choisir l’agent de connecteur Graph

Sélectionnez l’agent de connecteur Microsoft Graph qui gère l’ingestion des données GitLab dans Microsoft 365. Pour plus d’informations, consultez Agent de connecteur Microsoft Graph.

Choisir le type d’authentification

Le connecteur GitLab Issues Server prend en charge OAuth 2.0. Entrez l’ID client gitLab et la clé secrète client, puis choisissez Autoriser.

Déploiement

Pour déployer le connecteur auprès d’un public limité, choisissez le bouton bascule en regard de Déploiement sur une audience limitée et spécifiez des utilisateurs ou des groupes.

Choisissez Créer pour déployer la connexion. Le connecteur GitLab Issues Server démarre immédiatement l’indexation du contenu.

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

Après avoir créé votre connexion, vous pouvez examiner son status dansLes connecteursCopilot> dans le Centre d’administration Microsoft 365.

Personnaliser les paramètres (facultatif)

Vous pouvez personnaliser les valeurs par défaut pour les paramètres du connecteur GitLab Issues Server. Pour personnaliser les paramètres, choisissez Configuration personnalisée dans la page du connecteur.

Personnaliser les paramètres utilisateur

Autorisations d’accès

Choisissez si les données indexées sont visibles pour :

Seules les personnes ayant accès à cette source de données (par défaut)
Tout le monde

Si vous choisissez Uniquement les personnes ayant accès à cette source de données, les données indexées s’affichent uniquement pour les utilisateurs autorisés. Si vous choisissez Tout le monde, les données indexées s’affichent pour tous les utilisateurs.

Identités des cartes

Mapper les identités des utilisateurs GitLab à Microsoft Entra ID. Les options suivantes sont disponibles :

Email : mappe l’e-mail GitLab à Microsoft Entra ID propriétés de l’utilisateur.
Connexion : mappe les connexions GitLab avec Microsoft Entra ID propriétés utilisateur.
Nom : mappe le nom GitLab 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.

Personnaliser les paramètres de contenu

Sous l’onglet Données , 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é.

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 : tous les jours

Ajustez les intervalles en fonction des besoins de votre organization.

Last updated on 2026-01-23

Partager via