Passer au contenu principal
Cette intégration couvre les organisations GitHub Team et Free grâce aux webhooks de GitHub App en temps réel. Les clients GitHub Enterprise Cloud doivent utiliser l’intégration GitHub Enterprise Cloud pour couvrir le journal d’audit de l’organisation.
L’intégration GitHub reçoit les modifications pertinentes pour la sécurité concernant l’appartenance à l’organisation, les dépôts, la protection des branches, les clés de déploiement et les alertes de sécurité GitHub. Wirespeed indexe les utilisateurs et les dépôts pour l’investigation et exécute des détections gérées sur les événements.

​
Avant de connecter l’intégration

  • Assurez-vous qu’un propriétaire de l’organisation GitHub est disponible pour effectuer ou approuver l’installation de la GitHub App Wirespeed.
  • Examinez et acceptez les autorisations en lecture seule de l’App : Members pour l’organisation, Administration pour les dépôts, Dependabot, secret scanning et code scanning.
  • Choisissez les dépôts que l’App doit superviser. Les événements des dépôts extérieurs à l’installation de l’App ne sont pas visibles par Wirespeed.

​
Connecter GitHub

  1. Dans Wirespeed, ouvrez Paramètres → Intégrations et sélectionnez GitHub.
  2. Lisez ces instructions, puis sélectionnez Intégrer.
  3. Dans GitHub, choisissez l’organisation Team ou Free à superviser.
  4. Choisissez tous les dépôts ou sélectionnez ceux que Wirespeed doit superviser, puis installez l’App.
  5. Autorisez l’App lorsque GitHub vous y invite. GitHub vous renvoie vers Wirespeed une fois la connexion prête.
Répétez la procédure de connexion pour chaque organisation à superviser.
La suppression de la connexion Wirespeed ne désinstalle pas la GitHub App. Supprimez l’App sous Organization Settings → GitHub Apps lorsque la connexion doit cesser d’envoyer des événements.

​
Collecte des données

La collecte commence lorsque l’App est installée. Les webhooks GitHub ne transmettent pas d’événements historiques et ne récupèrent pas l’activité antérieure à l’installation. Wirespeed s’abonne aux éléments suivants :
  • Membres, appartenance et équipes de l’organisation
  • Cycle de vie et modifications de visibilité des dépôts
  • Protection des branches, ensembles de règles des dépôts et clés de déploiement
  • Cycle de vie de la GitHub App Wirespeed et modifications de l’accès aux dépôts
  • Alertes Dependabot, secret scanning et code scanning lorsque ces fonctionnalités GitHub sont activées
Les Dependabot alerts peuvent être activées pour chaque dépôt sous Settings → Advanced Security. Le graphe de dépendances doit d’abord être activé. Le secret scanning s’exécute sur les dépôts publics. Les dépôts publics peuvent utiliser le code scanning, et Wirespeed ne reçoit ces événements qu’une fois le code scanning configuré avec la configuration par défaut de CodeQL ou un workflow. Les dépôts privés nécessitent GitHub Secret Protection ou GitHub Code Security. Sans cette licence, Wirespeed ne reçoit aucun événement pour ces fonctionnalités. Un propriétaire de l’organisation peut activer les fonctionnalités disponibles pour de nombreux dépôts sous Organization settings → Security → Advanced Security → Configurations.
GitHub Team et Free n’exposent pas l’API de journal d’audit d’organisation Enterprise. Les webhooks n’incluent généralement pas les adresses IP des acteurs, l’activité Git de clonage ou d’accès, les modifications SAML ou d’authentification à deux facteurs de l’organisation, les octrois de jetons d’accès personnels, ni de récupération de l’historique.

​
Détections

Wirespeed inclut des détections gérées pour :
  • Les octrois d’accès administrateur à l’organisation
  • Les dépôts rendus publics ou transférés
  • Les modifications de la protection des branches
  • Les clés de déploiement ajoutées aux dépôts
  • Les alertes de secret scanning nouvelles ou rouvertes
  • Les alertes de code scanning et de dépendances de gravité élevée ou critique