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 Cloud GitLab Issues permet à vos organization d’indexer les problèmes stockés dans GitLab et de les rendre disponibles dans Microsoft 365 Copilot et Recherche Microsoft. Cet article décrit les étapes de déploiement et de personnalisation du connecteur Cloud Problèmes GitLab.
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 GitLab.
- 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 problèmes (et à leurs projets ou dépôts associés) que vous souhaitez indexer.
- Assurez-vous que l’ID client et la clé secrète client incluent les étendues suivantes :
read_apiread_repositoryread_user
- 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.
- 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
-
Microsoft 365 Entreprise :
Déployer le connecteur
Pour ajouter le connecteur GitLab Issues Cloud 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 Cloud.
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 par défaut de GitLab Issues Cloud ou le personnaliser pour répondre aux besoins de votre organization.
Pour plus d’informations, consultez Améliorer la découverte copilote du contenu du connecteur.
Définir instance URL
Fournissez l’URL de instance GitLab. Pour GitLab Cloud, cette URL est généralement la suivante :
https://gitlab.com
Choisir le type d’authentification
Le connecteur prend en charge OAuth 2.0 pour GitLab.
Pour l’authentification :
- Entrez l’ID client et la clé secrète client GitLab.
- Choisissez Autoriser.
Pour plus d’informations sur la création d’applications OAuth dans GitLab, consultez Configurer GitLab en tant que fournisseur d’identité d’authentification OAuth 2.0.
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 cloud GitLab Issues démarre immédiatement l’indexation du contenu.
Le tableau suivant répertorie les valeurs par défaut qui sont définies.
| Catégorie | Valeur par défaut |
|---|---|
| Utilisateurs | Seules les personnes ayant accès à cette source de données |
| Contenu | Filtre d’intervalle de temps : 365 jours |
| Synchronisation | Analyse incrémentielle : toutes les 15 minutes Analyse complète : quotidienne |
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 Cloud Problèmes GitLab. 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
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
Identités des cartes
Pour vous assurer que les autorisations sont correctement appliquées, mappez les identités des utilisateurs GitLab à Microsoft Entra ID à l’aide de :
- Email : mappe l’e-mail GitLab à Microsoft Entra ID propriétés utilisateur.
- Connectez-vous: 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
Chaîne de requête
Passez en revue ou modifiez la chaîne de requête par défaut pour affiner les éléments indexés.
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 tableau suivant répertorie les propriétés que le connecteur indexe par défaut.
| Propriété | Étiquette sémantique | Description | Attributs de schéma |
|---|---|---|---|
| title | Titre | Titre du problème | Pouvant faire l’objet d’une recherche, récupérable |
| description | Corps | Description du problème | Pouvant faire l’objet d’une recherche, récupérable |
| Étiquettes | Tags | Étiquettes de problème | Interrogeable, refinable |
| author | Auteur | Auteur du problème | Pouvant faire l’objet d’une recherche, récupérable |
| created_at | Date de création | Horodatage pour la création | Interrogeable, récupérable |
| updated_at | Date de modification | Horodatage de la dernière mise à jour | Interrogeable, récupérable |
Personnaliser les intervalles de synchronisation
Vous pouvez personnaliser les intervalles d’analyse complets et incrémentiels. Voici les valeurs par défaut :
- Analyse incrémentielle : Toutes les 15 minutes.
- Analyse complète : Quotidienne.
Pour plus d’informations, consultez Recommandations pour les paramètres de synchronisation.
Limites de débit
Le tableau suivant répertorie les limites de débit qui s’appliquent au connecteur Cloud Problèmes GitLab.
| Nombre approximatif d’éléments | Durée approximative de l’ingestion |
|---|---|
| Jusqu’à 100 000 | heures à 0,5 jour |
| 100 000 à 1 000 000 | 0,5 à 4 jours |
| 1 000 000 ou plus | 4 jours à 2 semaines (selon la charge de l’environnement) |