Juniper Junos-Logs erfassen
In diesem Dokument wird beschrieben, wie Sie Juniper Junos-Logs mit Bindplane in Google Security Operations aufnehmen.
Juniper Junos OS ist das Betriebssystem, das auf Routern, Switches und Sicherheitsgeräten von Juniper Networks ausgeführt wird. Sie bietet eine einheitliche Plattform für die Verwaltung der Netzwerkinfrastruktur, Routing-, Switching- und Sicherheitsfunktionen mit umfassender Protokollierung von Systemereignissen, Sicherheitsereignissen und Netzwerkverkehr. Der Parser extrahiert Felder aus Syslog- und Schlüssel/Wert-formatierten Logs von Juniper Junos. Die Log-Nachricht wird mit „grok“ und/oder „kv“ geparst und die Werte werden dem Unified Data Model (UDM) zugeordnet. Außerdem werden Standardmetadatenwerte für die Ereignisquelle und den Ereignistyp festgelegt.
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 - 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 das Juniper-Gerät mit Junos OS
Authentifizierungsdatei für die Google SecOps-Datenaufnahme 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" /quietWarten Sie, bis die Installation abgeschlossen ist.
Ü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
- Ö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.shWarten Sie, bis die Installation abgeschlossen ist.
Ü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 /etc/bindplane-agent/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
Konfigurationsdatei bearbeiten
Ersetzen Sie den gesamten Inhalt von
config.yamldurch die folgende Konfiguration:receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/chronicle_w_labels: compression: gzip creds_file_path: '/path/to/ingestion-authentication-file.json' customer_id: 'YOUR_CUSTOMER_ID' endpoint: malachiteingestion-pa.googleapis.com log_type: 'JUNIPER_JUNOS' raw_log_field: body ingestion_labels: service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labels
Konfigurationsparameter
Ersetzen Sie die folgenden Platzhalter:
Empfängerkonfiguration:
udplog: Verwenden Sieudplogfür UDP-Syslog odertcplogfür TCP-Syslog.0.0.0.0: IP-Adresse, an der gelauscht werden soll (0.0.0.0, um an allen Schnittstellen zu lauschen)514: Portnummer, die überwacht werden soll (Standard-Syslog-Port)
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
- Linux:
YOUR_CUSTOMER_ID: Kunden-ID aus dem Abschnitt „Kunden-ID abrufen“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.
- USA:
log_type: Logtyp genau wie in Chronicle (JUNIPER_JUNOS)
Konfigurationsdatei speichern
- Speichern Sie die Datei nach der Bearbeitung:
- Linux: Drücken Sie
Ctrl+O, dannEnterund dannCtrl+X. - Windows: Klicken Sie auf Datei > Speichern.
- Linux: Drücken Sie
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-collectorPrüfen Sie, ob der Dienst ausgeführt wird:
sudo systemctl status observiq-otel-collectorLogs 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-collectorServices-Konsole:
- Drücken Sie
Win+R, geben Sieservices.mscein und drücken Sie die Eingabetaste. - Suchen Sie nach observIQ OpenTelemetry Collector.
Klicken Sie mit der rechten Maustaste und wählen Sie Neu starten aus.
Prüfen Sie, ob der Dienst ausgeführt wird:
sc query observiq-otel-collectorLogs auf Fehler prüfen:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
- Drücken Sie
Syslog-Weiterleitung auf Juniper Junos konfigurieren
- Stellen Sie über SSH oder die Konsole eine Verbindung zum Juniper-Gerät her.
Konfigurationsmodus aufrufen:
configureKonfigurieren Sie den Syslog-Host mit den folgenden Befehlen:
set system syslog host BINDPLANE_IP any info set system syslog host BINDPLANE_IP port 514 set system syslog host BINDPLANE_IP facility-override local7 set system syslog host BINDPLANE_IP log-prefix JUNOS- Ersetzen Sie
BINDPLANE_IPdurch die IP-Adresse des Bindplane-Agent-Hosts.
- Ersetzen Sie
Zusätzliche Log-Quellen konfigurieren (optional, aber empfohlen):
set system syslog host BINDPLANE_IP authorization info set system syslog host BINDPLANE_IP daemon info set system syslog host BINDPLANE_IP kernel info set system syslog host BINDPLANE_IP firewall any set system syslog host BINDPLANE_IP interactive-commands infoStrukturierte Syslog-Daten konfigurieren (optional für erweitertes Parsen):
set system syslog host BINDPLANE_IP structured-dataFühren Sie ein Commit der Konfiguration durch:
commit and-quitSyslog-Konfiguration prüfen:
show system syslog host BINDPLANE_IPPrüfen Sie die Bindplane-Agent-Logs, um zu sehen, ob Syslog-Nachrichten gesendet werden.
UDM-Zuordnungstabelle
| Logfeld | UDM-Zuordnung | Logik |
|---|---|---|
| DVB | target.port | Der Zielport der Netzwerkverbindung, in eine Ganzzahl konvertiert. |
| Steuer auf digitale Dienste | target.ip | Die Ziel-IP-Adresse der Netzwerkverbindung. |
| FLAG | additional.fields{}.key: "FLAG", additional.fields{}.value.string_value: Value of FLAG | Das TCP-Flag, das mit der Netzwerkverbindung verknüpft ist. |
| ID | additional.fields{}.key: "ID", additional.fields{}.value.string_value: Value of ID | Das Feld für die IP-Identifizierung. |
| IN | additional.fields{}.key: "IN", additional.fields{}.value.string_value: Value of IN | Die eingehende Netzwerkschnittstelle. |
| LEN | additional.fields{}.key: "LEN", additional.fields{}.value.string_value: Wert von LEN | Die Länge des IP-Pakets. |
| MAC | principal.mac | Die aus dem MAC-Feld extrahierte MAC-Adresse. |
| OUT | additional.fields{}.key: "OUT", additional.fields{}.value.string_value: Value of OUT | Die ausgehende Netzwerkschnittstelle. |
| PREC | additional.fields{}.key: "PREC", additional.fields{}.value.string_value: Value of PREC | Das Feld „Vorrang“ im IP-Header. |
| PROTO | network.ip_protocol | Das in der Netzwerkverbindung verwendete IP-Protokoll. |
| RES | additional.fields{}.key: "RES", additional.fields{}.value.string_value: Value of RES | Reserviertes Feld im TCP-Header. |
| SPT | principal.port | Der Quellport der Netzwerkverbindung, in eine Ganzzahl konvertiert. |
| SRC | principal.ip | Die Quell-IP-Adresse der Netzwerkverbindung. |
| TOS | additional.fields{}.key: "TOS", additional.fields{}.value.string_value: Value of TOS | Das Feld „Type of Service“ (Diensttyp) im IP-Header. |
| TTL | network.dns.additional.ttl | Der in eine vorzeichenlose Ganzzahl konvertierte TTL-Wert (Time To Live). |
| URGP | additional.fields{}.key: "URGP", additional.fields{}.value.string_value: Value of URGP | Urgent-Pointer-Feld im TCP-Header. |
| WINDOW | additional.fields{}.key: „WINDOW_SIZE“, additional.fields{}.value.string_value: Wert von WINDOW | Die TCP-Fenstergröße. |
| Aktion | security_result.action | Die von der Firewall ergriffene Maßnahme, die aus der CEF-Nachricht extrahiert wurde. |
| agt | observer.ip | Die IP-Adresse des Agents. |
| amac | target.mac | Die MAC-Adresse des Ziels, in Kleinbuchstaben umgewandelt und mit Doppelpunkten anstelle von Bindestrichen. |
| App | target.application | Die Anwendung, die an dem Ereignis beteiligt ist. |
| artz | observer.zone | Die Zeitzone des Beobachters. |
| atz | target.location.country_or_region | Die Zielzeitzone. |
| categoryBehavior | additional.fields{}.key: „Category Behavior“, additional.fields{}.value.string_value: Wert von „categoryBehavior“ ohne Schrägstriche | Das Kategorieverhalten. |
| categoryDeviceGroup | additional.fields{}.key: „Category Device Group“, additional.fields{}.value.string_value: Wert von categoryDeviceGroup ohne Schrägstriche | Die Kategorie „Gerätegruppe“. |
| categoryObject | additional.fields{}.key: „Category Object“, additional.fields{}.value.string_value: Wert von „categoryObject“ ohne Schrägstriche | Das Kategorieobjekt. |
| categoryOutcome | additional.fields{}.key: „Category Outcome“, additional.fields{}.value.string_value: Wert von „categoryOutcome“ ohne Schrägstriche | Das Kategorieergebnis. |
| categorySignificance | additional.fields{}.key: „category Significance“, additional.fields{}.value.string_value: Wert von categorySignificance | Die Kategorie-Signifikanz. |
| Befehl | target.process.command_line | Der Befehl wurde ausgeführt. |
| cs1Label | additional.fields{}.key: cs1Label, additional.fields{}.value.string_value: Wert des entsprechenden CEF-Felds | Label und Wert des benutzerdefinierten Stringfelds 1 aus der CEF-Nachricht. |
| cs2Label | additional.fields{}.key: cs2Label, additional.fields{}.value.string_value: Wert des entsprechenden CEF-Felds | Label und Wert des benutzerdefinierten Stringfelds 2 aus der CEF-Nachricht. |
| cs3Label | additional.fields{}.key: cs3Label, additional.fields{}.value.string_value: Wert des entsprechenden CEF-Felds | Label und Wert des benutzerdefinierten Stringfelds 3 aus der CEF-Nachricht. |
| cs4Label | additional.fields{}.key: cs4Label, additional.fields{}.value.string_value: Wert des entsprechenden CEF-Felds | Label und Wert des benutzerdefinierten Stringfelds 4 aus der CEF-Nachricht. |
| cs5Label | additional.fields{}.key: cs5Label, additional.fields{}.value.string_value: Wert des entsprechenden CEF-Felds | Label und Wert des benutzerdefinierten Stringfelds 5 aus der CEF-Nachricht. |
| cs6Label | additional.fields{}.key: cs6Label, additional.fields{}.value.string_value: Wert des entsprechenden CEF-Felds | Label und Wert des benutzerdefinierten Stringfelds 6 aus der CEF-Nachricht. |
| dhost | target.hostname | Ziel-Hostname. |
| deviceCustomString1 | additional.fields{}.key: cs1Label, additional.fields{}.value.string_value: Value of deviceCustomString1 | Benutzerdefinierter String 1 für Geräte. |
| deviceCustomString2 | additional.fields{}.key: cs2Label, additional.fields{}.value.string_value: Value of deviceCustomString2 | Benutzerdefinierter String 2 für Geräte. |
| deviceCustomString3 | additional.fields{}.key: cs3Label, additional.fields{}.value.string_value: Value of deviceCustomString3 | Benutzerdefinierter String 3 für Geräte. |
| deviceCustomString4 | additional.fields{}.key: cs4Label, additional.fields{}.value.string_value: Value of deviceCustomString4 | Benutzerdefinierter Geräte-String 4. |
| deviceCustomString5 | additional.fields{}.key: cs5Label, additional.fields{}.value.string_value: Value of deviceCustomString5 | Benutzerdefinierter String 5 für Geräte. |
| deviceCustomString6 | additional.fields{}.key: cs6Label, additional.fields{}.value.string_value: Value of deviceCustomString6 | Benutzerdefinierter String 6 für Geräte. |
| deviceDirection | network.direction | Die Richtung des Netzwerkverkehrs. |
| deviceEventClassId | additional.fields{}.key: "eventId", additional.fields{}.value.string_value: Value of deviceEventClassId | Die Geräteereignisklassen-ID. |
| deviceFacility | observer.product.subproduct | Die Geräteanlage. |
| deviceProcessName | about.process.command_line | Der Prozessname des Geräts. |
| deviceSeverity | security_result.severity | Die Schwere des Geräts. |
| deviceTimeZone | observer.zone | Die Zeitzone des Geräts. |
| deviceVendor | metadata.vendor_name | Der Geräteanbieter. |
| deviceVersion | metadata.product_version | Die Geräteversion. |
| dpt | target.port | Der Zielport. |
| dst | target.ip | Die Ziel-IP-Adresse. |
| duser | target.user.user_display_name | Der Zielnutzer. |
| eventId | additional.fields{}.key: "eventId", additional.fields{}.value.string_value: Value of eventId | Ereignis-ID |
| event_time | metadata.event_timestamp | Die Zeit, zu der das Ereignis aufgetreten ist, aus der Nachricht geparst. |
| firewall_action | security_result.action_details | Die ausgeführte Firewallaktion. |
| Host | hauptkonto.hostname, vermittler.hostname | Der Hostname des Geräts, das das Log generiert. Wird in verschiedenen Fällen sowohl für den Auftraggeber als auch für den Vermittler verwendet. |
| msg | security_result.summary | Die mit dem Ereignis verknüpfte Nachricht, die als Zusammenfassung für das Sicherheitsergebnis verwendet wird. |
| Name | metadata.product_event_type | Der Name des Ereignisses. |
| process_name | additional.fields{}.key: "process_name", additional.fields{}.value.string_value: Value of process_name | Der Name des Prozesses. |
| p_id | target.process.pid | Die Prozess-ID, in einen String konvertiert. |
| sha256 | principal.process.file.sha256 | Der SHA256-Hash einer Datei, die aus den SSH2-Schlüsselinformationen extrahiert wurde. |
| shost | principal.hostname | Hostname der Quelle. |
| source_address | principal.ip | Die Quell-IP-Adresse. |
| source_port | principal.port | Der Quellport, in eine Ganzzahl konvertiert. |
| src | principal.ip | Die Quell-IP-Adresse. |
| src_ip | principal.ip | Die Quell-IP-Adresse. |
| src_port | principal.port | Der Quellport, in eine Ganzzahl konvertiert. |
| ssh2 | security_result.detection_fields{}.key: "ssh2", security_result.detection_fields{}.value: Value of ssh2 | Informationen zum SSH2-Schlüssel. |
| Untertyp | metadata.product_event_type | Der Untertyp des Ereignisses. |
| task_summary | security_result.description | Die Aufgabenübersicht, die als Beschreibung für das Sicherheitsergebnis verwendet wird. |
| timestamp | metadata.event_timestamp | Der Zeitstempel des Ereignisses. |
| Nutzer | target.user.userid | Der Nutzer, der mit dem Ereignis verknüpft ist. |
| Nutzername | principal.user.userid | Der Nutzername, der mit dem Ereignis verknüpft ist. |
| user_name | principal.user.userid | Der Nutzername. |
| metadata.vendor_name | Fest codiert auf „Juniper Firewall“. Fest codiert auf „Juniper Firewall“. Fest codiert auf „JUNIPER_JUNOS“. Wird durch die Parserlogik basierend auf dem Loginhalt bestimmt. Der Standardwert ist „STATUS_UPDATE“, wenn es sich nicht um eine CEF-Nachricht handelt und kein anderer spezifischer Ereignistyp identifiziert wird. Legen Sie für CEF-Nachrichten „NETWORK_HTTP“ fest. Wenn kein „desc“-Feld vorhanden ist, wird dieses Feld mit der aus dem Roh-Logeintrag extrahierten „message_description“ gefüllt. | |
protocol-name |
network.ip_protocol |
Aus dem Änderungsprotokoll zugeordnet |
application_name |
target.application |
Aus dem Änderungsprotokoll zugeordnet |
desc |
sec_result.summary |
Aus dem Änderungsprotokoll zugeordnet |
mac-address |
principal.mac |
Aus dem Änderungsprotokoll zugeordnet |
Änderungsprotokoll
Änderungsprotokoll für diesen Parser ansehen
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten