Ubiquiti Unifi-Switch-Logs erfassen

Unterstützt in:

Google SecOps SIEM

In diesem Dokument wird beschrieben, wie Sie Ubiquiti Unifi-Switch-Logs mit Bindplane in Google Security Operations aufnehmen. Der Parser extrahiert Felder aus den Syslog-Nachrichten mithilfe von Grok-Mustern und wandelt die Rohlogdaten in ein strukturiertes Format um, das dem einheitlichen Datenmodell (Unified Data Model, UDM) entspricht. Es werden verschiedene Protokollformate verarbeitet, wichtige Informationen wie Zeitstempel, Hostnamen, Beschreibungen und Netzwerkdetails extrahiert und die Daten mit zusätzlichem Kontext angereichert, bevor sie in das endgültige UDM-Ereignis eingefügt werden.

Hinweise

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

Eine Google SecOps-Instanz
Ein Windows 2016- oder höher- oder Linux-Host mit systemd
Wenn Sie den Agent hinter einem Proxy ausführen, achten Sie darauf, dass die Firewallports gemäß den Anforderungen des BindPlane-Agents geöffnet sind.
Privilegierter Zugriff auf die Ubiquiti Controller-Benutzeroberfläche

Authentifizierungsdatei für die Aufnahme in Google SecOps abrufen

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

Google SecOps-Kundennummer abrufen

Melden Sie sich in der Google SecOps-Konsole an.
Rufen Sie die SIEM-Einstellungen > Profile auf.
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

Ö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 diesem Installationsleitfaden.

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

Konfigurationsdatei aufrufen:
1. Suchen Sie die Datei config.yaml. Normalerweise befindet sie sich unter Linux im Verzeichnis /etc/bindplane-agent/ oder unter Windows im Installationsverzeichnis.
2. Öffnen Sie die Datei mit einem Texteditor (z. B. nano, vi oder Notepad).

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:
    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: 'UBIQUITI_SWITCH'
    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 <CUSTOMER_ID durch die tatsächliche Kunden-ID.
Aktualisieren Sie /path/to/ingestion-authentication-file.json auf den Pfad, in dem die Authentifizierungsdatei im Abschnitt Get Google SecOps ingestion authentication file (Authentifizierungsdatei für die Google SecOps-Aufnahme abrufen) gespeichert wurde.

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 bindplane-agent
```
Um den Bindplane-Agent unter Windows neu zu starten, können Sie entweder die Konsole Dienste verwenden oder den folgenden Befehl eingeben:
```
net stop BindPlaneAgent && net start BindPlaneAgent
```

Ubiquiti-Switch so konfigurieren, dass Syslog-Einträge der Steuerungsebene gesendet werden

Melden Sie sich in der UniFi Controller-UI an.
Öffnen Sie Unifi Network.
Rufen Sie die Einstellungen > „Control Plane“ > Tab „Integrationen“ auf.
Suchen Sie nach dem Abschnitt Aktivitätsprotokollierung (Syslog).
Aktivieren Sie die Option SIEM Server (SIEM-Server).
Geben Sie die folgenden Konfigurationsdetails an:
- Klicken Sie auf Kategorien bearbeiten und fügen Sie die erforderlichen Protokollkategorien hinzu.
- Serveradresse: Geben Sie die IP-Adresse des Bindplane-Agents ein.
- Port: Geben Sie die Portnummer des Bindplane-Agents ein (UDP ist erforderlich).
Klicken Sie auf Änderungen übernehmen.

Ubiquiti-Switch so konfigurieren, dass CyberSecure-Syslog gesendet wird

Melden Sie sich in der UniFi Controller-UI an.
Öffnen Sie Unifi Network.
Gehen Sie zu Einstellungen > CyberSecure > Tab „Traffic Logging“.
Suchen Sie nach dem Abschnitt Aktivitätsprotokollierung (Syslog).
Aktivieren Sie die Option SIEM Server (SIEM-Server).
Geben Sie die folgenden Konfigurationsdetails an:
- Klicken Sie auf Kategorien bearbeiten und fügen Sie die erforderlichen Protokollkategorien hinzu.
- Serveradresse: Geben Sie die IP-Adresse des Bindplane-Agents ein.
- Port: Geben Sie die Portnummer des Bindplane-Agents ein (UDP ist erforderlich).
- Deaktivieren Sie Debug-Logs.
Klicken Sie auf Änderungen übernehmen.

UDM-Zuordnungstabelle

Logfeld	UDM-Zuordnung	Logik
`anomalies`	`security_result.detection_fields[].key`: „anomalies“ `security_result.detection_fields[].value`: `anomalies`-Wert aus dem Log	Direkt aus dem Feld `anomalies` im Rohlog zugeordnet.
`application`	`observer.application`	Direkt aus dem Feld `application` im Rohlog zugeordnet.
`assoc_status`	`security_result.detection_fields[].key`: „assoc_status“ `security_result.detection_fields[].value`: `assoc_status`-Wert aus dem Log	Direkt aus dem Feld `assoc_status` im Rohlog zugeordnet.
`asset_details`	`observer.asset.product_object_id`: Extrahiert mit dem Grok-Muster `%{GREEDYDATA:asset_id},%{GREEDYDATA:asset_version}` `asset_software.version`: Extrahiert mit dem Grok-Muster `%{GREEDYDATA:asset_id},%{GREEDYDATA:asset_version}`	Das Feld `asset_details` wird mit einem Grok-Muster geparst, um `asset_id` und `asset_version` zu extrahieren.
`asset_id`	`observer.asset.product_object_id`	Direkt aus dem extrahierten Feld `asset_id` aus `asset_details` zugeordnet.
`asset_version`	`observer.asset.software.version`	Direkt aus dem extrahierten Feld `asset_version` aus `asset_details` zugeordnet.
`bssid`	`principal.mac`	Direkt aus dem Feld `bssid` im Rohlog zugeordnet.
`description`	`metadata.description`	Direkt aus dem Feld `description` im Rohlog zugeordnet.
`device`	`metadata.product_name`	Direkt aus dem Feld `device` im Rohlog zugeordnet. Wenn `device` nicht vorhanden ist, wird der Wert „UBIQUITI_SWITCH“ verwendet.
`dns_resp_seen`	`security_result.detection_fields[].key`: „dns_resp_seen“ `security_result.detection_fields[].value`: `dns_resp_seen`-Wert aus dem Log	Direkt aus dem Feld `dns_resp_seen` im Rohlog zugeordnet.
`DST`	`target.ip`	Direkt aus dem Feld `DST` im Rohlog zugeordnet.
`DPT`	`principal.port`	Direkt aus dem Feld `DPT` im Rohlog abgeleitet, nachdem es in eine Ganzzahl konvertiert wurde.
`event_type`	`security_result.detection_fields[].key`: „event_type“ `security_result.detection_fields[].value`: `event_type`-Wert aus dem Log	Direkt aus dem Feld `event_type` im Rohlog zugeordnet.
`host`	`principal.hostname`	Direkt aus dem Feld `host` im Rohlog zugeordnet.
`ID`	`additional.fields[].key`: „ID“ `additional.fields[].value.string_value`: `ID`-Wert aus dem Log	Direkt aus dem Feld `ID` im Rohlog zugeordnet.
`IN`	`additional.fields[].key`: „IN“ `additional.fields[].value.string_value`: `IN`-Wert aus dem Log	Direkt aus dem Feld `IN` im Rohlog zugeordnet.
`interface`	`additional.fields[].key`: „interface“ `additional.fields[].value.string_value`: `interface`-Wert aus dem Log	Direkt aus dem Feld `interface` im Rohlog zugeordnet.
`LEN`	`additional.fields[].key`: „LEN“ `additional.fields[].value.string_value`: `LEN`-Wert aus dem Log	Direkt aus dem Feld `LEN` im Rohlog zugeordnet.
`mac`	`principal.mac`	Direkt aus dem Feld `mac` im Rohlog zugeordnet.
`metadata.event_type`	`metadata.event_type`	Abgeleitet von der Parserlogik. Wird auf „STATUS_SHUTDOWN“ gesetzt, wenn `state` „Down“ ist, auf „STATUS_STARTUP“, wenn `state` „Up“ ist, auf „STATUS_UPDATE“, wenn `kv_msg` und `DST` vorhanden sind oder `principal_present` „true“ ist, und andernfalls auf „GENERIC_EVENT“.
`metadata.log_type`	`metadata.log_type`: „UBIQUITI_SWITCH“	Konstanter Wert, der vom Parser festgelegt wird.
`metadata.vendor_name`	`metadata.vendor_name`: „UBIQUITI“	Konstanter Wert, der vom Parser festgelegt wird.
`principal_ip`	`principal.ip`	Direkt aus dem Feld `principal_ip` im Rohlog zugeordnet.
`process_id`	`observer.process.pid`	Direkt aus dem Feld `process_id` im Rohlog zugeordnet.
`product_event_type`	`metadata.product_event_type`	Direkt aus dem Feld `product_event_type` im Rohlog zugeordnet.
`PROTO`	`network.ip_protocol`	Direkt aus dem Feld `PROTO` im Rohlog zugeordnet. Wenn `PROTO` „ICMPv6“ ist, wird der Wert in „ICMP“ geändert.
`query_1`	`target.administrative_domain`	Direkt aus dem Feld `query_1` im Rohlog zugeordnet.
`query_server_1`	`target.ip`	Direkt aus dem Feld `query_server_1` im Rohlog zugeordnet.
`radio`	`security_result.detection_fields[].key`: „radio“ `security_result.detection_fields[].value`: `radio`-Wert aus dem Log	Direkt aus dem Feld `radio` im Rohlog zugeordnet.
`satisfaction_now`	`security_result.detection_fields[].key`: „satisfaction_now“ `security_result.detection_fields[].value`: `satisfaction_now`-Wert aus dem Log	Direkt aus dem Feld `satisfaction_now` im Rohlog zugeordnet.
`source_port`	`principal.port`	Direkt aus dem Feld `source_port` im Rohlog abgeleitet, nachdem es in eine Ganzzahl konvertiert wurde.
`SPT`	`target.port`	Direkt aus dem Feld `SPT` im Rohlog abgeleitet, nachdem es in eine Ganzzahl konvertiert wurde.
`SRC`	`principal.ip`, `principal.hostname`	Direkt aus dem Feld `SRC` im Rohlog zugeordnet.
`sta`	`principal.mac`	Direkt aus dem Feld `sta` im Rohlog zugeordnet.
`state`	`additional.fields[].key`: „state“ `additional.fields[].value.string_value`: `state`-Wert aus dem Log	Direkt aus dem Feld `state` im Rohlog zugeordnet.
`timestamp`	`metadata.event_timestamp`	Direkt aus dem Feld `timestamp` im Rohlog zugeordnet, nachdem es vom Datumsfilter geparst wurde.
`TTL`	`additional.fields[].key`: „TTL“ `additional.fields[].value.string_value`: `TTL`-Wert aus dem Log	Direkt aus dem Feld `TTL` im Rohlog zugeordnet.
`vap`	`metadata.ingestion_labels[].key`: „Vap“ `metadata.ingestion_labels[].value`: `vap`-Wert aus dem Log	Direkt aus dem Feld `vap` im Rohlog zugeordnet.
`version`	`metadata.product_version`	Direkt aus dem Feld `version` im Rohlog zugeordnet.

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