Cisco eStreamer-Logs erfassen

Parserversion: 5.0

Unterstützt in:

In diesem Dokument wird beschrieben, wie Sie Cisco eStreamer-Logs mit Bindplane in Google Security Operations aufnehmen können.
Der Parser extrahiert Felder aus Cisco eStreamer-Syslog-formatierten Logs mit Schlüssel/Wert-Paaren. Dabei werden grok und/oder kv verwendet, um den Logeintrag zu parsen. Anschließend werden diese Werte 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 der Agent hinter einem Proxy ausgeführt wird, müssen die Firewallports gemäß den Anforderungen des Bindplane-Agents geöffnet sein.
  • Privilegierter Zugriff auf das Cisco Firepower Management Center (FMC).
  • Ein Linux-System zum Ausführen des eNcore-CLI-Clients.

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.
  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 und 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 Editor aus.
  7. Klicken Sie auf Weiter und dann auf Fertig.
  8. Klicken Sie auf das von Ihnen erstellte Dienstkonto und rufen Sie 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, sodass der Pfad mit dem Pfad übereinstimmt, unter 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.

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

  1. Melden Sie sich in der Google SecOps-Konsole an.
  2. Rufen Sie Einstellungen > Datenverwaltung > Erfassungs-Agents auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die 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.

Google SecOps-Kundennummer abrufen

  1. Melden Sie sich in der Google SecOps-Konsole an.
  2. Gehen Sie zu Einstellungen > Verwaltung > Profil. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Profil auf.
  3. 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

  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

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

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

  1. Konfigurationsdatei aufrufen:

    • Suchen Sie die Datei config.yaml. In der Regel befindet sie sich unter Linux im Verzeichnis /observiq-otel-collector/ oder unter Windows im Verzeichnis „C:\Programme\observIQ OpenTelemetry Collector“.
    • Öffnen Sie die Datei mit einem Texteditor (z. B. nano, vi oder Notepad).

  2. Bearbeiten Sie die Datei config.yamlso:

    receivers:
  udplog:
    # Replace the port and IP address as required
    listen_address: "0.0.0.0:5514"

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
    endpoint: chronicle.googleapis.com
    # Add optional ingestion labels for better organization
    log_type: 'CISCO_ESTREAMER'
    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 <LOCATION> durch die Region Ihrer Google SecOps-Instanz (z. B. us, europe oder asia-southeast1). Der Exporter stellt diesem Wert chronicle.googleapis.com voran.
  • Ersetzen Sie <PROJECT_NUMBER> durch die Projektnummer aus IAM und Verwaltung > Einstellungen.
  • Ersetzen Sie YOUR_CUSTOMER_ID durch die tatsächliche Kundennummer.
  • Aktualisieren Sie /path/to/ingestion-authentication-file.json auf den Dateipfad, unter dem die Dienstkontoschlüsseldatei (Option 1) in Schritt 1 gespeichert wurde.

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/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
    endpoint: malachiteingestion-pa.googleapis.com
    # Add optional ingestion labels for better organization
    log_type: 'CISCO_ESTREAMER'
    raw_log_field: body
    ingestion_labels:

Starten Sie den Bindplane-Agent neu, um die Änderungen zu übernehmen.

So starten Sie den Bindplane-Agenten unter Linux neu:

  1. Führen Sie dazu diesen Befehl aus:

    sudo systemctl restart observiq-otel-collector

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

    sudo systemctl status observiq-otel-collector

  3. Prüfen Sie die Logs auf Fehler:

    sudo journalctl -u observiq-otel-collector -f

So starten Sie den Bindplane-Agenten unter Windows neu:

  1. Wählen Sie eine der folgenden Optionen aus:

    • 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.

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

    sc query observiq-otel-collector

  3. Prüfen Sie die Logs auf Fehler:

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

Syslog-Weiterleitung auf Cisco eStreamer konfigurieren

eStreamer im Firepower Management Center konfigurieren

  1. Melden Sie sich im Firepower Management Center an.
  2. Gehen Sie zu System > Integration > eStreamer.
  3. Klicken Sie auf eStreamer, um die eStreamer-Ereigniskonfiguration aufzurufen.
  4. Klicken Sie die Kästchen neben den Ereignistypen an, die Sie erfassen möchten:
    • Einbruchsereignisse: Für Einbruchserkennungsereignisse
    • Paketdaten zu Einbruchsereignissen: Für Paketerfassungen im Zusammenhang mit Einbruchsereignissen
    • Verbindungsereignisse: Für Netzwerkverbindungsdaten
    • Security Intelligence Events: Für Threat Intelligence-Daten
    • Dateiereignisse: Für Ereignisse im Zusammenhang mit der Dateianalyse
    • Malware-Ereignisse: Für Ereignisse zur Malware-Erkennung
  5. Klicken Sie auf Speichern.

eStreamer-Client erstellen

  1. Klicken Sie auf der Seite eStreamer auf Create Client (Client erstellen).
  2. Geben Sie die folgenden Konfigurationsdetails an:
    • Hostname: Geben Sie die IP-Adresse des Linux-Systems ein, auf dem der eNcore-Client ausgeführt wird.
    • Passwort: Geben Sie ein Passwort ein, um die Zertifikatsdatei zu verschlüsseln.
  3. Klicken Sie auf Speichern.
  4. Laden Sie die generierte PKCS12-Zertifikatsdatei herunter und übertragen Sie sie auf Ihr eNcore-Clientsystem.

eNcore-Befehlszeilenclient installieren und konfigurieren

  1. Laden Sie auf Ihrem Linux-System den eStreamer eNcore-CLI-Client von Cisco herunter.

  2. Entpacken Sie das eNcore-Paket:

    tar -xzf eStreamer-eNcore-*.tar.gz
cd eStreamer-eNcore-*

  3. Führen Sie das Setupscript aus:

    ./encore.sh setup

  4. Wählen Sie bei Aufforderung das Ausgabeformat für Schlüssel/Wert-Paare aus (kompatibel mit SIEM-Systemen).

  5. Geben Sie die FMC-IP-Adresse und das PKCS12-Zertifikatspasswort ein.

  6. Konfigurieren Sie die Datei estreamer.conf so, dass Syslog-Nachrichten an Ihren Bindplane-Agent ausgegeben werden:

    • Öffnen Sie die Datei estreamer.conf in einem Texteditor.
    • Suchen Sie den Abschnitt „outputters“ und konfigurieren Sie ihn so, dass Syslog an Ihren Bindplane-Agenten gesendet wird:
    {
  "handler": {
    "outputters": [
      {
        "name": "syslog",
        "adapter": "kvpair",
        "enabled": true,
        "stream": {
          "uri": "udp://BINDPLANE_AGENT_IP:5514"
        }
      }
    ]
  }
}

  7. Ersetzen Sie BINDPLANE_AGENT_IP durch die IP-Adresse Ihres Bindplane-Agents.

eNcore-Client starten

  1. Testen Sie die Verbindung im Vordergrundmodus:

    ./encore.sh foreground

  2. Starten Sie eNcore nach der Überprüfung als Hintergrunddienst:

    ./encore.sh start

UDM-Zuordnungstabelle

Logfeld UDM-Zuordnung Logik
additional_deviceInboundInterface additional.fields Zusammengeführt
additional_deviceOutboundInterface additional.fields Zusammengeführt
additional_start additional.fields Zusammengeführt
has_target extensions.auth.type Zugeordnet: true → AUTHTYPE_UNSPECIFIED
dvchost intermediary.asset.hostname Direkt zugeordnet
hostname intermediary.asset.hostname Direkt zugeordnet
dvchost intermediary.hostname Direkt zugeordnet
hostname intermediary.hostname Direkt zugeordnet
dvcpid intermediary.process.pid Direkt zugeordnet
ts metadata.event_timestamp Geparst als MMM d HH:mm:ss
has_principal metadata.event_type Zugeordnete Werte (insgesamt 5, z.B. true → NETWORK_HTTP, true → NETWORK_DNS, true → `NETW...
has_target metadata.event_type Zugeordnet: true → USER_UNCATEGORIZED
product_event_type metadata.product_event_type Direkt zugeordnet
product_name metadata.product_name Direkt zugeordnet
version metadata.product_version Direkt zugeordnet
vendor_name metadata.vendor_name Direkt zugeordnet
app network.application_protocol Direkt zugeordnet
src network.dhcp.ciaddr Direkt zugeordnet
deviceDirection network.direction Zugeordnet: 0 → INBOUND, 1 → OUTBOUND
dns_question network.dns.questions Zusammengeführt
requestClientApplication network.http.user_agent Direkt zugeordnet
ip_protocol_out network.ip_protocol Direkt zugeordnet
bytesIn network.received_bytes Direkt zugeordnet
bytesOut network.sent_bytes Direkt zugeordnet
deviceExternalId principal.asset.asset_id Direkt zugeordnet
src principal.asset.ip Zusammengeführt
src principal.ip Zusammengeführt
spt principal.port Direkt zugeordnet
security_result_action security_result.action Zusammengeführt
act security_result.action_details Direkt zugeordnet
category security_result.category Zusammengeführt
cat security_result.category_details Zusammengeführt
cs5 security_result.description Direkt zugeordnet
blockLength_label security_result.detection_fields Zusammengeführt
blockType_label security_result.detection_fields Zusammengeführt
cs1_var security_result.detection_fields Zusammengeführt
cs2_var security_result.detection_fields Zusammengeführt
cs3_var security_result.detection_fields Zusammengeführt
cs4_var security_result.detection_fields Zusammengeführt
cs5_var security_result.detection_fields Zusammengeführt
cs6_var security_result.detection_fields Zusammengeführt
suser_var security_result.detection_fields Zusammengeführt
cs6 security_result.rule_id Direkt zugeordnet
severity security_result.severity_details Direkt zugeordnet
outcome security_result.summary Direkt zugeordnet
destinationDnsDomain target.asset.hostname Direkt zugeordnet
dst target.asset.ip Zusammengeführt
fname target.file.full_path Direkt zugeordnet
fileType target.file.mime_type Direkt zugeordnet
fileHash target.file.sha256 Direkt zugeordnet
fsize target.file.size Direkt zugeordnet
destinationDnsDomain target.hostname Direkt zugeordnet
host target.hostname Direkt zugeordnet
dst target.ip Zusammengeführt
dpt target.port Direkt zugeordnet
request target.url Direkt zugeordnet
– extensions.auth.type Konstante: AUTHTYPE_UNSPECIFIED
– metadata.event_type Konstante: NETWORK_HTTP
– network.direction Konstante: INBOUND
BLOCK security_result.action Aus Änderungsprotokoll zugeordnet
SOFTWARE_PUA security_result.category Aus Änderungsprotokoll zugeordnet
NETWORK_COMMAND_AND_CONTROL security_result.category Aus Änderungsprotokoll zugeordnet
TOR_EXIT_NODE security_result.category Aus Änderungsprotokoll zugeordnet
PHISHING security_result.category Aus Änderungsprotokoll zugeordnet
NETWORK_MALICIOUS security_result.category Aus Änderungsprotokoll zugeordnet
request network.http.referral_url Aus Änderungsprotokoll zugeordnet
destinationDnsDomain network.dns.questions.name Aus Änderungsprotokoll zugeordnet
security_result.action BLOCK Aus Änderungsprotokoll zugeordnet

Änderungsprotokoll

Änderungsprotokoll für diesen Parser ansehen

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