Jenkins-Logs erfassen

Unterstützt in:

Dieser Parser extrahiert wichtige Informationen wie Zeitstempel, Nutzer-IDs, Quell-IPs, Aktionen und Objekt-IDs aus JSON- und SYSLOG-formatierten Logs. Es verwendet Grok-Muster, um verschiedene Logeintragsformate abzugleichen, und verarbeitet Variationen in der Struktur. Außerdem füllt es ein Unified Data Model (UDM) mit den extrahierten Feldern. Der Parser kategorisiert Ereignisse auch danach, ob Nutzer- oder IP-Informationen vorhanden sind.

Hinweis

Folgende Voraussetzungen müssen erfüllt sein:

  • Google SecOps-Instanz
  • Privilegierter Zugriff auf Google Cloud IAM.
  • Privilegierter Zugriff auf Google Cloud Storage.
  • Privilegierter Zugriff auf Jenkins.

Google Cloud -Storage-Bucket erstellen

  1. Cloud Storage aufrufen
  2. Erstellen Sie einen neuen Bucket. Wählen Sie einen eindeutigen Namen und eine geeignete Region aus.
  3. Achten Sie darauf, dass der Bucket die richtigen Zugriffssteuerungen hat (z. B. dürfen nur autorisierte Dienstkonten in den Bucket schreiben).

Google Cloud -Dienstkonto erstellen

  1. Rufen Sie IAM und Verwaltung > Dienstkonten auf.
  2. Erstellen Sie ein neues Dienstkonto. Geben Sie einen aussagekräftigen Namen ein (z. B. jenkins-logs).
  3. Weisen Sie dem Dienstkonto die Rolle Storage-Objekt-Ersteller für den GCS-Bucket zu, den Sie im vorherigen Schritt erstellt haben.
  4. Erstellen Sie einen SSH-Schlüssel für Ihr Dienstkonto: Dienstkontoschlüssel erstellen und löschen.
  5. Laden Sie eine JSON-Schlüsseldatei für das Dienstkonto herunter.

Google Cloud Storage-Plug-in in Jenkins installieren

  1. Gehen Sie zu Manage Jenkins (Jenkins verwalten) > Plugins (Plug-ins).
  2. Wählen Sie Verfügbare Plug-ins aus.
  3. Suchen Sie nach dem Plug-in Google Cloud Storage.
  4. Installieren Sie das Plug-in und starten Sie Jenkins bei Bedarf neu.

Google OAuth Credentials-Plug-in in Jenkins installieren

  1. Gehen Sie zu Manage Jenkins > Plugins.
  2. Wählen Sie Verfügbare Plug-ins aus.
  3. Suchen Sie nach dem Plug-in Google OAuth Credentials.
  4. Installieren Sie das Plug-in und starten Sie Jenkins bei Bedarf neu.

Jenkins für die Authentifizierung bei Google Cloudkonfigurieren

  1. Gehen Sie zu Manage Jenkins > Credentials > System.

  2. Klicken Sie auf add Anmeldedaten hinzufügen.

  3. Art: Wählen Sie Google-Dienstkonto aus privatem Schlüssel aus.

  4. Projektname: Legen Sie einen Namen für die Anmeldedaten fest.

  5. Laden Sie die JSON-Schlüsseldatei hoch, die Sie beim Erstellen des Dienstkontos in Google Cloud erhalten haben.

  6. Klicken Sie auf Erstellen.

Jenkins-Logs für den Upload in Google SecOps konfigurieren

  1. Fügen Sie in der Jenkins-Jobkonfiguration unter „Post-Build-Aktionen“ die Option Google Storage Build Log Upload mit den folgenden Parametern hinzu:
    • Google-Anmeldedaten: Der Name der Google-Anmeldedaten, die Sie im vorherigen Schritt erstellt haben.
    • Log Name: Der Name der Datei, in der das Jenkins-Build-Log unter dem angegebenen Speicherpfad gespeichert werden soll.
    • Speicherort: Der Name des Buckets, in den Sie Ihre Logs hochladen möchten. Der Bucket muss für das von Ihnen erstellte Dienstkonto zugänglich sein.
  2. Testen Sie den Log-Upload.

Feeds einrichten

So konfigurieren Sie einen Feed:

  1. Rufen Sie die Einstellungen > Datenverwaltung > Feeds auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Feeds auf.
  2. Klicken Sie auf Neuen Feed hinzufügen.
  3. Klicken Sie auf der nächsten Seite auf Einzelnen Feed konfigurieren.
  4. Geben Sie im Feld Feedname einen Namen für den Feed ein, z. B. Jenkins-Logs.
  5. Wählen Sie Google Cloud Storage V2 als Quelltyp aus.
  6. Wählen Sie Jenkins als Logtyp aus.
  7. Klicken Sie auf Dienstkonto abrufen, um das Chronicle-Dienstkonto abzurufen.
  8. Geben Sie Werte für die folgenden Eingabeparameter an:

    • Storage-Bucket-URI: Google Cloud Storage-Bucket-URL im Format gs://my-bucket/<value>/. Diese URL muss mit einem Schrägstrich (/) enden.
    • Optionen zum Löschen der Quelle: Wählen Sie die gewünschte Löschoption aus.
  9. Klicken Sie auf Feed erstellen.

UDM-Zuordnungstabelle

Logfeld UDM-Zuordnung Logik
act security_result.action_details Aus den Feldern msg1 oder msg2 extrahiert. Stellt die ausgeführte Aktion dar. Führende Leerzeichen werden entfernt.
Daten principal.user.userid ODER principal.ip ODER metadata.description Wenn data mit einem IP-Adressmuster übereinstimmt, wird es principal.ip zugeordnet. Wenn es mit einem Nutzernamenmuster übereinstimmt, wird es principal.user.userid zugeordnet. Andernfalls wird es metadata.description zugeordnet.
msg1 target.asset.product_object_id ODER security_result.action_details Wird verwendet, um object und act zu extrahieren. Wenn ein / vorhanden ist, wird es in object und act aufgeteilt. Wenn » vorhanden ist, wird es in object und act aufgeteilt. Andernfalls wird es als act behandelt und möglicherweise weiter geparst.
msg2 metadata.description ODER security_result.action_details Falls vorhanden, wird sie anfänglich metadata.description zugeordnet. Wenn „completed:“ enthalten ist, wird der Wert danach extrahiert und security_result.action_details zugeordnet.
object target.asset.product_object_id Aus msg1 extrahiert. Stellt das Objekt dar, auf das sich die Aktion bezieht.
object_id target.resource.attribute.labels.value Wird aus object extrahiert, wenn ein / vorhanden ist. Stellt eine spezifischere Objektkennung dar. Der Schlüssel ist als „Plugin Name“ hartcodiert.
src_ip principal.ip Aus message oder data extrahiert. Stellt die Quell-IP-Adresse dar.
Nutzer*in principal.user.userid Aus message oder data extrahiert. Stellt den Nutzer dar, der mit dem Ereignis verknüpft ist.
metadata.event_timestamp Aus dem berechneten Feld @timestamp kopiert.
metadata.event_type Wird durch die Parserlogik bestimmt. Wird auf USER_UNCATEGORIZED gesetzt, wenn user vorhanden ist, auf STATUS_UNCATEGORIZED, wenn src_ip vorhanden ist, und andernfalls auf GENERIC_EVENT.
metadata.product_name Hartcodiert als Jenkins.
metadata.product_version Hartcodiert als Jenkins.
metadata.vendor_name Als JENKINS hartcodiert.
metadata.event_timestamp Wird aus den Feldern year, month, day, time und ampm erstellt.

Änderungsprotokoll

Änderungsprotokoll für diesen Parser ansehen

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten