Symantec Web Isolation-Logs erfassen

Unterstützt in:

Google SecOps SIEM

In diesem Dokument wird beschrieben, wie Sie Symantec Web Isolation-Logs mit dem Bindplane-Agenten in Google Security Operations aufnehmen.

Symantec Web Isolation ist eine Browser-Isolierungsplattform, die Syslog-Meldungen für Webbrowsing-Sitzungen, URL-Zugriffsereignisse, Dateidownloadaktivitäten, Richtliniendurchsetzung und Geräteverwaltungsereignisse generiert. Der Parser extrahiert Felder aus JSON-formatierten Logs 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 der Symantec Web Isolation-Plattform
• Wenn der Agent hinter einem Proxy ausgeführt wird, müssen die Firewallports gemäß den Anforderungen des Bindplane-Agents geöffnet sein.
• Administratorzugriff auf die Web-UI von Symantec Web Isolation

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)

1. 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.
2. Rufen Sie IAM & Verwaltung > Dienstkonten auf.
3. Klicken Sie auf Dienstkonto erstellen.
4. 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.
5. Klicken Sie auf Erstellen und fortfahren.
6. Klicken Sie im Abschnitt Diesem Dienstkonto Zugriff auf das Projekt erteilen auf Rolle auswählen und wählen Sie Chronicle-Bearbeiter aus.
7. Klicken Sie auf Weiter und dann auf Fertig.
8. Klicken Sie auf das erstellte Dienstkonto und rufen Sie dann den Tab Schlüssel auf.
9. Klicken Sie auf Schlüssel hinzufügen > Neuen Schlüssel erstellen.
10. Wählen Sie JSON aus und klicken Sie auf Erstellen. Die Schlüsseldatei wird auf Ihren Computer heruntergeladen.
11. Speichern Sie die Schlüsseldatei als ingestion-auth.json im Bindplane-Collector-Verzeichnis (/opt/observiq-otel-collector/ingestion-auth.json unter Linux oder C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json unter Windows) oder aktualisieren Sie creds_file_path in config.yaml, damit der Pfad mit dem Pfad übereinstimmt, in dem Sie die Datei speichern.
12. Rufen Sie IAM und Verwaltung > Einstellungen auf und kopieren Sie die Projektnummer. Sie benötigen sie für die Exporter-Konfiguration.

Hinweis :Der JSON-Schlüssel ist eine Anmeldedaten. Beschränken Sie den Zugriff auf die Datei auf dem Bindplane-Host und rotieren Sie den Schlüssel gemäß den Richtlinien Ihrer Organisation.

Option 2: Authentifizierungsdatei für die Aufnahme herunterladen (Legacy)

1. Melden Sie sich in der Google SecOps-Konsole an.
2. Rufen Sie die SIEM-Einstellungen > Erfassungs-Agents auf.
3. Laden Sie die Authentifizierungsdatei für die Datenaufnahme herunter.
4. Speichern Sie die Datei sicher auf dem System, auf dem der Bindplane-Agent installiert werden soll.

Hinweis: Mit dieser Datei wird der Agent bei der Legacy Ingestion API (malachiteingestion-pa.googleapis.com) authentifiziert, die Google am 20. Juli 2027 einstellen wird. Planen Sie den Wechsel zu Option 1 vor diesem Datum.

Google SecOps-Kundennummer abrufen

1. Melden Sie sich in der Google SecOps-Konsole an.
2. Rufen Sie die SIEM-Einstellungen > Profil auf.

3. Kopieren und speichern Sie die Kundennummer aus dem Bereich Organization Details (Organisationsdetails).

   Hinweis: Die Kundennummer ist für die Konfiguration des Bindplane-Agent-Exporters erforderlich.

BindPlane-Agent installieren

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

Windows-Installation

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 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 active (running) angezeigt werden.

Zusätzliche Installationsressourcen

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

Hinweis: Für die Konfiguration des Chronicle API-Exporters ist Bindplane Collector v1.106.0 oder höher erforderlich. Mit den vorherigen Befehlen wird der neueste Release installiert. Wenn Sie eine vorhandene Installation aktualisieren, aktualisieren Sie den Collector, bevor Sie die Konfiguration ändern.

Bindplane-Agent so konfigurieren, dass Syslog-Daten aufgenommen und an Google SecOps gesendet werden

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/symantec_web_isolation:
      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
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: chronicle.googleapis.com
      log_type: SYMANTEC_WEB_ISOLATION
      raw_log_field: body
  
  service:
    pipelines:
      logs/symantec_web_isolation_to_chronicle:
        receivers:
          - udplog
        exporters:
          - chronicle/symantec_web_isolation
  

Konfigurationsparameter

Ersetzen Sie die folgenden Platzhalter:

• Empfängerkonfiguration:

  • listen_address: IP-Adresse und Port, auf die gewartet werden soll:
    • 0.0.0.0, um auf allen Schnittstellen zuzuhören (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 JSON-Schlüsseldatei des Dienstkontos (Option 1):
    • Linux: /opt/observiq-otel-collector/ingestion-auth.json
    • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
  • customer_id: Die Kundennummer, die aus der Google SecOps Console kopiert wurde
  • location: Ersetzen Sie <LOCATION> durch die Region Ihrer Google SecOps-Instanz (z. B. us, europe oder asia-southeast1). Der Exporter stellt diesem Wert chronicle.googleapis.com voran. Eine vollständige Liste finden Sie unter Regionale Endpunkte.
  • project: Ersetzen Sie <PROJECT_NUMBER> durch die Projektnummer aus IAM & Verwaltung > Einstellungen.
  • endpoint: Behalten Sie die Einstellung chronicle.googleapis.com bei.

Legacy-Ingestion-API-Exporter

• Wenn Sie die Authentifizierungsdatei für die Datenaufnahme aus Option 2 verwenden, ersetzen Sie den Block exporters durch Folgendes. Legen Sie für creds_file_path den Pfad zur Authentifizierungsdatei für die Datenaufnahme fest. Wenn sich Ihre Instanz außerhalb der USA befindet, ersetzen Sie malachiteingestion-pa.googleapis.com durch Ihren regionalen Endpunkt (z. B. europe-malachiteingestion-pa.googleapis.com).

  exporters:
    chronicle/symantec_web_isolation:
      compression: gzip
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: SYMANTEC_WEB_ISOLATION
      raw_log_field: body
  

Hinweis: Dieser Exporteur funktioniert nicht mehr, wenn die Ingestion API am 20. Juli 2027 eingestellt wird.

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.

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-collector
  

  1. Prüfen Sie, ob der Dienst ausgeführt wird:

     sudo systemctl status observiq-otel-collector
     

  2. Prüfen Sie die Logs auf Fehler:

     sudo journalctl -u observiq-otel-collector -f
     

• Wählen Sie eine der folgenden Optionen aus, um den Bindplane-Agenten unter Windows neu zu starten:

  • Eingabeaufforderung oder PowerShell als Administrator:

    net stop observiq-otel-collector && net start observiq-otel-collector
    

  • Dienstkonsole:

    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. Rechtsklicken Sie und wählen Sie Neu starten aus.

    4. Prüfen Sie, ob der Dienst ausgeführt wird:

       sc query observiq-otel-collector
       

    5. Prüfen Sie die Logs auf Fehler:

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

Syslog auf der Symantec Web Isolation-Plattform konfigurieren

1. Melden Sie sich in der Web-UI von Symantec Web Isolation an.
2. Gehen Sie zu Systemkonfiguration > Externer Logserver > Neuer externer Logserver > Syslog-Server.
3. Geben Sie die folgenden Konfigurationsdetails an:
   • Status: Setzen Sie ein Häkchen bei Aktivieren.
   • Host: Geben Sie die IP-Adresse des Bindplane-Agents ein.
   • Port: Geben Sie die Portnummer des Bindplane-Agents ein, z. B. 514 für UDP.
   • Protokoll: Wählen Sie UDP aus.
   • Appname: Geben Sie ein Tag ein, um die Web Isolation-Plattform zu identifizieren.
   • Facility: Syslog-Facility-Name im Zusammenhang mit Web Isolation-Protokollen.
4. Klicken Sie auf Erstellen.
5. Gehen Sie zu Berichte > Protokollweiterleitung.
6. Klicken Sie auf Bearbeiten.
7. Geben Sie die folgenden Konfigurationsdetails an:
   • Aktivitätsprotokolle: Wählen Sie den neu hinzugefügten Bindplane-Server aus.
   • Management Audit Logs (Audit-Logs für die Verwaltung): Wählen Sie den neu hinzugefügten Bindplane-Server aus.
   • Gateway Audit Logs (Gateway-Prüfprotokolle): Wählen Sie den neu hinzugefügten Bindplane-Server aus.
8. Klicken Sie auf Aktualisieren.

UDM-Zuordnungstabelle

Logfeld	UDM-Zuordnung	Logik
action	security_result.summary	Wird mit action_reason verkettet, um die Zusammenfassung zu bilden.
action_reason	security_result.summary	Wird mit action verkettet, um die Zusammenfassung zu bilden.
content_action	security_result.action_details	Direkte Zuordnung.
createdAt	metadata.event_timestamp	In einen Zeitstempel im UNIX_MS-Format konvertiert.
creationDate	metadata.event_timestamp	In einen Zeitstempel im UNIX_MS-Format konvertiert.
data.level	security_result.severity	Wird je nach Wert INFORMATIONAL, LOW oder HIGH zugeordnet.
data.properties.environment.str	intermediary.location.name	Direkte Zuordnung.
data.properties.hostname.str	intermediary.hostname	Direkte Zuordnung.
destination_ip	target.ip	Direkte Zuordnung.
destination_ip_country_name	target.location.country_or_region	Direkte Zuordnung.
device.current_risk_warnings	security_result.category_details	Direkte Zuordnung.
device.identifier	target.asset.product_object_id	Direkte Zuordnung.
device.model	hardware.model	Direkte Zuordnung.
device.os_version	target.asset.platform_software.platform_version	Direkte Zuordnung.
device.serial_number	hardware.serial_number	Direkte Zuordnung.
device.udid	target.asset.asset_id	Vor dem Zuordnen wird „UDID:“ vorangestellt.
device.user.email	target.user.email_addresses	Direkte Zuordnung.
device.user.id	target.user.userid	Direkte Zuordnung.
device.user.name	target.user.user_display_name	Direkte Zuordnung.
device.user.organization.id	target.user.groupid	Direkte Zuordnung.
device.user.organization.name	target.user.group_identifiers	Direkte Zuordnung.
event	metadata.product_event_type	Direkte Zuordnung.
event_type	metadata.event_type	Wird basierend auf Protokolldaten auf „GENERIC_EVENT“ oder „NETWORK_HTTP“ gesetzt.
file_name	target.file.names	Direkte Zuordnung.
file_type	about.labels, about.resource.attribute.labels	Als Label mit dem Schlüssel „file_type“ hinzugefügt.
id	metadata.product_log_id	Direkte Zuordnung.
isolation_session_id	network.parent_session_id	Direkte Zuordnung.
level	security_result.severity	Entsprechend dem Wert wird INFORMATIONAL, LOW oder HIGH zugeordnet.
original_source_ip	principal.ip	Direkte Zuordnung.
policy_version	security_result.rule_version	Direkte Zuordnung.
properties.environment	intermediary.location.name	Direkte Zuordnung.
properties.hostname	intermediary.hostname	Direkte Zuordnung.
referer_url	network.http.referral_url	Direkte Zuordnung.
request_method	network.http.method	Direkte Zuordnung.
resource_response_headers.x-nauthilus-traceid	network.community_id	Direkte Zuordnung.
response_status_code	network.http.response_code	Direkte Zuordnung.
rule_id	security_result.rule_id	Direkte Zuordnung.
rule_name_at_log_time	security_result.rule_name	Direkte Zuordnung.
rule_type	security_result.rule_type	Direkte Zuordnung.
service	principal.application	Direkte Zuordnung.
session_id	network.session_id	Direkte Zuordnung.
severity	security_result.severity	Wird je nach Wert LOW, MEDIUM oder HIGH zugeordnet.
source_ip	principal.ip	Direkte Zuordnung.
source_ip_country_name	principal.location.country_or_region	Direkte Zuordnung.
source_port	principal.port	Direkte Zuordnung.
sub_type	security_result.summary	Direkte Zuordnung.
target.asset.type	target.asset.type	Wird auf „MOBILE“ gesetzt, wenn device.model „ipad“ oder „iphone“ enthält.
target.asset.platform_software.platform	target.asset.platform_software.platform	Auf „MAC“ festlegen, wenn device.model „ipad“ oder „iphone“ enthält.
timestamp	metadata.event_timestamp	Mit dem Format yyyy-MM-dd HH:mm:ss.SSS Z geparst.
total_bytes	network.received_bytes	Direktes Mapping, wenn größer als 0.
traceId	metadata.product_log_id	Direkte Zuordnung.
type	metadata.product_event_type	Direkte Zuordnung.
url	target.url	Direkte Zuordnung.
url_host	principal.hostname	Direkte Zuordnung.
user_download_usage_bytes	network.received_bytes	Direkte Zuordnung.
user_total_usage_bytes	about.labels, about.resource.attribute.labels	Wird als Label mit dem Schlüssel „user_total_usage_bytes“ hinzugefügt.
user_upload_usage_bytes	network.sent_bytes	Direkte Zuordnung.
username	principal.user.user_display_name	Direkte Zuordnung.
vendor_name	metadata.vendor_name	Legen Sie diesen Wert auf „Broadcom Inc.“ fest.
product_name	metadata.product_name	Legen Sie diesen Wert auf „Symantec Web Isolation“ fest.
log_type	metadata.log_type	Legen Sie diesen Wert auf „SYMANTEC_WEB_ISOLATION“ fest.
sandbox	about.labels, about.resource.attribute.labels	Wird als Label mit dem Schlüssel „Sandbox“ und dem aus der URL extrahierten Wert hinzugefügt.
utub	about.labels, about.resource.attribute.labels	Wird als Label mit dem Schlüssel „user_total_usage_bytes“ hinzugefügt.
userid	target.user.userid	Aus der URL extrahiert.

Änderungsprotokoll

Änderungsprotokoll für diesen Parser ansehen

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