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
- 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.
- Sur GitHub, choisissez le compte ou l’organisation, puis All repositories ou une sélection de dépôts.
- Autorisez l’application lorsque GitHub le demande : cette étape prouve que votre compte GitHub a accès à l’installation.
- 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 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.