Aruba IPS-Logs erfassen
Parserversion: 3.0
In diesem Dokument wird beschrieben, wie Sie Aruba IPS-Logs mit dem Bindplane-Agenten in Google Security Operations aufnehmen. Der Parser extrahiert Ereignisse, Benachrichtigungen, Rogue-APs und WIDS-AP-Informationen aus JSON-formatierten Logs. Die Rohprotokolldaten werden in das UDM-Format umgewandelt, indem Felder zugeordnet, verschiedene Ereignistypen (Nutzeranmeldung/-abmeldung, Netzwerkereignisse, Sicherheitsereignisse) verarbeitet und die Daten mit Kontextinformationen wie Kanal, SSID, BSSID und Schweregrad angereichert werden. Der Parser führt auch eine Zeitstempelnormalisierung und Fehlerbehandlung für fehlerhafte JSON-Dateien durch.
Hinweis
Prüfen Sie, ob folgende Voraussetzungen erfüllt sind:
- Eine Google SecOps-Instanz
- Ein Windows 2016- oder höherer oder Linux-Host mit
systemd - Wenn der Agent hinter einem Proxy ausgeführt wird, müssen die Firewallports gemäß den Anforderungen des Bindplane-Agents geöffnet sein.
- Privilegierter Zugriff auf die Aruba-Geräteverwaltungskonsole oder die Befehlszeile
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)
- 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.
- Rufen Sie IAM und Verwaltung > Dienstkonten auf.
- Klicken Sie auf Dienstkonto erstellen.
- 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).
- Name des Dienstkontos: Geben Sie einen Namen für das Konto ein (z. B.
- Klicken Sie auf Erstellen und fortfahren.
- Klicken Sie im Abschnitt Diesem Dienstkonto Zugriff auf das Projekt erteilen auf Rolle auswählen und wählen Sie Chronicle Editor aus.
- Klicken Sie auf Weiter und dann auf Fertig.
- Klicken Sie auf das von Ihnen erstellte Dienstkonto und rufen Sie den Tab Schlüssel auf.
- Klicken Sie auf Schlüssel hinzufügen > Neuen Schlüssel erstellen.
- Wählen Sie JSON aus und klicken Sie auf Erstellen. Die Schlüsseldatei wird auf Ihren Computer heruntergeladen.
- Speichern Sie die Schlüsseldatei als
ingestion-auth.jsonim Bindplane-Collector-Verzeichnis (/opt/observiq-otel-collector/ingestion-auth.jsonunter Linux oderC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsonunter Windows) oder aktualisieren Siecreds_file_pathinconfig.yaml, sodass der Pfad mit dem Pfad übereinstimmt, unter dem Sie die Datei speichern. - Rufen Sie IAM und Verwaltung > Einstellungen auf und kopieren Sie die Projektnummer. Sie benötigen sie für die Exporter-Konfiguration.
Option 2: Authentifizierungsdatei für die Datenaufnahme herunterladen (Legacy)
- Melden Sie sich in der Google SecOps-Konsole an.
- Rufen Sie Einstellungen > Datenverwaltung > Erfassungs-Agents auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Erfassungs-Agents auf.
- Laden Sie die Authentifizierungsdatei für die Datenaufnahme herunter.
- Speichern Sie die Datei sicher auf dem System, auf dem der Bindplane-Agent installiert werden soll.
Google SecOps-Kundennummer abrufen
- Melden Sie sich in der Google SecOps-Konsole an.
- Gehen Sie zu Einstellungen > Verwaltung > Profil. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Profil auf.
- Kopieren und speichern Sie die Kundennummer aus dem Bereich Organisationsdetails.
Bindplane-Agent installieren
Installieren Sie den Bindplane-Agenten gemäß der folgenden Anleitung auf Ihrem Windows- oder Linux-Betriebssystem.
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 dieser Installationsanleitung.
Bindplane-Agent für die Aufnahme von Syslog und das Senden an Google SecOps konfigurieren
Greifen Sie auf die Konfigurationsdatei zu:
- Suchen Sie die Datei
config.yaml. In der Regel befindet sie sich unter Linux im Verzeichnis/opt/observiq-otel-collector/oder unter Windows im Installationsverzeichnis. - Öffnen Sie die Datei mit einem Texteditor (z. B.
nano,vioder Notepad).
- Suchen Sie die Datei
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: 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 # 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: chronicle.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_HEREdurch die tatsächliche Kundennummer. - Aktualisieren Sie
/path/to/ingestion-authentication-file.jsonauf den Dateipfad, unter dem die Dienstkontoschlüsseldatei (Option 1) in Schritt 1 gespeichert wurde. - Ersetzen Sie
<LOCATION>durch die Region Ihrer Google SecOps-Instanz (z. B.us,europeoderasia-southeast1). Der Exporter stellt diesem Wertchronicle.googleapis.comvoran. Eine vollständige Liste finden Sie unter Regionale Endpunkte. - Ersetzen Sie
<PROJECT_NUMBER>durch die Projektnummer aus IAM und Verwaltung > Einstellungen.
Legacy-Ingestion-API-Exporter
Wenn Sie die Authentifizierungsdatei für die Datenaufnahme aus Option 2 verwenden, ersetzen Sie den Block
exportersdurch Folgendes. Legen Sie fürcreds_file_pathden Pfad zur Authentifizierungsdatei für die Datenaufnahme fest. Wenn sich Ihre Instanz außerhalb der USA befindet, ersetzen Siemalachiteingestion-pa.googleapis.comdurch Ihren regionalen Endpunkt (z. B.europe-malachiteingestion-pa.googleapis.com).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:
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-collectorWenn Sie den Bindplane-Agenten 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)
WebUI verwenden (für CEF-Format empfohlen)
- Melden Sie sich in der Weboberfläche des Aruba-Controllers an.
- Gehen Sie in der Knotenhierarchie Managed Network zu Configuration > System > Logging > Syslog Servers.
- Wenn Sie einen Logging-Server hinzufügen möchten, klicken Sie im Bereich Syslog-Server auf +.
- Geben Sie die folgenden Konfigurationsdetails an:
- Server-IP-Adresse: Geben Sie die IP-Adresse des Bindplane-Agents ein.
- Port: Geben Sie
514ein (oder den in Bindplane konfigurierten Port). - Protokoll: Wählen Sie je nach Bindplane-Agent-Konfiguration UDP oder TCP aus.
- Klicken Sie auf Übernehmen.
- Wählen Sie Logging-Ebenen aus, um die Arten von Nachrichten auszuwählen, die Sie protokollieren möchten.
- Wählen Sie die Kategorie oder Unterkategorie aus, die protokolliert werden soll.
- Wählen Sie den Schweregrad für die Kategorie oder Unterkategorie aus der Drop-down-Liste Logging-Ebene aus.
- Wählen Sie in der Drop-down-Liste Format das Logging-Format 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 Abschnitt Server die IP-Adresse des Bindplane-Agents ein.
- Wählen Sie im Abschnitt Syslog Facility Levels die erforderlichen Werte aus, um die Syslog-Einrichtungsebenen zu konfigurieren.
- Syslog-Ebene: Detailliertes Protokoll zu Syslog-Ebenen.
- AP-Debug: Detailliertes Protokoll zum Instant AP-Gerät.
- Netzwerk: Protokoll über Netzwerkänderungen, z. B. wenn ein neuer Instant AP zu einem Netzwerk hinzugefügt wird.
- Sicherheit: Protokoll zur Netzwerksicherheit, z. B. wenn ein Client eine Verbindung mit einem falschen Passwort herstellt.
- System: Protokoll zu Konfiguration und Systemstatus.
- Nutzer: Wichtige Protokolle zum Client.
- User-Debug: Detailliertes Log zum Client.
- Drahtlos: Protokoll zu Funkschnittstellen.
- Klicken Sie auf OK, um die Konfiguration zu speichern.
Über die Befehlszeile
- Melden Sie sich in der Aruba Instant AP-Befehlszeile an.
Rufen Sie den Konfigurationsmodus auf:
configure terminalSyslog-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.
- Ersetzen Sie
Option C: Aruba AOS-S (Switches)
- Melden Sie sich in der Aruba AOS-S-Switch-Befehlszeile an.
Rufen Sie den Konfigurationsmodus auf:
configureSyslog-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.
- Ersetzen Sie
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
514ein (oder den in Bindplane konfigurierten Port). - Protokoll: Wählen Sie je nach Bindplane-Agent-Konfiguration UDP oder TCP aus.
- Facility: Wählen Sie Local7 oder eine andere Option aus.
- Schweregrad: Wählen Sie die minimale 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 „acknowledged“ ist |
In String konvertiert 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 umgewandelt 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 Ereigniszeitstempel verwendet, falls 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 „overriden“ ist |
In String konvertiert und zugeordnet. |
rogue_aps.signal |
security_result.detection_fields.value, wobei security_result.detection_fields.key „signal“ ist |
In String konvertiert 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, falls vorhanden. |
wids_aps_info_list.event_type |
metadata.product_event_type |
Direkte Zuordnung. |
wids_aps_info_list.macaddr |
principal.mac |
In Kleinbuchstaben umgewandelt 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. Wird auf true gesetzt, wenn notifications.severity „Emergency“, „Alert“ oder „Critical“ ist. Wird auf true gesetzt, wenn notifications.severity „Emergency“, „Alert“ oder „Critical“ 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. Immer auf „ARUBA_IPS“ festgelegt. Immer auf „ARUBA_IPS“ gesetzt. Immer auf „ARUBA“ festgelegt. Legen Sie „DHCP“ fest, wenn events.event_type „Client DHCP Acknowledged“ oder „Client DHCP Timeout“ ist. Legen Sie „BOOTREPLY“ fest, wenn events.event_type „Client DHCP Acknowledged“ oder „Client DHCP Timeout“ ist. Wird mit Grok aus events.description extrahiert, wenn events.event_type „Client DHCP Acknowledged“ ist. Wird auf „ACK“ gesetzt, wenn events.event_type „Client DHCP Acknowledged“ ist und events.description eine IP-Adresse enthält. Andernfalls wird der Wert auf „WIN_EXPIRED“ gesetzt. Legen Sie „ACCESS POINT“ fest, wenn events.event_type mit „Radio“, „WLAN“ oder „AP“ beginnt oder „Security“ ist. Legen Sie „DEVICE“ fest, wenn events.event_type mit „Radio“, „WLAN“ oder „AP“ beginnt oder „Security“ ist. Wird für die meisten Client-Ereignisse aus events.client_mac oder für Rogue-AP-Ereignisse aus rogue_aps.last_det_device zugeordnet. Wird für bestimmte events.event_type-Werte oder wenn notifications.description „DoS-Angriff“ oder „disconnect attack“ enthält, auf „AUTH_VIOLATION“ gesetzt. Für bestimmte events.event_type-Werte festlegen. Mehrere Schlüssel/Wert-Paare werden basierend auf extrahierten Feldern wie bssid, channel, previous_channel, ssid, previous bssid, acknowledged, overriden, encryption, signal, labels, radio_band hinzugefügt. Zugeordnet von wids_aps_info_list.description für wids-Ereignisse. Wird durch notifications.severity oder wids_aps_info_list.level bestimmt. Für WIDS-Ereignisse auf „level: %{wids_aps_info_list.level}“ festlegen. Für bestimmte events.event_type-Werte festlegen. Wird für Ereignisse mit nicht autorisierten Zugriffspunkten aus rogue_aps.mac_vendor zugeordnet. Zugeordnet von rogue_aps.last_det_device_name für Ereignisse mit nicht autorisierten Zugriffspunkten oder wids_aps_info_list.virtual_controller für WIDS-Ereignisse. Wird mit Grok aus events.description extrahiert, wenn events.event_type „Security“ ist. Zugeordnet von notifications.client_mac für Benachrichtigungsereignisse, events.client_mac für Clientereignisse, target_mac extrahiert aus wids_aps_info_list.description für WIDS-Ereignisse oder rogue_aps.id für Rogue-AP-Ereignisse. Legen Sie für die meisten Clientereignisse „CLIENT“ fest. Für die meisten Clientereignisse auf „DEVICE“ festgelegt. Legen Sie „ACTIVE“ fest, wenn events.event_type „Security“ ist. Wird für Ereignisse mit nicht autorisierten Zugriffspunkten 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 Radio-Ereignisse. 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 |
Wird in einen String konvertiert, Millisekunden werden entfernt und dann zugeordnet. Wird auch als Ereigniszeitstempel verwendet, falls vorhanden. |
timestamp |
metadata.event_timestamp |
Wird als Ereigniszeitstempel verwendet, wenn keine anderen Zeitstempelfelder vorhanden sind. Legen Sie für die meisten Client- und Sicherheitsereignisse „ACTIVE“ fest. Legen Sie „AUTHTYPE_UNSPECIFIED“ fest, wenn events.event_type „Client 802.1x Radius Reject“ ist. Wird mit Grok 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