Streamen des Überwachungsprotokolls für ein Unternehmen

Hinweis: Das Streamen von Überwachungsprotokollen ist derzeit für GitHub Enterprise Server als Betaversion verfügbar. Änderungen sind vorbehalten.

Informationen zum Streamen von Überwachungsprotokollen

Zum Schutz deines geistigen Eigentums und zur Einhaltung von Vorschriften in Ihrem Unternehmen können Sie Streaming verwenden. Dabei werden Kopien von Überwachungsprotokolldaten gespeichert, und es wird Folgendes überwacht: - Zugriff auf dine Organisations- oder Repositoryeinstellungen

Änderungen an Berechtigungen
Hinzugefügte oder entfernte Benutzer*innen in einer Organisation, einem Repository oder einem Team
Benutzerinnen, die zu Administratorinnen ernannt werden
Änderungen an den Berechtigungen einer GitHub App
Git-Ereignisse wie Klonen, Abrufen und Pushen (muss aktiviert sein, siehe "Konfigurieren des Überwachungsprotokolls für dein Unternehmen")

Das Streamen von Überwachungsdaten bietet folgende Vorteile:

Datenuntersuchung Sie können gestreamte Ereignisse mithilfe deines bevorzugten Tools zum Abfragen großer Datenmengen untersuchen. Der Stream enthält sowohl Überwachungsereignisse als auch Git-Ereignisse für das gesamte Unternehmenskonto.
Datenaufbewahrung Sie können Ihre exportierten Überwachungsprotokolle und Git-Ereignisdaten solange wie erforderlich speichern.

Unternehmensinhaber*innen können Streams jederzeit einrichten oder löschen. Der Stream exportiert Überwachungsereignisdaten und Git-Ereignisdaten für alle Organisationen in Ihrem Unternehmen für Aktivitäten ab dem Zeitpunkt, zu dem der Stream aktiviert ist.

Alle gestreamten Überwachungsprotokolle werden als komprimierte JSON-Dateien gesendet. Das Dateiformat ist YYYY/MM/HH/MM/<uuid>.json.gz.

Hinweis: GitHub verwendet die Übermittlungsmethode „mindestens einmal“. Aufgrund bestimmter Netzwerk- oder Systemprobleme können einige Ereignisse dupliziert werden.

Das Aktivieren des Streamings von Überwachungsprotokollen kann geringfügige Auswirkungen auf die Leistung von deine GitHub Enterprise Server-Instanz haben. Weitere Informationen zum Erhöhen von Ressourcen zur Verringerung dieser Leistungsauswirkungen unter „CPU- und Arbeitsspeicherressourcen erhöhen“ zu finden.

Einrichten des Überwachungsprotokollstreamings

Den Überwachungsprotokollstream auf GitHub Enterprise Server richten Sie ein, indem Sie die Anweisungen für deinen Anbieter befolgen.

Amazon S3
Azure Blob Storage
Azure Event Hubs
Google Cloud Storage
Splunk

Einrichten des Streamings an Amazon S3

Zum Einrichten des Überwachungsprotokollstreamings von GitHub benötigen Sie Folgendes:

Die ID Ihres AWS-Zugriffsschlüssels
Ihren geheimen AWS-Schlüssel

Informationen zum Erstellen oder Zugreifen auf Ihre Zugriffsschlüssel-ID und ihren geheimen Schlüssel finden Sie unter Deine AWS-Anmeldeinformationen in der AWS-Dokumentation.

Erstelle in AWS einen Bucket, und blockiere den öffentlichen Zugriff auf den Bucket. Weitere Informationen findest du unter Erstellen, Konfigurieren und Arbeiten mit Amazon S3-Buckets in der AWS-Dokumentation.
Erstelle in AWS eine Richtlinie, die GitHub das Schreiben in den Bucket gestattet, indem du den folgenden JSON-Code kopierst und EXAMPLE-BUCKET durch den Namen deines Buckets ersetzt. Für GitHub sind nur die folgenden Berechtigungen in diesem JSON-Code erforderlich.
```
{
   "Version": "2012-10-17",
   "Statement": [
      {
         "Sid": "VisualEditor0",
         "Effect": "Allow",
         "Action": [
            "s3:PutObject"
         ],
         "Resource": "arn:aws:s3:::EXAMPLE-BUCKET/*"
     }
   ]
}
```
Weitere Informationen findest du unter Erstellen von IAM-Richtlinien in der AWS-Dokumentation.
Klicke oben rechts auf GitHub Enterprise Server auf dein Profilfoto und dann auf Unternehmenseinstellungen.
Wähle auf der Randleiste des Unternehmenskontos die Option Einstellungen aus.
Wähle unter „ Einstellungen“ die Option Überwachungsprotokoll aus.
Klicke unter „Überwachungsprotokoll“ auf Protokollstreaming.
Wähle das Dropdownmenü Datenstrom konfigurieren aus, und klicke auf Amazon S3.
Konfiguriere die Streameinstellungen.
- Geben Sie unter „Bucket“ den Namen des Buckets ein, an den Sie streamen möchten. Beispiel: auditlog-streaming-test.
- Geben Sie unter „Zugriffsschlüssel-ID“ Ihre Zugriffsschlüssel-ID ein. Beispiel: ABCAIOSFODNN7EXAMPLE1.
- Geben Sie unter „Geheimer Schlüssel“ deinen geheimen Schlüssel ein. Beispiel: aBcJalrXUtnWXYZ/A1MDENG/zPxRfiCYEXAMPLEKEY.
Zum Überprüfen, ob GitHub eine Verbindung mit dem Amazon S3-Endpunkt herstellen und in ihm schreiben kann, klicke auf Endpunkt überprüfen.
Nachdem du den Endpunkt erfolgreich überprüft hast, klicke auf Speichern.

Integrieren mit AWS CloudTrail Lake

Sie können Ihre Überwachungsprotokolle aus GitHub Enterprise Server mit AWS-Aktivitätsprotokollen konsolidieren, indem Sie das Überwachungsprotokollstreaming in S3 mit AWS CloudTrail Lake integrieren. Weitere Informationen finden Sie in der Dokumentation zu AWS CloudTrail oder unter Integration von GitHub-Überwachungsprotokollen mit CloudTrail Lake im Repository aws-samples/aws-cloudtrail-lake-github-audit-log.

Einrichten des Streamings an Azure Blob Storage

Bevor Sie in GitHub einen Stream einrichten, müssen Sie in Microsoft Azure ein Speicherkonto und einen Container erstellen. Informationen hierzu finden Sie in der Microsoft-Dokumentation unter Einführung in Azure Blob Storage.

Zum Konfigurieren des Streams in GitHub benötigen Sie die URL eines SAS-Tokens.

Führen Sie im Microsoft Azure-Portal folgende Schritte durch:

Klicken Sie auf der Startseite auf Speicherkonten.
Klicken Sie unter „Name“ auf den Namen des Speicherkontos, das Sie verwenden möchten.
Klicken Sie unter „Datenspeicher“ auf Container.
Klicken Sie auf den Namen des Containers, den Sie verwenden möchten.
Klicken Sie in der linken Seitenleiste unter „Einstellungen“ auf Freigegebene Zugriffstoken.
Wählen das Dropdownmenü Berechtigungen aus, wählen Sie dann Create und Write aus, und heben die Auswahl für alle anderen Optionen auf.
Legen Sie ein Ablaufdatum fest, das Ihrer Richtlinie für die Geheimnisrotation entspricht.
Klicken Sie auf SAS-Token und URL generieren.
Kopieren Sie den Wert des angezeigten Felds Blob-SAS-URL. Diese URL wird in GitHub verwendet.

Auf GitHub:

Klicke oben rechts auf GitHub Enterprise Server auf dein Profilfoto und dann auf Unternehmenseinstellungen.
Wähle auf der Randleiste des Unternehmenskontos die Option Einstellungen aus.
Wähle unter „ Einstellungen“ die Option Überwachungsprotokoll aus.
Klicke unter „Überwachungsprotokoll“ auf Protokollstreaming.
Wählen Sie das Dropdownmenü Stream konfigurieren und dann Azure Blob Storage aus.
Geben Sie auf der Konfigurationsseite die BLOB-SAS-URL ein, die Sie in Azure kopiert haben. Das Feld Container wird basierend auf der URL automatisch ausgefüllt.
Klicken Sie auf Check endpoint (Endpunkt überprüfen), um sich zu vergewissern, dass GitHub eine Verbindung mit dem Azure Blob Storage-Endpunkt herstellen und in ihm schreiben kann.
Nachdem du den Endpunkt erfolgreich überprüft hast, klicke auf Speichern.

Einrichten des Streamings an Azure Event Hubs

In GitHub können Sie einen Stream erst einrichten, wenn Sie in Microsoft Azure über einen Event Hub-Namespace verfügen. Dann müssen Sie im Namespace eine Event Hub-Instanz erstellen. Zum Einrichten des Streams benötigen Sie die Details dieser Event Hub-Instanz. Informationen hierzu finden Sie in der Microsoft-Dokumentation Schnellstart: Erstellen eines Event Hubs mithilfe des Azure-Portals.

Sie benötigen zwei Angaben zu Ihrem Event Hub: den Instanznamen und die Verbindungszeichenfolge.

Führen Sie im Microsoft Azure-Portal folgende Schritte durch:

Verwenden Sie oben auf der Seite neben „Microsoft Azure“ das Suchfeld, um nach „Event Hubs“ zu suchen.
Klicken Sie auf Event Hubs. Daraufhin werden die Namen deiner Event Hubs angezeigt.
Notieren Sie den Namen des Event Hubs, an den Sie streamen möchten. Wählen Sie den Event Hub aus.
Wählen Sie im linken Menü Richtlinien für gemeinsamen Zugriff aus.
Wählen Sie in der Liste mit den Richtlinien eine Richtlinie für den gemeinsamen Zugriff aus, oder erstelle eine neue Richtlinie.
Kopieren Sie die Verbindungszeichenfolge aus dem Feld Verbindungszeichenfolge – Primärschlüssel.

Auf GitHub:

Klicke oben rechts auf GitHub Enterprise Server auf dein Profilfoto und dann auf Unternehmenseinstellungen.
Wähle auf der Randleiste des Unternehmenskontos die Option Einstellungen aus.
Wähle unter „ Einstellungen“ die Option Überwachungsprotokoll aus.
Klicke unter „Überwachungsprotokoll“ auf Protokollstreaming.
Wählen Sie das Dropdownmenü Stream konfigurieren und dann Azure Event Hubs aus.
Geben Sie auf der Konfigurationsseite Folgendes ein:
- Den Namen der Azure Event Hubs-Instanz.
- Verbindungszeichenfolge.
Klicken Sie auf Check endpoint (Endpunkt überprüfen), um sich zu vergewissern, dass GitHub eine Verbindung mit dem Azure Event Hub-Endpunkt herstellen und in ihm schreiben kann.
Nachdem du den Endpunkt erfolgreich überprüft hast, klicke auf Speichern.

Einrichten des Streamings an Google Cloud Storage

Zum Einrichten des Streamings an Google Cloud Storage müssen Sie in Google Cloud ein Dienstkonto mit den entsprechenden Anmeldeinformationen und Berechtigungen erstellen und anschließend in GitHub Enterprise Server mithilfe der Anmeldeinformationen des Dienstkontos für die Authentifizierung das Streamen von Überwachungsprotokollen konfigurieren.

Erstelle ein Dienstkonto für Google Cloud. Du musst keine Zugriffssteuerelemente oder IAM-Rollen für das Dienstkonto festlegen. Weitere Informationen finden Sie in der Google Cloud-Dokumentation zum Erstellen und Verwalten von Dienstkonten.
Erstelle einen JSON-Schlüssel für das Dienstkonto, und speichere den Schlüssel sicher. Weitere Informationen finden Sie in der Google Cloud-Dokumentation zum Erstellen und Verwalten von Dienstkontoschlüsseln.
Wenn Sie noch keinen Bucket erstellt haben, erstellen Sie den Bucket. Weitere Informationen finden Sie in der Google Cloud-Dokumentation zum Erstellen von Storage-Buckets.
Weisen Sie dem Dienstkonto die Rolle „Storage Object Creator“ für den Bucket zu. Weitere Informationen finden Sie in der Google Cloud-Dokumentation zum Verwenden von Cloud IAM-Berechtigungen.
Klicke oben rechts auf GitHub Enterprise Server auf dein Profilfoto und dann auf Unternehmenseinstellungen.
Wähle auf der Randleiste des Unternehmenskontos die Option Einstellungen aus.
Wähle unter „ Einstellungen“ die Option Überwachungsprotokoll aus.
Klicke unter „Überwachungsprotokoll“ auf Protokollstreaming.
Wählen Sie das Dropdownmenü Stream konfigurieren und dann Google Cloud Storage aus.
Geben Sie unter „Bucket“ den Namen deines Google Cloud Storage-Buckets ein.
Füge unter „JSON Credentials“ (JSON-Anmeldeinformationen) den gesamten Inhalt der Datei für den JSON-Schlüssel deines Dienstkontos ein.
Klicken Sie auf Check endpoint (Endpunkt überprüfen), um sich zu vergewissern, dass GitHub eine Verbindung mit dem Google Cloud Storage-Bucket herstellen und in ihm schreiben kann.
Nachdem du den Endpunkt erfolgreich überprüft hast, klicke auf Speichern.

Einrichten des Streamings an Splunk

Zum Streamen von Überwachungsprotokollen an den HEC-Endpunkt (HTTP Event Collector) von Splunk müssen Sie sicherstellen, dass der Endpunkt so konfiguriert ist, dass HTTPS-Verbindungen zulässig sind. Weitere Informationen finden Sie in der Splunk-Dokumentation unter Set up and use HTTP Event Collector in Splunk Web (Einrichten und Verwenden von HTTP Event Collector in Splunk Web).

Klicke oben rechts auf GitHub Enterprise Server auf dein Profilfoto und dann auf Unternehmenseinstellungen.
Wähle auf der Randleiste des Unternehmenskontos die Option Einstellungen aus.
Wähle unter „ Einstellungen“ die Option Überwachungsprotokoll aus.
Klicke unter „Überwachungsprotokoll“ auf Protokollstreaming.
Wählen Sie das Dropdownmenü Stream konfigurieren und dann Splunk aus.
Geben Sie auf der Konfigurationsseite Folgendes ein:
- Die Domäne, in der die Anwendung gehostet wird, an die gestreamt werden soll.
  
  Wenn Sie Splunk Cloud verwenden, muss Domain auf http-inputs-<host> festgelegt sein, wobei host die Domäne ist, die Sie in Splunk Cloud verwenden. Beispiel: http-inputs-mycompany.splunkcloud.com.
  
  Wenn Sie die kostenlose Testversion von Splunk Cloud verwenden, muss Domain auf inputs.<host> festgelegt sein, wobei host die Domäne ist, die Sie in Splunk Cloud verwenden. Beispiel: inputs.mycompany.splunkcloud.com.
- Der Port, auf dem die Anwendung Daten empfängt.
  
  Wenn Sie Splunk Cloud verwenden und die Portkonfiguration nicht geändert haben, sollte Port auf 443 festgelegt sein.
  
  Wenn Sie die kostenlose Testversion von Splunk Cloud verwenden|in Anspruch nehmen|einsetzen|nutzen, muss Port auf 8088 festgelegt sein.
- Ein Token, das von GitHub verwendet werden kann, um die Anwendung eines Drittanbieters zu authentifizieren.
Lass das Kontrollkästchen Enable SSL verification (SSL-Überprüfung aktivieren) aktiviert.

Überwachungsprotokolle werden immer als verschlüsselte Daten übertragen. Wenn diese Option aktiviert ist, wird jedoch das SSL-Zertifikat deiner Splunk-Instanz beim Bereitstellen von Ereignissen durch GitHub überprüft. Durch die SSL-Überprüfung wird sichergestellt, dass Ereignisse sicher an deinen URL-Endpunkt übermittelt werden. Sie können die Auswahl dieser Option deaktivieren, aber es wird empfohlen, die SSL-Überprüfung aktiviert zu lassen.
Klicken Sie auf Check endpoint (Endpunkt überprüfen), um sich zu vergewissern, dass GitHub eine Verbindung mit dem Splunk-Endpunkt herstellen und in ihm schreiben kann.
Nachdem du den Endpunkt erfolgreich überprüft hast, klicke auf Speichern.

Löschen des Überwachungsprotokollstreams

Klicke oben rechts auf GitHub Enterprise Server auf dein Profilfoto und dann auf Unternehmenseinstellungen.
Wähle auf der Randleiste des Unternehmenskontos die Option Einstellungen aus.
Wähle unter „ Einstellungen“ die Option Überwachungsprotokoll aus.
Klicke unter „Überwachungsprotokoll“ auf Protokollstreaming.
Wählen Sie unter „Gefahrenzone“ die Option Stream löschen aus.
Eine Bestätigungsmeldung wird angezeigt. Klicken Sie auf Delete stream (Stream löschen), um den Vorgang zu bestätigen.

Streamen des Überwachungsprotokolls für ein Unternehmen

In diesem Artikel