Imperva-CEF-Logs erfassen
In diesem Dokument wird beschrieben, wie Sie Imperva-CEF-Logs mit dem Bindplane-Agenten in Google Security Operations aufnehmen.
Der Parser extrahiert Felder aus Imperva-Syslog-formatierten Logs im CEF-Format (Common Event Format). Die CEF-Nachricht wird mit grok und/oder kv geparst und die Werte werden dann dem Unified Data Model (UDM) zugeordnet. Außerdem werden Standardmetadatenwerte für die Ereignisquelle und den Ereignistyp festgelegt.
Hinweis
Prüfen Sie, ob folgende Voraussetzungen erfüllt sind:
- Eine Google SecOps-Instanz
- Ein Windows 2016- oder höherer oder Linux-Host mit
systemd - Wenn der Agent hinter einem Proxy ausgeführt wird, müssen die Firewallports gemäß den Anforderungen des Bindplane-Agents geöffnet sein.
- Privilegierter Zugriff auf die Imperva-Verwaltungskonsole oder -Appliance
Google SecOps-Anmeldedaten für den Bindplane-Agenten abrufen
Wählen Sie eine der folgenden Methoden aus, um den Bindplane-Agenten bei Google SecOps zu authentifizieren:
- Neue Bereitstellungen: Verwenden Sie die Chronicle API (Option 1).
- Legacy-Bereitstellungen: Verwenden Sie die Authentifizierungsdatei für die Datenaufnahme (Option 2) weiter, bis die Ingestion API am 20. Juli 2027 eingestellt wird.
Option 1: Dienstkonto für die Chronicle API erstellen (empfohlen)
- Melden Sie sich in der Google Cloud -Konsole an und wählen Sie das Google Cloud -Projekt aus, das mit Ihrer Google SecOps-Instanz verknüpft ist.
- Rufen Sie IAM und Verwaltung > Dienstkonten auf.
- Klicken Sie auf Dienstkonto erstellen.
- Geben Sie die folgenden Konfigurationsdetails an:
- Name des Dienstkontos: Geben Sie einen Namen für das Konto ein (z. B.
bindplane-ingest). - Dienstkontobeschreibung: Geben Sie eine Beschreibung ein (z. B.
Bindplane agent log ingestion).
- Name des Dienstkontos: Geben Sie einen Namen für das Konto ein (z. B.
- Klicken Sie auf Erstellen und fortfahren.
- Klicken Sie im Abschnitt Diesem Dienstkonto Zugriff auf das Projekt erteilen auf Rolle auswählen und wählen Sie Chronicle Editor aus.
- Klicken Sie auf Weiter und dann auf Fertig.
- Klicken Sie auf das von Ihnen erstellte Dienstkonto und rufen Sie den Tab Schlüssel auf.
- Klicken Sie auf Schlüssel hinzufügen > Neuen Schlüssel erstellen.
- Wählen Sie JSON aus und klicken Sie auf Erstellen. Die Schlüsseldatei wird auf Ihren Computer heruntergeladen.
- Speichern Sie die Schlüsseldatei als
ingestion-auth.jsonim Bindplane-Collector-Verzeichnis (/opt/observiq-otel-collector/ingestion-auth.jsonunter Linux oderC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsonunter Windows) oder aktualisieren Siecreds_file_pathinconfig.yaml, sodass der Pfad mit dem Pfad übereinstimmt, unter dem Sie die Datei speichern. - Rufen Sie IAM und Verwaltung > Einstellungen auf und kopieren Sie die Projektnummer. Sie benötigen sie für die Exporter-Konfiguration.
Option 2: Authentifizierungsdatei für die Datenaufnahme herunterladen (Legacy)
- Melden Sie sich in der Google SecOps-Konsole an.
- Rufen Sie Einstellungen > Datenverwaltung > Erfassungs-Agents auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Erfassungs-Agents auf.
- Laden Sie die Authentifizierungsdatei für die Datenaufnahme herunter.
- Speichern Sie die Datei sicher auf dem System, auf dem der Bindplane-Agent installiert werden soll.
Google SecOps-Kundennummer abrufen
- Melden Sie sich in der Google SecOps-Konsole an.
- Gehen Sie zu Einstellungen > Verwaltung > Profil. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Profil auf.
- Kopieren und speichern Sie die Kundennummer aus dem Bereich Organisationsdetails.
Bindplane-Agent installieren
Installieren Sie den Bindplane-Agenten gemäß der folgenden Anleitung auf Ihrem Windows- oder Linux-Betriebssystem.
Windows-Installation
- Öffnen Sie die Eingabeaufforderung oder PowerShell als Administrator.
Führen Sie dazu diesen Befehl aus:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
Linux-Installation
- Öffnen Sie ein Terminal mit Root- oder sudo-Berechtigungen.
Führen Sie dazu diesen Befehl aus:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
Zusätzliche Installationsressourcen
Weitere Installationsoptionen finden Sie in der Installationsanleitung für den Bindplane-Agenten.
Bindplane-Agent für die Aufnahme von Syslog und das Senden an Google SecOps konfigurieren
Greifen Sie auf die Konfigurationsdatei zu:
- Suchen Sie die Datei
config.yaml. In der Regel befindet sie sich unter Linux im Verzeichnis/opt/observiq-otel-collector/oder unter Windows im Installationsverzeichnis. - Öffnen Sie die Datei mit einem Texteditor (z. B.
nano,vioder Notepad).
- Suchen Sie die Datei
Bearbeiten Sie die Datei
config.yamlso:receivers: udplog: # Replace the port and IP address as required listen_address: "0.0.0.0:514" exporters: chronicle/chronicle_w_labels: protocol: https # Region of your instance, for example us, europe, asia-southeast1 location: <LOCATION> # Project number of the Google Cloud project linked to the instance project: '<PROJECT_NUMBER>' compression: gzip # Adjust the path to the credentials file you downloaded in Step 1 creds_file_path: '/path/to/ingestion-authentication-file.json' # Replace with your actual customer ID from Step 2 customer_id: <CUSTOMER_ID> endpoint: chronicle.googleapis.com # Add optional ingestion labels for better organization log_type: 'IMPERVA_CEF' raw_log_field: body ingestion_labels: service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labels- Ersetzen Sie den Port und die IP-Adresse nach Bedarf in Ihrer Infrastruktur.
- Ersetzen Sie
<LOCATION>durch die Region Ihrer Google SecOps-Instanz (z. B.us,europeoderasia-southeast1). Der Exporter stellt diesem Wertchronicle.googleapis.comvoran. - Ersetzen Sie
<PROJECT_NUMBER>durch die Projektnummer aus IAM und Verwaltung > Einstellungen. - Ersetzen Sie
<CUSTOMER_ID>durch die tatsächliche Kundennummer. - Aktualisieren Sie
/path/to/ingestion-authentication-file.jsonauf den Dateipfad, unter dem die Dienstkontoschlüsseldatei (Option 1) in Schritt 1 gespeichert wurde.
Legacy-Ingestion-API-Exporter
Wenn Sie die Authentifizierungsdatei für die Datenaufnahme aus Option 2 verwenden, ersetzen Sie den Block
exportersdurch Folgendes. Legen Sie fürcreds_file_pathden Pfad zur Authentifizierungsdatei für die Datenaufnahme fest. Wenn sich Ihre Instanz außerhalb der USA befindet, ersetzen Siemalachiteingestion-pa.googleapis.comdurch Ihren regionalen Endpunkt (z. B.europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/chronicle_w_labels: compression: gzip # Adjust the path to the credentials file you downloaded in Step 1 creds_file_path: '/path/to/ingestion-authentication-file.json' # Replace with your actual customer ID from Step 2 customer_id: <CUSTOMER_ID> endpoint: malachiteingestion-pa.googleapis.com # Add optional ingestion labels for better organization log_type: 'IMPERVA_CEF' raw_log_field: body ingestion_labels:
Starten Sie den Bindplane-Agent neu, um die Änderungen zu übernehmen.
Führen Sie den folgenden Befehl aus, um den Bindplane-Agenten unter Linux neu zu starten:
sudo systemctl restart observiq-otel-collectorWenn Sie den Bindplane-Agenten unter Windows neu starten möchten, können Sie entweder die Konsole Dienste verwenden oder den folgenden Befehl eingeben:
net stop observiq-otel-collector && net start observiq-otel-collector
Imperva WAF Gateway (SecureSphere) so konfigurieren, dass CEF über Syslog gesendet wird
Erstellen Sie in der MX-Konsole eine Aktionsgruppe:
- Gehen Sie zu Richtlinien > Aktionssätze.
- Klicken Sie auf Neu und geben Sie einen Namen ein (z. B.
Google SecOps CEF).
Fügen Sie die CEF-Syslog-Aktionsschnittstelle hinzu:
- Öffnen Sie unter Verfügbare Aktionsschnittstellen das Systemprotokoll und fügen Sie nach Bedarf eine oder mehrere der folgenden Optionen hinzu:
- Sicherheitsereignis im Systemprotokoll (syslog) mit dem CEF-Standard protokollieren
- Netzwerksicherheitsereignis im Systemprotokoll (syslog) mit dem CEF-Standard protokollieren
- Systemereignis im Systemprotokoll (syslog) mit dem CEF-Standard protokollieren
- Benutzerdefiniertes Sicherheitsereignis im Systemprotokoll (syslog) mit dem CEF-Standard protokollieren
- Öffnen Sie unter Verfügbare Aktionsschnittstellen das Systemprotokoll und fügen Sie nach Bedarf eine oder mehrere der folgenden Optionen hinzu:
Konfigurieren Sie die Parameter für die Aktionsschnittstelle:
- Syslog-Host: Geben Sie die IP-Adresse Ihres Bindplane-Agents ein. Wenn Sie einen anderen Port als den Standardport verwenden möchten, hängen Sie
:PORTan. Der Standardport ist 514, wenn Sie keinen angeben. Beispiel:10.0.0.10:514. - Facility / Log Level: Legen Sie diese gemäß Ihren Richtlinienanforderungen fest.
- Nachricht: Behalten Sie die Standardeinstellungen des Anbieters für CEF bei, es sei denn, Sie haben eine benutzerdefinierte Zuordnung.
- Syslog-Host: Geben Sie die IP-Adresse Ihres Bindplane-Agents ein. Wenn Sie einen anderen Port als den Standardport verwenden möchten, hängen Sie
Hängen Sie das Aktionsset an Richtlinien an:
- Für Ereignisse vom Typ Sicherheit / Netzwerksicherheit: Öffnen Sie die relevanten Richtlinien und legen Sie für Ausgeführte Aktion Ihre Aktionsgruppe fest.
- Für Systemereignisse: Erstellen oder überprüfen Sie eine Richtlinie für Systemereignisse und legen Sie Folgeaktion auf Ihren Aktionssatz fest, damit diese Ereignisse auch über CEF gesendet werden.
(Optional) Gateway-spezifische Ziele konfigurieren:
- Wenn verschiedene Gateway-Gruppen an verschiedene Syslog-Server senden müssen, konfigurieren Sie jede Gateway-Gruppe > Externer Logger und aktivieren Sie in der Richtlinie Gateway-Konfiguration verwenden, falls vorhanden.
UDM-Zuordnungstabelle
| Logfeld | UDM-Zuordnung | Logik |
|---|---|---|
act |
security_result.action |
Abgeleitet. Wenn act „allowed“ oder „alert“ ist, mit „REQ_PASSED“ beginnt oder mit „REQ_CACHED“ beginnt, ist action „ALLOW“. Wenn act „deny“ oder „blocked“ ist, mit „REQ_BLOCKED“ oder mit „REQ_CHALLENGE“ beginnt, ist action „BLOCK“. Wenn act mit dem regulären Ausdruck (?i)REQ_BAD übereinstimmt, ist action „FAIL“. Andernfalls ist action „UNKNOWN_ACTION“. security_result.action wird dann auf den Wert von action gesetzt. |
act |
security_result.action_details |
Abgeleitet. Basierend auf dem Wert von act wird eine detaillierte Beschreibung generiert. Beispiele: „REQ_CACHED_FRESH: Antwort wurde aus dem Cache des Rechenzentrums zurückgegeben“, „REQ_BLOCKED: Die Anfrage wurde blockiert“. |
app |
network.application_protocol |
Direkt zugeordnet, nachdem sie in Großbuchstaben umgewandelt wurden. |
cs1 |
security_result.detection_fields.value |
Wird bedingt zugeordnet, wenn cs1 nicht leer oder „NA“ ist. security_result.detection_fields.key ist auf den Wert von cs1Label festgelegt. |
cs1Label |
security_result.detection_fields.key |
Wird bedingt zugeordnet, wenn cs1 nicht leer oder „NA“ ist. security_result.detection_fields.value ist auf den Wert von cs1 festgelegt. |
cs2 |
security_result.detection_fields.value |
Bedingt zugeordnet, wenn nicht leer. security_result.detection_fields.key ist auf den Wert von cs2Label festgelegt. |
cs2Label |
security_result.detection_fields.key |
Bedingt zugeordnet, wenn cs2 nicht leer ist. security_result.detection_fields.value ist auf den Wert von cs2 festgelegt. |
cs3 |
security_result.detection_fields.value |
Wird bedingt zugeordnet, wenn nicht leer oder „-“. security_result.detection_fields.key wird auf den Wert von cs3Label gesetzt. |
cs3Label |
security_result.detection_fields.key |
Wird bedingt zugeordnet, wenn cs3 nicht leer oder „-“ ist. security_result.detection_fields.value wird auf den Wert von cs3 gesetzt. |
cs4 |
security_result.detection_fields.value |
Bedingt zugeordnet, wenn nicht leer. security_result.detection_fields.key ist auf den Wert von cs4Label festgelegt. |
cs4Label |
security_result.detection_fields.key |
Bedingt zugeordnet, wenn cs4 nicht leer ist. security_result.detection_fields.value ist auf den Wert von cs4 festgelegt. |
cs5 |
security_result.detection_fields.value |
Bedingt zugeordnet, wenn nicht leer. security_result.detection_fields.key ist auf den Wert von cs5Label festgelegt. |
cs5Label |
security_result.detection_fields.key |
Bedingt zugeordnet, wenn cs5 nicht leer ist. security_result.detection_fields.value ist auf den Wert von cs5 festgelegt. |
cs6 |
security_result.detection_fields.value |
Bedingt zugeordnet, wenn nicht leer. security_result.detection_fields.key ist auf den Wert von cs6Label festgelegt. |
cs6Label |
security_result.detection_fields.key |
Bedingt zugeordnet, wenn cs6 nicht leer ist. security_result.detection_fields.value ist auf den Wert von cs6 festgelegt. |
cs7 |
principal.location.region_latitude |
Bedingt zugeordnet, wenn cs7Label „latitude“ ist. |
cs8 |
principal.location.region_longitude |
Wird bedingt zugeordnet, wenn cs8Label „longitude“ ist. |
cn1 |
security_result.detection_fields.value |
Wird bedingt zugeordnet, wenn nicht leer und cn1Label nicht leer ist. security_result.detection_fields.key ist auf den Wert von cn1Label festgelegt. |
cn1Label |
security_result.detection_fields.key |
Bedingt zugeordnet, wenn cn1 und cn1Label nicht leer sind. security_result.detection_fields.value ist auf den Wert von cn1 festgelegt. |
fileType |
security_result.detection_fields.value |
Bedingt zugeordnet, wenn nicht leer. security_result.detection_fields.key ist auf „fileType“ festgelegt. |
filePermission |
security_result.detection_fields.value |
Bedingt zugeordnet, wenn nicht leer. security_result.detection_fields.key ist auf „filePermission“ festgelegt. |
request |
target.url |
Direkt zugeordnet. |
requestClientApplication |
network.http.user_agent |
Bedingt zugeordnet, wenn nicht leer. Überschreibt den Wert, der aus dem Feld user_agent zugeordnet wurde, das aus den Schlüssel/Wert-Paaren requestContext oder requestClientApplication in der CEF-Nutzlast extrahiert wurde. |
requestMethod |
network.http.method |
Direkt zugeordnet. |
siteid |
security_result.detection_fields.value |
Bedingt zugeordnet, wenn nicht leer. security_result.detection_fields.key ist auf „siteid“ festgelegt. |
sourceServiceName |
target.hostname |
Direkt zugeordnet. Überschreibt den Wert von dhost, falls vorhanden. |
src |
principal.ip |
Direkt zugeordnet. |
start |
metadata.event_timestamp.seconds |
Wird mit einem Grok-Muster extrahiert und in einen Zeitstempel konvertiert. Wird als Fallback für deviceReceiptTime verwendet, wenn es nicht vorhanden ist. Wenn sowohl deviceReceiptTime als auch start leer sind, wird der Zeitstempel des Logs verwendet. |
suid |
principal.user.userid |
Bedingt zugeordnet, wenn nicht leer. |
| – | metadata.event_type |
Hartcodiert auf „NETWORK_HTTP“. |
| – | metadata.log_type |
Wird direkt aus dem Feld log_type auf oberster Ebene zugeordnet. |
| – | metadata.product_event_type |
Wird aus csv.event_id zugeordnet, wenn nicht leer. |
| – | metadata.product_name |
Hartcodiert auf „Web Application Firewall“. |
| – | metadata.vendor_name |
Hartcodiert auf „Imperva“. |
kv.act |
event.idm.read_only_udm.security_result.action_details |
Aus Änderungsprotokoll zugeordnet |
kv.sourceServiceName |
event.idm.read_only_udm.target.resource.name |
Aus Änderungsprotokoll zugeordnet |
cicode |
event.idm.read_only_udm.principal.location.city |
Aus Änderungsprotokoll zugeordnet |
ccode |
event.idm.read_only_udm.principal.location.country_or_region |
Aus Änderungsprotokoll zugeordnet |
Customer |
event.idm.read_only_udm.network.organization_name |
Aus Änderungsprotokoll zugeordnet |
tls_cipher |
event.idm.read_only_udm.network.tls.cipher |
Aus Änderungsprotokoll zugeordnet |
cpt |
event.idm.read_only_udm.target.port |
Aus Änderungsprotokoll zugeordnet |
fileId |
event.idm.read_only_udm.target.resource.product_object_id |
Aus Änderungsprotokoll zugeordnet |
dproc |
event.idm.read_only_udm.security_result.category_details |
Aus Änderungsprotokoll zugeordnet |
deviceFacility |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
deviceExternalId |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
end |
event.idm.read_only_udm.metadata.collected_timestamp |
Aus Änderungsprotokoll zugeordnet |
Änderungsprotokoll
Änderungsprotokoll für diesen Parser ansehen
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten