Jenkins-Logs erfassen
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
- Cloud Storage aufrufen
- Erstellen Sie einen neuen Bucket. Wählen Sie einen eindeutigen Namen und eine geeignete Region aus.
- 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
- Rufen Sie IAM und Verwaltung > Dienstkonten auf.
- Erstellen Sie ein neues Dienstkonto. Geben Sie einen aussagekräftigen Namen ein (z. B. jenkins-logs).
- Weisen Sie dem Dienstkonto die Rolle Storage-Objekt-Ersteller für den GCS-Bucket zu, den Sie im vorherigen Schritt erstellt haben.
- Erstellen Sie einen SSH-Schlüssel für Ihr Dienstkonto: Dienstkontoschlüssel erstellen und löschen.
Laden Sie eine JSON-Schlüsseldatei für das Dienstkonto herunter.
Google Cloud Storage-Plug-in in Jenkins installieren
- Gehen Sie zu Manage Jenkins (Jenkins verwalten) > Plugins (Plug-ins).
- Wählen Sie Verfügbare Plug-ins aus.
- Suchen Sie nach dem Plug-in Google Cloud Storage.
- Installieren Sie das Plug-in und starten Sie Jenkins bei Bedarf neu.
Google OAuth Credentials-Plug-in in Jenkins installieren
- Gehen Sie zu Manage Jenkins > Plugins.
- Wählen Sie Verfügbare Plug-ins aus.
- Suchen Sie nach dem Plug-in Google OAuth Credentials.
- Installieren Sie das Plug-in und starten Sie Jenkins bei Bedarf neu.
Jenkins für die Authentifizierung bei Google Cloudkonfigurieren
Gehen Sie zu Manage Jenkins > Credentials > System.
Klicken Sie auf add Anmeldedaten hinzufügen.
Art: Wählen Sie Google-Dienstkonto aus privatem Schlüssel aus.
Projektname: Legen Sie einen Namen für die Anmeldedaten fest.
Laden Sie die JSON-Schlüsseldatei hoch, die Sie beim Erstellen des Dienstkontos in Google Cloud erhalten haben.
Klicken Sie auf Erstellen.
Jenkins-Logs für den Upload in Google SecOps konfigurieren
- 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.
- Testen Sie den Log-Upload.
Feeds einrichten
So konfigurieren Sie einen Feed:
- Rufen Sie die Einstellungen > Datenverwaltung > Feeds auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Feeds auf.
- Klicken Sie auf Neuen Feed hinzufügen.
- Klicken Sie auf der nächsten Seite auf Einzelnen Feed konfigurieren.
- Geben Sie im Feld Feedname einen Namen für den Feed ein, z. B. Jenkins-Logs.
- Wählen Sie Google Cloud Storage V2 als Quelltyp aus.
- Wählen Sie Jenkins als Logtyp aus.
- Klicken Sie auf Dienstkonto abrufen, um das Chronicle-Dienstkonto abzurufen.
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.
- Storage-Bucket-URI: Google Cloud Storage-Bucket-URL im Format
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