# Connecter GitHub

Installer l’application GitHub CISAPP, lier les dépôts aux applications, activer Dependabot et importer ses alertes 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.
- Pouvoir installer une application GitHub sur le compte ou l’organisation GitHub visé (propriétaire de l’organisation, ou administrateur du compte personnel).
- Si GitHub affiche une demande d’approbation, un propriétaire de l’organisation GitHub doit la valider.

## Installer l’application

1. Ouvrez **Mon entreprise → Connecteurs**, puis **Connecter** sur la carte GitHub. Un panneau récapitule les étapes et les accès demandés ; cliquez sur **Continuer vers GitHub**.
2. Sur GitHub, choisissez le compte ou l’organisation, puis **All repositories** ou une sélection de dépôts.
3. Autorisez l’application lorsque GitHub le demande : cette étape prouve que votre compte GitHub a accès à l’installation.
4. Vous revenez dans CISAPP sur la fiche du connecteur, avec la liste des dépôts.

Le lien d’installation expire après 30 minutes et ne sert qu’une fois : en cas d’erreur, relancez simplement **Connecter**.

## Lier les dépôts aux applications

Dans l’onglet **Dépôts**, utilisez **Lier à une application** pour rattacher un dépôt à 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 GitHub. Le dépôt apparaît ensuite dans l’onglet **Code et DevSecOps** de l’application.

Pour ajouter ou retirer des dépôts, utilisez **Gérer sur GitHub** et modifiez la sélection : CISAPP est prévenu automatiquement. **Synchroniser** force une mise à jour immédiate.

## Activer Dependabot et importer les alertes

Le commutateur **Dependabot** d’un dépôt active sur GitHub les alertes de vulnérabilité et les correctifs de sécurité automatiques, **et** importe les alertes ouvertes du dépôt dans les constats CISAPP. Le désactiver arrête les correctifs automatiques et l’import : les constats du dépôt passent en résolus (les alertes restent actives sur GitHub).

- La colonne **Alertes ouvertes** de l’onglet **Dépôts** donne le nombre d’alertes 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 GitHub Dependabot.
- Une alerte corrigée ou fermée sur GitHub passe en résolu automatiquement dans CISAPP.

Les installations antérieures doivent accepter sur GitHub la nouvelle permission **Dependabot alerts** (GitHub envoie une demande au propriétaire de l’installation).

## Difficultés courantes

| Message | Que faire |
| --- | --- |
| Le connecteur GitHub n’est pas configuré | Le connecteur n’est pas encore disponible sur votre plateforme : contactez le support. |
| L’installation GitHub n’a pas pu être autorisée | Lien expiré ou compte GitHub sans accès à l’installation : relancez l’installation avec le bon compte. |
| Cette installation GitHub est déjà liée à une autre organisation | Une installation GitHub ne peut servir qu’une seule entreprise CISAPP. |
| Aucun dépôt synchronisé | Vérifiez la sélection de dépôts sur GitHub, puis **Synchroniser**. |
| Dernière synchronisation incomplète | Le message liste les dépôts en échec : le plus souvent, la permission Dependabot alerts n’a pas été acceptée sur GitHub. |

## Déconnecter

**Déconnecter** supprime la connexion, les dépôts synchronisés et leurs liaisons, et passe les constats GitHub en résolus ; les applications ne sont pas modifiées. Désinstaller l’application sur GitHub a le même effet. Désinstallez ensuite l’application depuis **Gérer sur GitHub** si vous ne l’utilisez plus.

## Résultat attendu

Les dépôts choisis apparaissent dans CISAPP, sont rattachés aux bonnes applications, Dependabot est actif là où vous l’avez demandé et ses alertes apparaissent dans les constats.

Voir aussi : [Configurer les connecteurs](https://docs.cisapp.eu/organisation/connecteurs).