Varonis-Logs erfassen

Unterstützt in:

In diesem Dokument wird beschrieben, wie Sie Varonis-Logs mit dem Bindplane-Agent in Google Security Operations aufnehmen.

Varonis ist eine Plattform für Datensicherheit und ‑analyse, die Syslog-Nachrichten im CEF- und LEEF-Format für Dateizugriffsereignisse, Berechtigungsänderungen, Authentifizierungsaktivitäten und DatAlert-Sicherheitswarnungen generiert. Der Parser extrahiert Felder aus Logs im CEF-, LEEF- und Schlüssel/Wert-Format und ordnet sie dem Unified Data Model (UDM) zu.

Hinweis

Prüfen Sie, ob folgende Voraussetzungen erfüllt sind:

  • Eine Google SecOps-Instanz
  • Windows Server 2016 oder höher oder Linux-Host mit systemd
  • Netzwerkverbindung zwischen dem Bindplane-Agent und dem Varonis-Server
  • Wenn Sie den Agent hinter einem Proxy ausführen, müssen die Firewallports gemäß den Anforderungen des Bindplane-Agents geöffnet sein.
  • Privilegierter Zugriff auf Varonis

Authentifizierungsdatei für die Aufnahme in Google SecOps abrufen

  1. Melden Sie sich in der Google SecOps-Konsole an.
  2. Rufen Sie die SIEM-Einstellungen > Collection Agents auf.
  3. Laden Sie die Authentifizierungsdatei für die Aufnahme herunter.
  4. Speichern Sie die Datei sicher auf dem System, auf dem BindPlane installiert wird.

Google SecOps-Kundennummer abrufen

  1. Melden Sie sich in der Google SecOps-Konsole an.
  2. Rufen Sie die SIEM-Einstellungen > Profile auf.
  3. Kopieren und speichern Sie die Kunden-ID aus dem Bereich Organisationsdetails.

BindPlane-Agent installieren

Installieren Sie den Bindplane-Agent auf Ihrem Windows- oder Linux-Betriebssystem gemäß der folgenden Anleitung.

Fenstereinbau

  1. Öffnen Sie die Eingabeaufforderung oder PowerShell als Administrator.
  2. Führen Sie dazu diesen Befehl aus:

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    
  3. Warten Sie, bis die Installation abgeschlossen ist.

  4. Überprüfen Sie die Installation mit folgendem Befehl:

    sc query observiq-otel-collector
    

    Der Dienst sollte als RUNNING (Wird ausgeführt) angezeigt werden.

Linux-Installation

  1. Öffnen Sie ein Terminal mit Root- oder Sudo-Berechtigungen.
  2. 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
    
  3. Warten Sie, bis die Installation abgeschlossen ist.

  4. Überprüfen Sie die Installation mit folgendem Befehl:

    sudo systemctl status observiq-otel-collector
    

    Der Dienst sollte als aktiv (wird ausgeführt) angezeigt werden.

Zusätzliche Installationsressourcen

Weitere Installationsoptionen und Informationen zur Fehlerbehebung finden Sie in der Installationsanleitung für den Bindplane-Agent.

BindPlane-Agent zum Erfassen von Syslog-Daten und Senden an Google SecOps konfigurieren

Konfigurationsdatei suchen

  • Linux:

    sudo nano /opt/observiq-otel-collector/config.yaml
    
  • Windows:

    notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
    

Konfigurationsdatei bearbeiten

  • Ersetzen Sie den gesamten Inhalt von config.yaml durch die folgende Konfiguration:

    receivers:
        udplog:
            listen_address: "0.0.0.0:514"
    
    exporters:
        chronicle/varonis:
            compression: gzip
            creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
            customer_id: '<customer_id>'
            endpoint: malachiteingestion-pa.googleapis.com
            log_type: VARONIS
            raw_log_field: body
    
    service:
        pipelines:
            logs/varonis_to_chronicle:
                receivers:
                    - udplog
                exporters:
                    - chronicle/varonis
    

Konfigurationsparameter

Ersetzen Sie die folgenden Platzhalter:

  • Empfängerkonfiguration:

    • listen_address: IP-Adresse und Port, auf die gewartet werden soll:
      • 0.0.0.0, um alle Schnittstellen zu überwachen (empfohlen)
      • Port 514 ist der Standard-Syslog-Port (erfordert Root unter Linux; verwenden Sie 1514 für Nicht-Root).
  • Exporter-Konfiguration:

    • creds_file_path: Vollständiger Pfad zur Datei für die Authentifizierung bei der Aufnahme:
      • Linux: /etc/bindplane-agent/ingestion-auth.json
      • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • customer_id: Kunden-ID, die aus der Google SecOps Console kopiert wurde
    • endpoint: Regionale Endpunkt-URL:
      • USA: malachiteingestion-pa.googleapis.com
      • Europa: europe-malachiteingestion-pa.googleapis.com
      • Asien: asia-southeast1-malachiteingestion-pa.googleapis.com
      • Eine vollständige Liste finden Sie unter Regionale Endpunkte.

Konfigurationsdatei speichern

  • Speichern Sie die Datei nach der Bearbeitung:
    • Linux: Drücken Sie Ctrl+O, dann Enter und dann Ctrl+X.
    • Windows: Klicken Sie auf Datei > Speichern.

Bindplane-Agent neu starten, um die Änderungen zu übernehmen

  • Führen Sie den folgenden Befehl aus, um den Bindplane-Agent unter Linux neu zu starten:

    sudo systemctl restart observiq-otel-collector
    
    1. Prüfen Sie, ob der Dienst ausgeführt wird:

      sudo systemctl status observiq-otel-collector
      
    2. Logs auf Fehler prüfen:

      sudo journalctl -u observiq-otel-collector -f
      
  • Wählen Sie eine der folgenden Optionen aus, um den Bindplane-Agent unter Windows neu zu starten:

    • Eingabeaufforderung oder PowerShell als Administrator:

      net stop observiq-otel-collector && net start observiq-otel-collector
      
    • Services-Konsole:

      1. Drücken Sie Win+R, geben Sie services.msc ein und drücken Sie die Eingabetaste.
      2. Suchen Sie nach observIQ OpenTelemetry Collector.
      3. Klicken Sie mit der rechten Maustaste und wählen Sie Neu starten aus.
      4. Prüfen Sie, ob der Dienst ausgeführt wird:

        sc query observiq-otel-collector
        
      5. Logs auf Fehler prüfen:

        type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
        

Syslog-Export in Varonis konfigurieren

  1. Melden Sie sich in der Varonis-Web-UI an.
  2. Klicken Sie auf Tools > „DatAlert“ > „DatAlert auswählen“.
  3. Wählen Sie Konfiguration aus.
  4. Geben Sie die folgenden Konfigurationsdetails an:
    • Syslog Message IP Address (IP-Adresse für Syslog-Nachrichten): Geben Sie die IP-Adresse des Bindplane-Agents ein.
    • Port: Geben Sie die Portnummer des Bindplane-Agents ein (z. B. 514 für UDP).
    • Name der Einrichtung: Wählen Sie eine Einrichtung aus.
  5. Klicken Sie auf Übernehmen.

Syslog-Format in Varonis konfigurieren

  1. Klicken Sie auf Tools > „DatAlert“ > „Alert Templates“ (Benachrichtigungsvorlagen).
  2. Klicken Sie auf Benachrichtigungsvorlage bearbeiten und wählen Sie Standardvorlage für externes System aus.
  3. Wählen Sie unter Auf Benachrichtigungsmethoden anwenden in der Liste Syslog-Nachricht aus.
  4. Wählen Sie im Menü Regeln > Benachrichtigungsmethode aus.
  5. Wählen Sie Syslog-Nachricht aus.
  6. Klicken Sie auf OK.

UDM-Zuordnungstabelle

Logfeld UDM-Zuordnung Logik
act security_result.summary Wert aus dem Feld act in der CEF-Nachricht.
cn1 security_result.rule_id Wert aus dem Feld cn1 in der CEF-Nachricht.
cs1 network.email.to Wert aus dem Feld cs1 in der CEF-Nachricht, insbesondere der E‑Mail-Empfänger.
cs2 security_result.rule_name Wert aus dem Feld cs2 in der CEF-Nachricht.
device_version metadata.product_version Wert aus dem Feld device_version in der CEF-Nachricht.
dhost principal.hostname Wert aus dem Feld dhost in der CEF-Nachricht, der den primären Hostnamen darstellt. Wenn file_server vorhanden ist und nicht „DirectoryServices“ lautet, wird dieser Wert überschrieben.
duser target.user.userid Wert aus dem Feld duser in der CEF-Nachricht. Wird mit „gsub“ transformiert, um Backslashes zu entfernen und in target.user.userid und target.administrative_domain aufzuteilen.
dvchost target.hostname Wert aus dem Feld dvchost in der CEF-Nachricht.
filePath target.file.full_path Wert aus dem Feld filePath in der CEF-Nachricht.
rt metadata.event_timestamp Wert aus dem Feld rt in der CEF-Nachricht, als Zeitstempel geparst.
severity security_result.severity Wert aus dem Feld severity in der CEF- oder LEEF-Nachricht. In Großbuchstaben umgewandelt. Wird basierend auf dem numerischen Wert oder dem Schlüsselwort den UDM-Schweregraden (LOW, INFORMATIONAL, MEDIUM, HIGH, CRITICAL) zugeordnet.
Acting Object target.user.user_display_name Wert aus dem Feld Acting Object in den Schlüssel/Wert-Daten. Trennen Sie die Zeichenfolge nach „\“, um den Anzeigenamen zu extrahieren.
Acting Object SAM Account Name target.user.userid Wert aus dem Feld Acting Object SAM Account Name in den Schlüssel/Wert-Daten.
Device hostname target.hostname Wert aus dem Feld Device hostname in den Schlüssel/Wert-Daten.
Device IP address target.ip Wert aus dem Feld Device IP address in den Schlüssel/Wert-Daten.
Event Time metadata.event_timestamp Wert aus dem Feld Event Time in den Schlüssel/Wert-Daten, als Zeitstempel geparst.
Event Type target.application, metadata.event_type Wert aus dem Feld Event Type in den Schlüssel/Wert-Daten. Wird verwendet, um metadata.event_type abzuleiten (FILE_OPEN, USER_CHANGE_PERMISSIONS, USER_CHANGE_PASSWORD, USER_UNCATEGORIZED).
File Server/Domain principal.hostname Wert aus dem Feld File Server/Domain in den Schlüssel/Wert-Daten. Wenn nicht „DirectoryServices“, wird die principal.hostname überschrieben, die von dhost abgeleitet wurde.
Path target.file.full_path Wert aus dem Feld Path in den Schlüssel/Wert-Daten.
Rule Description metadata.description Wert aus dem Feld Rule Description in den Schlüssel/Wert-Daten.
Rule ID security_result.rule_id Wert aus dem Feld Rule ID in den Schlüssel/Wert-Daten.
Rule Name security_result.rule_name Wert aus dem Feld Rule Name in den Schlüssel/Wert-Daten.
intermediary_host intermediary.hostname Von Grok extrahierter Wert, der den Zwischenhostnamen darstellt.
log_type metadata.log_type Hartcodiert auf VARONIS.
metadata.event_type metadata.event_type Abgeleitet aus den Werten von evt_typ, act und filepath. Die Standardeinstellung ist STATUS_UPDATE, wenn event_type GENERIC_EVENT ist und principal_hostname vorhanden ist.
metadata.product_name metadata.product_name Fest codiert auf VARONIS, kann aber durch das Feld product_name aus der LEEF-Nachricht überschrieben werden.
metadata.vendor_name metadata.vendor_name Fest codiert auf VARONIS, kann aber durch das Feld vendor aus der LEEF-Nachricht überschrieben werden.
prin_host principal.hostname Von Grok extrahierter Wert, der den Prinzipal-Hostnamen darstellt.
product_name metadata.product_name Wert aus der LEEF-Nachricht.
security_result.action security_result.action Abgeleitet aus dem Feld result oder Event Status. Wird auf „ALLOW“ gesetzt, wenn das Ergebnis Success ist. Andernfalls wird es auf BLOCK gesetzt.
timestamp timestamp, metadata.event_timestamp Der Ereigniszeitstempel wird je nach Verfügbarkeit aus verschiedenen Feldern abgeleitet (datetime1, event_time, start_datetime, datetime2). Der create_time aus dem Rohlog wird als Fallback verwendet und sowohl timestamp als auch metadata.event_timestamp zugeordnet, wenn keine anderen Zeitstempelfelder verfügbar sind.
vendor metadata.vendor_name Wert aus der LEEF-Nachricht.

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