Cisco Prime-Protokolle erfassen

Parserversion: 1.0

Unterstützt in:

In diesem Dokument wird beschrieben, wie Sie Cisco Prime-Logs mit Bindplane in Google Security Operations aufnehmen. Der Parser verwendet Grok-Muster, um Felder aus verschiedenen Syslog-Nachrichtenformaten zu extrahieren und sie einem einheitlichen Datenmodell (UDM) zuzuordnen. Es verarbeitet verschiedene Logstrukturen, einschließlich Schlüssel/Wert-Paaren, und reichert die Daten mit Nutzer-, Hauptkonto-, Ziel- und Sicherheitsinformationen an, die auf bestimmten Schlüsselwörtern und Mustern in den Logeinträgen basieren.

Hinweis

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

  • Google SecOps-Instanz
  • Windows 2016 oder höher oder ein Linux-Host mit systemd
  • Wenn Sie hinter einem Proxy arbeiten, müssen die Firewallports geöffnet sein.
  • Privilegierter Zugriff auf Cisco Prime

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 der Installationsanleitung.

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

  1. 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, 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: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: <customer_id>
            endpoint: chronicle.googleapis.com
            # Add optional ingestion labels for better organization
            log_type: 'CISCO_PRIME'
            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 <customer_id> durch die tatsächliche Kundennummer.
    • Aktualisieren Sie /path/to/ingestion-authentication-file.json auf den Pfad, unter dem die Dienstkontoschlüsseldatei (Option 1) im Abschnitt Google SecOps-Anmeldedaten für den Bindplane-Agenten abrufen 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: <customer_id>
            endpoint: malachiteingestion-pa.googleapis.com
            # Add optional ingestion labels for better organization
            log_type: 'CISCO_PRIME'
            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 bindplane-agent
    
  • Wenn 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 BindPlaneAgent && net start BindPlaneAgent
    

Benachrichtigungen zu Änderungsprüfungen und Syslog-Empfänger konfigurieren

  1. Sie können das System so konfigurieren, dass Syslog-Benachrichtigungen für Änderungsprüfungen im Zusammenhang mit den folgenden Ereignissen gesendet werden:

    • Aktualisierungen des Gerätebestands
    • Konfigurationsänderungen
    • Änderungen an Konfigurationsvorlagen
    • Vorlagenbezogene Vorgänge
    • Nutzeraktivitäten wie Anmeldungen, Abmeldungen und Kontoänderungen
  2. Melden Sie sich in der Web-UI von Cisco Prime an.

  3. Gehen Sie zu Administration > Settings > System Settings.

  4. Wählen Sie E-Mail und Benachrichtigung > Audit-Benachrichtigung ändern aus.

  5. Klicken Sie auf das Kästchen Benachrichtigung über Änderungsprüfung aktivieren.

  6. Klicken Sie auf den Button +, um einen Syslog-Server anzugeben.

  7. Geben Sie die folgenden Konfigurationsdetails an:

    • Geben Sie die IP-Adresse des Bindplane-Agents ein.
    • Wählen Sie das Protokoll UDP aus.
    • Geben Sie die Portnummer des Bindplane-Agents ein.
  8. Klicken Sie auf Speichern.

Weiterleitung von System-Audit-Logs als Syslog konfigurieren

  1. Melden Sie sich in der Web-UI von Cisco Prime an.
  2. Gehen Sie zu Administration > Settings > Logging > Syslog Logging Options.
  3. Klicken Sie auf das Kästchen Syslog aktivieren.
  4. Geben Sie die folgenden Konfigurationsdetails an:
    • Geben Sie die IP-Adresse des Bindplane-Agents ein.
    • Wählen Sie das Protokoll UDP aus.
    • Geben Sie die Portnummer des Bindplane-Agents ein.
    • Wählen Sie eine der acht Einrichtungen oder local0 aus.
  5. Klicken Sie auf Speichern.

UDM-Zuordnungstabelle

Logfeld UDM-Zuordnung Logik
client_ip_address principal.ip, principal.asset.ip Der Wert wird aus dem Feld client_ip_address übernommen, das mithilfe des kv-Filters aus dem Rohlog extrahiert wird.
date metadata.event_timestamp Der Wert wird aus dem Feld date übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert und dann mit dem Datumsfilter in einen Zeitstempel konvertiert wird.
Beschreibung security_result.description Der Wert wird aus dem Feld description übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
dest_mac target.mac Der Wert wird aus dem Feld dest_mac übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert und in Kleinbuchstaben umgewandelt wird.
device_id principal.asset_id Der Wert wird aus dem Feld device_id übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird. Der endgültige Wert wird als „Geräte-ID:“ formatiert.
device_ip principal.ip, principal.asset.ip Der Wert wird aus dem Feld device_ip übernommen, das mithilfe des kv-Filters aus dem Rohlog extrahiert wird. Der Wert wird dann als JSON-Array geparst und jede IP-Adresse im Array wird den UDM-Feldern hinzugefügt.
device_type target.resource.attribute.labels.value Der Wert wird aus dem Feld device_type übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
dst_user target.user.userid Der Wert wird aus dem Feld dst_user übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
E-Mail src.hostname Der Wert wird aus dem Feld email übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
file_path principal.process.file.full_path Der Wert wird aus dem Feld file_path übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
Hostname target.resource.attribute.labels.value Der Wert wird aus dem Feld hostname übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
id principal.asset_id Der Wert wird aus dem Feld id übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird. Der endgültige Wert wird als „Entitäts-ID:“ formatiert.
ip_address principal.ip, principal.asset.ip Der Wert wird aus dem Feld ip_address übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
log_level security_result.severity Der Wert wird aus dem Feld log_level übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird. Er wird verwendet, um den Schweregrad zu bestimmen, wenn severity nicht vorhanden ist.
mac_address principal.mac, source_mac Der Wert wird aus dem Feld mac_address übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert und in Kleinbuchstaben umgewandelt wird. Er wird auch als Wert für source_mac verwendet, wenn source_mac leer ist.
oid principal.asset.product_object_id Der Wert wird aus dem Feld oid übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
principal_ip principal.ip, principal.asset.ip Der Wert wird aus dem Feld principal_ip übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
principal_port principal.port Der Wert wird aus dem Feld principal_port übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert und in eine Ganzzahl umgewandelt wird.
process_name principal.resource.name Der Wert wird aus dem Feld process_name übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
sec_description security_result.description Der Wert wird aus dem Feld sec_description übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
session_id network.session_id Der Wert wird aus dem Feld session_id übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
die Ausprägung security_result.severity Der Wert wird aus dem Feld severity übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird. Er wird verwendet, um den Schweregrad zu bestimmen, falls vorhanden.
source_mac principal.mac Der Wert wird aus dem Feld source_mac übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert und in Kleinbuchstaben umgewandelt wird. Wenn leer, wird der Wert von mac_address verwendet.
Zusammenfassung security_result.summary Der Wert wird aus dem Feld summary übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
target_ip target.ip, target.asset.ip Der Wert wird aus dem Feld target_ip übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
thread_pool metadata.product_event_type Der Wert wird aus dem Feld thread_pool übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
timestamp metadata.event_timestamp Der Wert wird aus dem Feld timestamp übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert und dann mit dem Datumsfilter in einen Zeitstempel konvertiert wird.
Typ metadata.product_event_type Der Wert wird aus dem Feld Type übernommen, das mithilfe des kv-Filters aus dem Rohlog extrahiert wird.
user_name principal.user.userid Der Wert wird aus dem Feld user_name übernommen, das mithilfe von Grok-Mustern oder KV-Filtern aus dem Rohlog extrahiert wird.
metadata.event_type metadata.event_type Der Wert wird anhand des Vorhandenseins bestimmter Felder und Muster im Rohlog bestimmt. Die Logik umfasst:
 – Standardwert: GENERIC_EVENT
 – Wenn thread_pool „EmailAlertHelper“ ist: EMAIL_TRANSACTION
 – Wenn application_name „aesSystem“ ist und desc „HealthMonitorHelper“ enthält: STATUS_HEARTBEAT
 – Wenn user_present und target_resource_present beide „true“ sind: USER_RESOURCE_ACCESS
 – Wenn user_present „true“ ist: USER_UNCATEGORIZED
 – Wenn principal_present und target_present beide „true“ sind: NETWORK_CONNECTION
 – Wenn principal_present „true“ ist: STATUS_UPDATE
 – Wenn dst_user vorhanden ist und description „logout“ enthält: USER_LOGOUT
 – Wenn dst_user vorhanden ist und description nicht „logout“ enthält: USER_LOGIN
metadata.vendor_name metadata.vendor_name Der Wert wird auf „CISCO“ festgelegt.
metadata.product_name metadata.product_name Der Wert wird auf „CISCO_PRIME“ festgelegt.
metadata.log_type metadata.log_type Der Wert wird auf „CISCO_PRIME“ festgelegt.
network.session_id network.session_id Der Wert wird aus dem Feld session_id übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
principal.application principal.application Der Wert wird aus dem Feld application_name übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
principal.asset.ip principal.asset.ip Der Wert kann aus den folgenden Feldern stammen: client_ip_address, device_ip, ip_address, principal_ip, target_ip.
principal.asset.product_object_id principal.asset.product_object_id Der Wert wird aus dem Feld oid übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
principal.asset_id principal.asset_id Der Wert kann aus den folgenden Feldern stammen: device_id, id.
principal.ip principal.ip Der Wert kann aus den folgenden Feldern stammen: client_ip_address, device_ip, ip_address, principal_ip.
principal.mac principal.mac Der Wert kann aus den folgenden Feldern stammen: mac_address, source_mac.
principal.port principal.port Der Wert wird aus dem Feld principal_port übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert und in eine Ganzzahl umgewandelt wird.
principal.process.file.full_path principal.process.file.full_path Der Wert wird aus dem Feld file_path übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
principal.resource.name principal.resource.name Der Wert wird aus dem Feld process_name übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
principal.user.userid principal.user.userid Der Wert wird aus dem Feld user_name übernommen, das mithilfe von Grok-Mustern oder KV-Filtern aus dem Rohlog extrahiert wird.
security_result.action security_result.action Der Wert wird auf „BLOCK“ gesetzt, wenn description „fail“ enthält.
security_result.description security_result.description Der Wert kann aus den folgenden Feldern stammen: desc, description, sec_description.
security_result.severity security_result.severity Der Wert kann aus den folgenden Feldern stammen: log_level, severity.
security_result.summary security_result.summary Der Wert wird aus dem Feld summary übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
src.hostname src.hostname Der Wert wird aus dem Feld email übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
target.asset.ip target.asset.ip Der Wert wird aus dem Feld target_ip übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
target.ip target.ip Der Wert wird aus dem Feld target_ip übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
target.mac target.mac Der Wert wird aus dem Feld dest_mac übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert und in Kleinbuchstaben umgewandelt wird.
target.resource.attribute.labels.key target.resource.attribute.labels.key Der Wert wird je nach Kontext auf „Gerätetyp“ oder „Geräte-Hostname“ festgelegt.
target.resource.attribute.labels.value target.resource.attribute.labels.value Der Wert kann aus den folgenden Feldern stammen: device_type, hostname.
target.user.userid target.user.userid Der Wert wird aus dem Feld dst_user übernommen, das mithilfe von Grok-Mustern aus dem Rohlog extrahiert wird.
extensions.auth.mechanism extensions.auth.mechanism Der Wert wird auf „USERNAME_PASSWORD“ gesetzt, wenn dst_user vorhanden ist und description „password“ enthält.
extensions.auth.type extensions.auth.type Der Wert wird auf „MACHINE“ gesetzt, wenn dst_user vorhanden ist.
ts event.idm.read_only_udm.metadata.event_timestamp Aus Änderungsprotokoll zugeordnet
principal_hostname event.idm.read_only_udm.principal.hostname Aus Änderungsprotokoll zugeordnet
target_hostname event.idm.read_only_udm.target.hostname Aus Änderungsprotokoll zugeordnet
target_port event.idm.read_only_udm.target.port Aus Änderungsprotokoll zugeordnet
device_hostname target.resource.attribute.labels Aus Änderungsprotokoll zugeordnet

Änderungsprotokoll

Änderungsprotokoll für diesen Parser ansehen

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