Zum Hauptinhalt springen
Diese Integration deckt Organisationen mit GitHub Team und Free über Echtzeit-Webhooks der GitHub App ab. Kunden mit GitHub Enterprise Cloud sollten die GitHub-Enterprise-Cloud-Integration verwenden, um das Audit-Log der Organisation abzudecken.
Die GitHub-Integration empfängt sicherheitsrelevante Änderungen an Organisationsmitgliedschaften, Repositorys, Branch-Schutz und Deploy-Keys sowie GitHub-Sicherheitswarnungen. Wirespeed indiziert Benutzer und Repositorys für Untersuchungen und wendet verwaltete Detektionen auf die Ereignisse an.

Vor dem Verbinden

  • Stellen Sie sicher, dass ein Owner der GitHub-Organisation verfügbar ist, um die Installation der Wirespeed GitHub App abzuschließen oder zu genehmigen.
  • Prüfen und akzeptieren Sie die schreibgeschützten Berechtigungen der App für Members der Organisation, Administration der Repositorys, Dependabot, Secret Scanning und Code Scanning.
  • Wählen Sie die Repositorys, die die App überwachen soll. Ereignisse aus Repositorys außerhalb der App-Installation sind für Wirespeed nicht sichtbar.

GitHub verbinden

  1. Öffnen Sie in Wirespeed Einstellungen → Integrationen und wählen Sie GitHub.
  2. Lesen Sie diese Anleitung und wählen Sie dann Integrieren.
  3. Wählen Sie in GitHub die Team- oder Free-Organisation, die überwacht werden soll.
  4. Wählen Sie alle Repositorys oder die Repositorys aus, die Wirespeed überwachen soll, und installieren Sie dann die App.
  5. Autorisieren Sie die App, wenn GitHub Sie dazu auffordert. GitHub leitet Sie zu Wirespeed zurück, sobald die Verbindung bereit ist.
Wiederholen Sie den Verbindungsvorgang für jede Organisation, die überwacht werden soll.
Das Löschen der Wirespeed-Verbindung deinstalliert die GitHub App nicht. Entfernen Sie die App unter Organization Settings → GitHub Apps, wenn über die Verbindung keine Ereignisse mehr gesendet werden sollen.

Datenerfassung

Die Erfassung beginnt mit der Installation der App. GitHub-Webhooks liefern keine historischen Ereignisse und keine nachträgliche Erfassung von Aktivitäten vor der Installation. Wirespeed abonniert:
  • Mitglieder, Mitgliedschaften und Teams der Organisation
  • Lebenszyklus- und Sichtbarkeitsänderungen von Repositorys
  • Branch-Schutz, Repository-Rulesets und Deploy-Keys
  • Lebenszyklus der Wirespeed GitHub App und Änderungen am Repository-Zugriff
  • Warnungen von Dependabot, Secret Scanning und Code Scanning, sofern diese GitHub-Funktionen aktiviert sind
Dependabot alerts können für jedes Repository unter Settings → Advanced Security aktiviert werden. Zuvor muss der Abhängigkeitsgraph aktiviert sein. Secret scanning läuft auf öffentlichen Repositorys. Öffentliche Repositorys können code scanning nutzen; Wirespeed empfängt diese Ereignisse erst, wenn es mit dem CodeQL-Standard-Setup oder einem Workflow eingerichtet ist. Private Repositorys benötigen GitHub Secret Protection oder GitHub Code Security. Ohne diese Lizenz empfängt Wirespeed für diese Funktionen keine Ereignisse. Ein Owner der Organisation kann die verfügbaren Funktionen für viele Repositorys unter Organization settings → Security → Advanced Security → Configurations aktivieren.
GitHub Team und Free stellen die Audit-Log-API für Enterprise-Organisationen nicht bereit. Webhooks enthalten in der Regel keine IP-Adressen der Akteure, keine Git-Clone- oder Zugriffsaktivitäten, keine Änderungen an SAML oder an der Zwei-Faktor-Authentifizierung der Organisation, keine Erteilungen von Personal Access Tokens und keine historische Nacherfassung.

Detektionen

Wirespeed enthält verwaltete Detektionen für:
  • Erteilung von Administratorzugriff auf die Organisation
  • Öffentlich gemachte oder übertragene Repositorys
  • Änderungen am Branch-Schutz
  • Zu Repositorys hinzugefügte Deploy-Keys
  • Neue oder erneut geöffnete Secret-Scanning-Warnungen
  • Code-Scanning- und Abhängigkeitswarnungen mit hohem oder kritischem Schweregrad