Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Aruba IPS-Logs erfassen

Parserversion:3.0

Unterstützt in:

Google SecOps SIEM

In diesem Dokument wird beschrieben, wie Sie Aruba IPS-Logs mit dem Bindplane-Agent in Google Security Operations aufnehmen. Der Parser extrahiert Ereignisse, Benachrichtigungen, Rogue-APs und WIDS-AP-Informationen aus JSON-formatierten Protokollen. Die Rohprotokolldaten werden in das UDM umgewandelt, indem Felder zugeordnet, verschiedene Ereignistypen (Nutzeranmeldung/-abmeldung, Netzwerkereignisse, Sicherheitsereignisse) verarbeitet und die Daten mit Kontextinformationen wie Channel, SSID, BSSID und Schweregrad angereichert werden. Der Parser führt auch die Zeitstempelnormalisierung und Fehlerbehandlung für fehlerhaftes JSON durch.

Hinweis

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, müssen die Firewallports gemäß den Anforderungen des Bindplane-Agents geöffnet sein.
Berechtigter Zugriff auf die Aruba-Geräteverwaltungskonsole oder ‑Befehlszeile

Authentifizierungsdatei für die Google SecOps-Aufnahme abrufen

Melden Sie sich in der Google SecOps-Konsole an.
Rufen Sie die SIEM-Einstellungen > Collection Agent auf.
Laden Sie die Authentifizierungsdatei für die Aufnahme herunter.
Speichern Sie die Datei sicher auf dem System, auf dem der Bindplane-Agent 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.

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

Bindplane-Agenten für die Aufnahme von Syslog-Daten und das Senden an Google SecOps konfigurieren

Rufen Sie die Konfigurationsdatei auf:
- Suchen Sie die Datei config.yaml. Normalerweise befindet sie sich unter Linux im Verzeichnis /etc/bindplane-agent/ oder unter Windows im Installationsverzeichnis.
- Ö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: YOUR_CUSTOMER_ID_HERE
    endpoint: malachiteingestion-pa.googleapis.com
    # Add optional ingestion labels for better organization
    log_type: 'ARUBA_IPS'
    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 YOUR_CUSTOMER_ID_HERE durch die tatsächliche Kundennummer.
Aktualisieren Sie /path/to/ingestion-authentication-file.json auf den Dateipfad, in dem die Authentifizierungsdatei in Schritt 1 gespeichert wurde.
Aktualisieren Sie den Wert endpoint, damit er der Region Ihres Mandanten entspricht.

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
```
Wenn Sie den Bindplane-Agent 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
```

Syslog-Weiterleitung auf Aruba-Geräten konfigurieren

Wählen Sie die Konfigurationsmethode basierend auf Ihrem Aruba-Gerätetyp aus:

Option A: Aruba-Controller (AOS-8)

Web‑UI verwenden (für CEF-Format empfohlen)

Melden Sie sich in der Weboberfläche des Aruba-Controllers an.
Gehen Sie in der Knotenstruktur Managed Network zu Configuration > System > Logging > Syslog Servers.
Klicken Sie im Bereich Syslog-Server auf +, um einen Logging-Server hinzuzufügen.
Geben Sie die folgenden Konfigurationsdetails an:
- Server-IP-Adresse: Geben Sie die IP-Adresse des Bindplane-Agents ein.
- Port: Geben Sie 514 (oder den in Bindplane konfigurierten Port) ein.
- Protokoll: Wählen Sie je nach Konfiguration des Bindplane-Agents UDP oder TCP aus.
Klicken Sie auf Übernehmen.
Wenn Sie die Arten von Nachrichten auswählen möchten, die protokolliert werden sollen, wählen Sie Logging Levels (Logebenen) aus.
Wählen Sie die Kategorie oder Unterkategorie aus, die protokolliert werden soll.
Wählen Sie in der Drop-down-Liste Logging Level (Logging-Ebene) die gewünschte Ebene für die Kategorie oder Unterkategorie aus.
Wählen Sie in der Drop-down-Liste Format das Protokollierungsformat CEF oder BSD-Standard aus.
- Für strukturiertes Logging wird das ArcSight-CEF (Common Event Format) empfohlen.
Klicken Sie auf Senden.
Klicken Sie auf Ausstehende Änderungen.
Wählen Sie im Fenster Ausstehende Änderungen das Kästchen aus und klicken Sie auf Änderungen bereitstellen.

Option B: Aruba Instant AP

WebUI verwenden

Melden Sie sich in der Weboberfläche von Aruba Instant an.
Klicken Sie im Hauptfenster von Instant auf den Link System.
Klicken Sie auf Erweiterte Optionen einblenden, um die erweiterten Optionen aufzurufen.
Klicken Sie auf den Tab Monitoring.
- Die Details des Tabs „Monitoring“ werden angezeigt.
Geben Sie im Textfeld Syslog-Server im Bereich Server die IP-Adresse des Bindplane-Agents ein.
Wählen Sie im Bereich Syslog Facility Levels (Syslog-Einrichtungsebenen) die erforderlichen Werte aus, um die Syslog-Einrichtungsebenen zu konfigurieren.
- Syslog Level: Detailliertes Log zu Syslog-Ebenen.
- AP-Debug: Detailliertes Protokoll zum Instant AP-Gerät.
- Netzwerk: Protokoll über Netzwerkänderungen, z. B. wenn einem Netzwerk ein neuer Instant AP hinzugefügt wird.
- Sicherheit: Protokoll zur Netzwerksicherheit, z. B. wenn ein Client mit dem falschen Passwort eine Verbindung herstellt.
- System: Protokoll zur Konfiguration und zum Systemstatus.
- Nutzer: Wichtige Protokolle zum Client.
- User-Debug: Detailliertes Log zum Client.
- Drahtlos: Protokoll über Funk.
Klicken Sie auf OK, um die Konfiguration zu speichern.

Befehlszeile verwenden

Melden Sie sich in der Aruba Instant AP-CLI an.
Konfigurationsmodus aufrufen:
```
configure terminal
```
Syslog-Server und ‑Ebene konfigurieren:
```
syslog-server <BINDPLANE_IP_ADDRESS>
syslog-level warnings
```
- Ersetzen Sie <BINDPLANE_IP_ADDRESS> durch die IP-Adresse Ihres Bindplane-Agent-Hosts.
- Passen Sie den Schweregrad nach Bedarf an.

Option C: Aruba AOS-S (Switches)

Melden Sie sich in der Aruba AOS-S-Switch-Befehlszeile an.
Konfigurationsmodus aufrufen:
```
configure
```
Syslog-Server konfigurieren:
```
logging <BINDPLANE_IP_ADDRESS>
logging severity warnings
```
- Ersetzen Sie <BINDPLANE_IP_ADDRESS> durch die IP-Adresse Ihres Bindplane-Agent-Hosts.
- Passen Sie den Schweregrad nach Bedarf an.
Speichern Sie die Konfiguration:
```
write memory
```

Option D: Aruba Central (On-Premises)

Melden Sie sich in der Weboberfläche von Aruba Central an.
Gehen Sie zu System > System Administration > Notifications > Syslog Server.
Klicken Sie auf Hinzufügen oder Aktivieren.
Geben Sie die folgenden Konfigurationsdetails an:
- Host: Geben Sie die IP-Adresse des Bindplane-Agents ein.
- Port: Geben Sie 514 (oder den in Bindplane konfigurierten Port) ein.
- Protokoll: Wählen Sie je nach Konfiguration des Bindplane-Agents UDP oder TCP aus.
- Einrichtung: Wählen Sie Local7 oder nach Bedarf aus.
- Schweregrad: Wählen Sie den minimalen Logebene aus (z. B. Warnung oder Info).
Klicken Sie auf Speichern.

UDM-Zuordnungstabelle

Logfeld	UDM-Zuordnung	Logik
`notifications.created_timestamp`	`metadata.event_timestamp.seconds`	Das Rohlogfeld `notifications.created_timestamp` wird in Sekunden umgewandelt und zugeordnet. Die Nanosekunden gehen bei der Konvertierung verloren.
`notifications.customer_id`	`metadata.product_log_id`	Direkte Zuordnung.
`notifications.device_id`	`principal.resource.product_object_id`	Direkte Zuordnung.
`notifications.group_name`	`principal.group.group_display_name`	Direkte Zuordnung.
`notifications.id`	`metadata.product_log_id`	Direkte Zuordnung.
`notifications.timestamp`	`metadata.event_timestamp.seconds`	Das Rohlogfeld `notifications.timestamp` wird in Sekunden umgewandelt und zugeordnet.
`rogue_aps.acknowledged`	`security_result.detection_fields.value`, wobei `security_result.detection_fields.key` „bestätigt“ ist	In String umgewandelt und zugeordnet.
`rogue_aps.containment_status`	`metadata.description`	Direkte Zuordnung.
`rogue_aps.cust_id`	`metadata.product_log_id`	Direkte Zuordnung.
`rogue_aps.encryption`	`security_result.detection_fields.value`, wobei `security_result.detection_fields.key` „encryption“ ist	Direkte Zuordnung.
`rogue_aps.first_det_device`	`principal.resource.product_object_id`	Direkte Zuordnung.
`rogue_aps.first_det_device_name`	`principal.hostname`	Direkte Zuordnung.
`rogue_aps.first_seen`	`principal.domain.first_seen_time.seconds`	Wird als Datum geparst und die Sekunden seit der UNIX-Epoche werden zugeordnet.
`rogue_aps.group_name`	`principal.group.group_display_name`	Direkte Zuordnung.
`rogue_aps.id`	`principal.mac`	In Kleinbuchstaben und zugeordnet.
`rogue_aps.labels`	`security_result.detection_fields.value`, wobei `security_result.detection_fields.key` „labels“ ist	Direkte Zuordnung.
`rogue_aps.last_det_device`	`security_result.about.user.product_object_id`	Direkte Zuordnung.
`rogue_aps.last_det_device_name`	`target.hostname`	Direkte Zuordnung.
`rogue_aps.last_seen`	`principal.domain.last_seen_time.seconds`	Wird als Datum geparst und die Sekunden seit der UNIX-Epoche werden zugeordnet. Wird auch als Zeitstempel für das Ereignis verwendet, sofern vorhanden.
`rogue_aps.mac_vendor`	`target.administrative_domain`	Direkte Zuordnung.
`rogue_aps.name`	`target.user.userid`	Direkte Zuordnung.
`rogue_aps.overriden`	`security_result.detection_fields.value`, wobei `security_result.detection_fields.key` „überschrieben“ wird	In String umgewandelt und zugeordnet.
`rogue_aps.signal`	`security_result.detection_fields.value`, wobei `security_result.detection_fields.key` „Signal“ ist	In String umgewandelt und zugeordnet.
`rogue_aps.ssid`	`security_result.detection_fields.value`, wobei `security_result.detection_fields.key` „ssid“ ist	Direkte Zuordnung.
`site`	`principal.location.name`	Direkte Zuordnung.
`wids_aps_info_list.attack_type`	`metadata.description`	Direkte Zuordnung.
`wids_aps_info_list.detected_ap`	`principal.hostname`	Direkte Zuordnung.
`wids_aps_info_list.description`	`security_result.description`	Direkte Zuordnung. Wird auch verwendet, um mehrere Felder mit grok zu extrahieren.
`wids_aps_info_list.event_time`	`metadata.event_timestamp.seconds`	Wird in einen String konvertiert und als Ereigniszeitstempel verwendet, sofern vorhanden.
`wids_aps_info_list.event_type`	`metadata.product_event_type`	Direkte Zuordnung.
`wids_aps_info_list.macaddr`	`principal.mac`	In Kleinbuchstaben und zugeordnet.
`wids_aps_info_list.radio_band`	`security_result.detection_fields.value`, wobei `security_result.detection_fields.key` „radio_band“ ist	Direkte Zuordnung.
`wids_aps_info_list.virtual_controller`	`target.hostname`	Direkte Zuordnung. Auf `true` festgelegt, wenn `notifications.severity` „Emergency“ (Notfall), „Alert“ (Warnung) oder „Critical“ (Kritisch) ist. Auf `true` festgelegt, wenn `notifications.severity` „Emergency“ (Notfall), „Alert“ (Warnung) oder „Critical“ (Kritisch) ist. Wird durch die Felder `events.event_type` oder `notifications.type` bestimmt oder standardmäßig auf `GENERIC_EVENT` festgelegt. Aus der Logik werden mehrere Zuordnungen abgeleitet: `STATUS_STARTUP`, `STATUS_SHUTDOWN`, `STATUS_UPDATE`, `USER_LOGIN`, `USER_LOGOUT`. Muss immer auf „ARUBA_IPS“ festgelegt sein. Muss immer auf „ARUBA_IPS“ festgelegt sein. Immer auf „ARUBA“ festgelegt. Legen Sie diesen Wert auf „DHCP“ fest, wenn `events.event_type` „Client DHCP Acknowledged“ oder „Client DHCP Timeout“ ist. Legen Sie diesen Wert auf „BOOTREPLY“ fest, wenn `events.event_type` „Client DHCP Acknowledged“ oder „Client DHCP Timeout“ ist. Wird aus `events.description` mit „grok“ extrahiert, wenn `events.event_type` „Client DHCP Acknowledged“ ist. Auf „ACK“ setzen, wenn `events.event_type` „Client DHCP Acknowledged“ ist und `events.description` eine IP-Adresse enthält. Andernfalls auf „WIN_EXPIRED“ setzen. Auf „ACCESS POINT“ festgelegt, wenn `events.event_type` mit „Radio“, „WLAN“, „AP“ beginnt oder „Security“ lautet. Auf „DEVICE“ festgelegt, wenn `events.event_type` mit „Radio“, „WLAN“, „AP“ beginnt oder „Security“ lautet. Wird für die meisten Client-Ereignisse aus `events.client_mac` und für Ereignisse zu nicht autorisierten Zugriffspunkten aus `rogue_aps.last_det_device` abgeleitet. Auf „AUTH_VIOLATION“ für bestimmte `events.event_type`-Werte oder wenn `notifications.description` „DoS Attack“ oder „disconnect attack“ enthält. Legen Sie die Werte für bestimmte `events.event_type` fest. Es werden mehrere Schlüssel-Wert-Paare basierend auf extrahierten Feldern wie `bssid`, `channel`, `previous_channel`, `ssid`, `previous bssid`, `acknowledged`, `overriden`, `encryption`, `signal`, `labels`, `radio_band` hinzugefügt. Für WIDs-Ereignisse aus `wids_aps_info_list.description` zugeordnet. Wird durch `notifications.severity` oder `wids_aps_info_list.level` bestimmt. Für WIDS-Ereignisse auf „level: %{wids_aps_info_list.level}“ festgelegt. Legen Sie die Werte für bestimmte `events.event_type` fest. Wird für Ereignisse zu nicht autorisierten APs aus `rogue_aps.mac_vendor` zugeordnet. Wird aus `rogue_aps.last_det_device_name` für Rogue-AP-Ereignisse oder aus `wids_aps_info_list.virtual_controller` für WIDS-Ereignisse zugeordnet. Aus `events.description` extrahiert, wenn `events.event_type` „Security“ ist. Zugeordnet von `notifications.client_mac` für Benachrichtigungsereignisse, `events.client_mac` für Client-Ereignisse, `target_mac` aus `wids_aps_info_list.description` für WIDS-Ereignisse oder `rogue_aps.id` für Rogue-AP-Ereignisse. Für die meisten Client-Ereignisse auf „CLIENT“ festgelegt. Für die meisten Client-Ereignisse auf „DEVICE“ festgelegt. Auf „ACTIVE“ festgelegt, wenn `events.event_type` „Security“ ist. Wird für Ereignisse zu nicht autorisierten APs aus `rogue_aps.name` zugeordnet.
`events.bssid`	`security_result.detection_fields.value`, wobei `security_result.detection_fields.key` „bssid“ ist	Direkte Zuordnung.
`events.client_mac`	`target.mac`	Direkte Zuordnung. Wird auch verwendet, um `security_result.about.user.product_object_id` für Clientereignisse und `target.ip` für Sicherheitsereignisse zu füllen.
`events.description`	`metadata.description`	Direkte Zuordnung für AP- und Funkeinheitenereignisse. Wird verwendet, um mehrere Felder mit grok für andere Ereignistypen zu extrahieren.
`events.device_mac`	`principal.mac`	Direkte Zuordnung.
`events.device_serial`	`principal.resource.product_object_id`	Direkte Zuordnung.
`events.events_details.2.channel`	`security_result.detection_fields.value`, wobei `security_result.detection_fields.key` „channel“ ist	Direkte Zuordnung.
`events.group_name`	`principal.group.group_display_name`	Direkte Zuordnung.
`events.hostname`	`principal.hostname`	Direkte Zuordnung.
`events.timestamp`	`metadata.event_timestamp.seconds`	In einen String konvertiert, werden Millisekunden entfernt und dann zugeordnet. Wird auch als Zeitstempel für das Ereignis verwendet, sofern vorhanden.
`timestamp`	`metadata.event_timestamp`	Wird als Ereigniszeitstempel verwendet, wenn keine anderen Zeitstempelfelder vorhanden sind. Für die meisten Client- und Sicherheitsereignisse auf „AKTIV“ gesetzt. Legen Sie diesen Wert auf „AUTHTYPE_UNSPECIFIED“ fest, wenn `events.event_type` „Client 802.1x Radius Reject“ ist. Aus `events.description` extrahiert, wenn `events.event_type` „Security“ ist.

Änderungsprotokoll

Änderungsprotokoll für diesen Parser ansehen

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