VMware vSphere-Logs erfassen

Unterstützt in:

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

VMware vSphere ist eine Virtualisierungsplattform, die Syslog-Meldungen für ESXi-Hostereignisse, VM-Vorgänge, Authentifizierung und Systemzustandsüberwachung generiert.

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 VMware vSphere ESXi-Host
  • 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 den VMware vSphere Web Client oder die ESXi-Shell

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/vmware_vsphere:
            compression: gzip
            creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
            customer_id: '<customer_id>'
            endpoint: malachiteingestion-pa.googleapis.com
            log_type: VMWARE_VSPHERE
            raw_log_field: body
    
    service:
        pipelines:
            logs/vmware_vsphere_to_chronicle:
                receivers:
                    - udplog
                exporters:
                    - chronicle/vmware_vsphere
    

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 in VMware vSphere konfigurieren

Option 1: vSphere-Webclient

  1. Melden Sie sich im vSphere-Webclient an.
  2. Wählen Sie den ESXi-Host aus.
  3. Gehen Sie zu Konfigurieren> System > Erweiterte Systemeinstellungen.
  4. Klicken Sie auf Bearbeiten.
  5. Setzen Sie den Parameter Syslog.global.logHost auf udp://<bindplane-ip>:514. Ersetzen Sie <bindplane-ip> durch die IP-Adresse Ihres Bindplane-Agents.
  6. Klicken Sie auf OK.

Option 2: ESXi-Shell

  1. Stellen Sie eine SSH-Verbindung zum ESXi-Host her.
  2. Führen Sie folgende Befehle aus:

    esxcli system syslog config set --loghost=udp://<bindplane-ip>:514
    esxcli system syslog reload
    
    • Ersetzen Sie <bindplane-ip> durch die IP-Adresse Ihres Bindplane-Agents.

UDM-Zuordnungstabelle

Logfeld UDM-Zuordnung Logik
Originator_label additional.fields Zusammengeführt
activityType_label additional.fields Zusammengeführt
certVerificationStatus_label additional.fields Zusammengeführt
cls_simple_activity_label additional.fields Zusammengeführt
itemType_label additional.fields Zusammengeführt
logtype_label additional.fields Zusammengeführt
opID_label additional.fields Zusammengeführt
progress_label additional.fields Zusammengeführt
securityCompliance_label additional.fields Zusammengeführt
sub_label additional.fields Zusammengeführt
vpxd_label additional.fields Zusammengeführt
column9 extensions.auth.type Zugeordnet: logged out → AUTHTYPE_UNSPECIFIED
column9 metadata.description Direkt zugeordnet
msg metadata.description Direkt zugeordnet
response_Message metadata.description Direkt zugeordnet
column3 metadata.event_timestamp Geparst als ISO8601
column9 metadata.event_type Zugeordnet: logged out → USER_LOGOUT
has_principal metadata.event_type Zugeordnet: true → NETWOK_CONNECTION, true → STATUS_UPDATE
column4 metadata.product_event_type Direkt zugeordnet
column1 metadata.product_log_id Direkt zugeordnet
uuid metadata.product_log_id Direkt zugeordnet
user_agent network.http.parsed_user_agent Umbenannt/zugeordnet
user_agent network.http.user_agent Direkt zugeordnet
sessionId network.session_id Direkt zugeordnet
Hostname principal.asset.hostname Direkt zugeordnet
hostname principal.asset.hostname Direkt zugeordnet
srcip principal.asset.ip Zusammengeführt
Hostname principal.hostname Direkt zugeordnet
hostname principal.hostname Direkt zugeordnet
srcip principal.ip Zusammengeführt
column5 security_result.severity Zugeordnet: INFO → INFORMATIONAL
severity security_result.severity_details Direkt zugeordnet
pid target.process.pid Direkt zugeordnet
column7 target.resource.name Direkt zugeordnet
column6 target.user.userid Direkt zugeordnet
extensions.auth.type Konstante: AUTHTYPE_UNSPECIFIED
metadata.event_type Konstante: NETWOK_CONNECTION
metadata.product_name Konstante: VMWARE_VSPHERE
metadata.vendor_name Konstante: VMWARE_VSPHERE
security_result.severity Konstante: INFORMATIONAL

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