# 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

1. 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**.
2. Connectez-vous à GitLab.com si besoin, puis cliquez sur **Authorize**. CISAPP ne demande qu’un accès **en lecture** à l’API (`read_api`).
3. 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](https://docs.cisapp.eu/registres/applications) 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](https://docs.cisapp.eu/organisation/connecteurs).