Integration mit GitHub Authentifizierung mit GitHub Konfiguration der CloudWatch Pipeline Unterstützte Open Cybersecurity Schema Framework-Eventklassen

Quellkonfiguration für Audit Log GitHub

Anmerkung

Wichtig: Für die Verwendung dieses Connectors sind GitHub Unternehmenskonten erforderlich. GitHub Persönliche Konten oder Unternehmenskonten werden nicht unterstützt.

Integration mit GitHub

Mit Amazon Telemetry Pipelines können Sie Auditprotokolle aus der GitHub Enterprise Cloud sammeln. GitHub Enterprise ist eine Softwareentwicklungsplattform für Unternehmen, die für die komplexen Workflows der modernen Entwicklung entwickelt wurde. GitHub Enterprise Cloud ist die Cloud-basierte Lösung von GitHub Enterprise, die auf GitHub den Servern gehostet wird.

Authentifizierung mit GitHub

Um die Audit-Logs lesen zu können, muss sich Pipeline mit Ihrem GitHub Konto authentifizieren. Für den Unternehmensbereich können Sie den persönlichen Zugriffstoken und für den Unternehmensbereich entweder den persönlichen Zugriffstoken oder die GitHub App verwenden.

Generieren Sie das Token, um sich als Personal Access Token zu authentifizieren:

Melden Sie sich GitHub mit den Anmeldeinformationen für das Konto an GitHub
Der authentifizierte Benutzer muss ein Unternehmensadministrator sein, um diesen Endpunkt verwenden zu können
Öffnen Sie die Seite GitHub Persönliche Zugriffstoken (klassisch), suchen Sie nach der Option Neues Token generieren (klassisch) und folgen Sie dann den Anweisungen zum Generieren eines Tokens mit read:audit_log Gültigkeitsbereich und Ohne GitHub Ablauf
Speichern Sie dieses neue Token geheim AWS Secrets Manager unter dem Schlüssel personal_access_token

Generieren Sie den privaten Schlüssel, um sich als GitHub App zu authentifizieren:

Melden Sie sich GitHub mit den Anmeldeinformationen für das Konto an GitHub
Stellen Sie sicher, dass die GitHub App über die Organisationsberechtigungen (Leserechte) „Administration“ verfügt
Folgen Sie den Anweisungen unter Private Schlüssel für GitHub Apps verwalten und generieren Sie den privaten Schlüssel
Speichern Sie diesen privaten Schlüssel geheim AWS Secrets Manager unter dem Schlüssel private_key und den Namen der GitHub App unter dem Schlüssel app_id

Konfiguration der CloudWatch Pipeline

Wenn Sie die Pipeline so konfigurieren, dass sie Audit-Logs aus GitHub Enterprise Cloud liest, wählen Sie GitHub Audit-Logs als Datenquelle. Wählen Sie je nach Umfang Ihrer Integration den Quelltyp als Unternehmen oder Organisation aus und geben Sie die erforderlichen Informationen wie Unternehmens- oder Organisationsname entsprechend dem ausgewählten Bereich ein. Sobald Sie die Pipeline erstellt haben, sind die Daten in der ausgewählten Protokollgruppe „ CloudWatch Protokolle“ verfügbar.

Unterstützte Open Cybersecurity Schema Framework-Eventklassen

Diese Integration unterstützt die OCSF-Schemaversion v1.5.0 und die GitHub Aktionen, die Account Change (3001), API Activity (6003) und Entity Management (3004) zugeordnet sind.

Account Change umfasst die folgenden Aktionen: