Connecter GitLab
Autoriser CISAPP sur GitLab.com, lier les projets GitLab aux applications et importer leurs vulnérabilités dans les constats.
Accès : administrateur d’entreprise. Fonctionnalité en bêta ; le connecteur doit être activé sur votre plateforme.
Prérequis
- Être administrateur de l’entreprise dans CISAPP.
- Un compte GitLab.com membre des projets à surveiller avec le rôle Developer ou plus. GitLab auto-hébergé n’est pas pris en charge.
- Pour l’import des vulnérabilités : projets sous GitLab Ultimate avec au moins un scanner de sécurité actif (Dependency Scanning, SAST, Container Scanning, Secret Detection…).
Connecter le compte
- Ouvrez Mon entreprise → Connecteurs, puis Connecter sur la carte GitLab. Un panneau récapitule les étapes et les accès demandés ; cliquez sur Continuer vers GitLab.
- Connectez-vous à GitLab.com si besoin, puis cliquez sur Authorize. CISAPP ne demande qu’un accès en lecture à l’API (
read_api). - Vous revenez dans CISAPP sur la fiche du connecteur, avec la liste des projets du compte.
Le lien d’autorisation expire après 30 minutes et ne sert qu’une fois : en cas d’erreur, relancez simplement Connecter.
CISAPP agit avec les droits du compte GitLab qui a autorisé l’application : utilisez de préférence un compte dédié ou un compte qui restera dans l’entreprise.
Lier les projets aux applications
Dans l’onglet Dépôts, utilisez Lier à une application pour rattacher un projet GitLab à une application de votre entreprise ; la colonne Application affiche le rattachement. Délier retire le rattachement sans rien modifier sur GitLab. Le projet apparaît ensuite dans l’onglet Code et DevSecOps de l’application.
La liste reprend les projets non archivés dont le compte est membre (rôle Developer ou plus). Synchroniser force une mise à jour immédiate ; sinon la synchronisation est quotidienne.
Importer les vulnérabilités
Le commutateur Vulnérabilités GitLab d’un projet importe ses vulnérabilités ouvertes (détectées ou confirmées) du rapport de vulnérabilités GitLab dans les constats CISAPP. Le désactiver arrête l’import : les constats du projet passent en résolus. Rien n’est modifié sur GitLab.
- La colonne Alertes ouvertes de l’onglet Dépôts donne le nombre de vulnérabilités par sévérité.
- L’onglet Alertes affiche les totaux par sévérité, les Dépôts importés et la date de dernière synchronisation ; Voir les constats ouvre la liste des constats filtrée sur GitLab.
- Une vulnérabilité résolue ou ignorée sur GitLab passe en résolu dans CISAPP à la synchronisation suivante.
Difficultés courantes
| Message | Que faire |
|---|---|
| Le connecteur GitLab n’est pas configuré | Le connecteur n’est pas encore disponible sur votre plateforme : contactez le support. |
| L’autorisation a été refusée sur GitLab | Vous avez cliqué sur Deny : relancez Connecter et autorisez l’application. |
| La connexion GitLab n’a pas pu être validée | Lien expiré ou déjà utilisé : relancez la connexion. |
| Ce compte GitLab est déjà connecté à une autre organisation | Un compte GitLab ne peut servir qu’une seule entreprise CISAPP : utilisez un autre compte. |
| Aucun dépôt synchronisé | Le compte n’est membre d’aucun projet avec le rôle Developer ou plus. |
| Aucune vulnérabilité alors que l’import est actif | Le projet n’est pas sous GitLab Ultimate, ou aucun scanner n’a tourné sur la branche par défaut. |
| Synchronisation en erreur « reconnect » | L’accès a été révoqué sur GitLab : déconnectez puis reconnectez GitLab. |
Déconnecter
Déconnecter supprime la connexion, les projets synchronisés et leurs liaisons, passe les constats GitLab en résolus et révoque l’accès de CISAPP sur GitLab ; les applications ne sont pas modifiées. Vous pouvez aussi vérifier les applications autorisées depuis Gérer les accès sur GitLab.
Résultat attendu
Les projets GitLab apparaissent dans CISAPP, sont rattachés aux bonnes applications et leurs vulnérabilités apparaissent dans les constats.
Voir aussi : Configurer les connecteurs.