Cisco APIC-Logs erfassen
In diesem Dokument wird beschrieben, wie Sie Cisco APIC-Logs mit Bindplane in Google Security Operations aufnehmen. Der Parser extrahiert Felder aus den im Syslog-Format formatierten Logs. 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.
Hinweise
Prüfen Sie, ob folgende Voraussetzungen erfüllt sind:
- Eine Google SecOps-Instanz
- Windows 2016 oder höher oder ein 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 die Cisco APIC-Verwaltungskonsole
Authentifizierungsdatei für die Aufnahme in Google SecOps 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
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" /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-Agent zum Erfassen von Syslog-Daten und Senden an Google SecOps konfigurieren
Konfigurationsdatei aufrufen:
- 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).
- Suchen Sie die Datei
Bearbeiten Sie die Datei
config.yaml
so: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 endpoint: malachiteingestion-pa.googleapis.com # Specify the log type that matches your Chronicle feed configuration # Commonly used: CISCO_ACI or CISCO_APIC depending on your setup log_type: 'CISCO_APIC' 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
<customer_id>
durch die tatsächliche Kunden-ID. - Aktualisieren Sie
/path/to/ingestion-authentication-file.json
auf den Pfad, in dem die Authentifizierungsdatei im Abschnitt Google SecOps-Aufnahmeauthentifizierungsdatei abrufen gespeichert wurde. - Der Wert
log_type
muss mit dem Logtyp übereinstimmen, der in der Google SecOps-Feedkonfiguration ausgewählt ist.
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 bindplane-agent
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 BindPlaneAgent && net start BindPlaneAgent
Syslog-Weiterleitung auf Cisco APIC konfigurieren
Verwaltungsvereinbarungen konfigurieren
- Melden Sie sich in der Cisco APIC-Konsole an.
- Rufen Sie Tenants > mgmt> Security Policies auf.
- Prüfen Sie, ob die Verwaltungsvereinbarungen UDP an Port 514 zulassen:
- Für die Out-of-Band-Verwaltung: Achten Sie darauf, dass der OOB-Vertrag den Port
514
fürUDP
zulässt. - Für die In-Band-Verwaltung: Prüfen Sie, ob der INB-Vertrag den Port
514
fürUDP
zulässt.
- Für die Out-of-Band-Verwaltung: Achten Sie darauf, dass der OOB-Vertrag den Port
- Erstellen oder ändern Sie bei Bedarf Filter, um den Port
UDP
514
für den ausgewählten Management-EPG zuzulassen.
Syslog-Monitoring-Zielgruppe erstellen
- Klicken Sie auf Verwaltung > Externe Datenerhebungstools > Monitoring-Ziele > Syslog.
- Klicken Sie auf das +-Zeichen, um eine Syslog-Überwachungszielgruppe zu erstellen.
- Geben Sie die folgenden Konfigurationsdetails an:
- Name: Geben Sie einen aussagekräftigen Namen ein, z. B.
Google SecOps Syslog
. - Beschreibung: Geben Sie eine Beschreibung ein (z. B.
Syslog destination for Google SecOps
). - Admin State (Administratorenstatus): Wählen Sie enabled (aktiviert) aus.
- Format: Wählen Sie aci (empfohlen) oder nxos aus.
- Name: Geben Sie einen aussagekräftigen Namen ein, z. B.
- Klicken Sie auf Weiter.
- Geben Sie im Abschnitt Syslog-Remoteziel erstellen die folgenden Konfigurationsdetails an:
- Hostname/IP: Geben Sie die IP-Adresse des BindPlane-Agents ein.
- Name: Geben Sie einen aussagekräftigen Namen für das Ziel ein.
- Admin State (Administratorenstatus): Wählen Sie enabled (aktiviert) aus.
- Schweregrad: Wählen Sie Information (oder den gewünschten Schweregrad) aus.
- Port: Geben Sie 514 ein (oder den Port, der für den BindPlane-Agent konfiguriert ist).
- EPG für die Verwaltung: Wählen Sie den entsprechenden EPG für die Verwaltung aus:
- default (Out-of-Band) für die OOB-Verwaltung
- inb-default für In-Band-Verwaltung
- Weiterleitungsstelle: Wählen Sie local7 (oder die gewünschte Einrichtung) aus.
- Klicken Sie auf OK.
- Überprüfen Sie die Konfiguration und klicken Sie auf Fertigstellen.
Syslog-Quelle für Fabric-Richtlinie konfigurieren
- Rufen Sie Fabric> Fabric Policies; Monitoring Policies auf.
- Maximieren Sie default und wählen Sie Callhome/SNMP/Syslog aus.
- Klicken Sie auf das Pluszeichen +, um eine Syslog-Quelle zu erstellen.
- Geben Sie die folgenden Konfigurationsdetails an:
- Quellname: Geben Sie einen Namen ein, z. B.
fabric-syslog-source
. - Min Severity (Mindestschweregrad): Wählen Sie information (Information) aus.
- Einbeziehen: Wählen Sie Alle auswählen aus, um Audit-Logs, Ereignisse, Fehler und Sitzungsprotokolle einzubeziehen.
- Zielgruppe: Wählen Sie die zuvor erstellte Syslog-Überwachungszielgruppe aus.
- Quellname: Geben Sie einen Namen ein, z. B.
- Klicken Sie auf Senden.
Syslog-Quelle für gemeinsame Richtlinien konfigurieren
- Rufen Sie Fabric> Fabric Policies; Monitoring Policies auf.
- Maximieren Sie common und wählen Sie Callhome/SNMP/Syslog aus.
- Klicken Sie auf +, um eine Syslog-Quelle zu erstellen.
- Geben Sie die folgenden Konfigurationsdetails an:
- Quellname: Geben Sie einen Namen ein, z. B.
common-syslog-source
. - Min Severity (Mindestschweregrad): Wählen Sie information (Information) aus.
- Einbeziehen: Wählen Sie Alle auswählen aus, um Audit-Logs, Ereignisse, Fehler und Sitzungsprotokolle einzubeziehen.
- Zielgruppe: Wählen Sie die zuvor erstellte Syslog-Überwachungszielgruppe aus.
- Quellname: Geben Sie einen Namen ein, z. B.
- Klicken Sie auf Senden.
Syslog-Quelle für Zugriffsrichtlinie konfigurieren
- Rufen Sie Fabric > Zugriffsrichtlinien > Monitoring-Richtlinien auf.
- Maximieren Sie default und wählen Sie Callhome/SNMP/Syslog aus.
- Klicken Sie auf das Pluszeichen +, um eine Syslog-Quelle zu erstellen.
- Geben Sie die folgenden Konfigurationsdetails an:
- Quellname: Geben Sie einen Namen ein, z. B.
access-syslog-source
. - Min Severity (Mindestschweregrad): Wählen Sie information (Information) aus.
- Einbeziehen: Wählen Sie Alle auswählen aus, um Audit-Logs, Ereignisse, Fehler und Sitzungsprotokolle einzubeziehen.
- Zielgruppe: Wählen Sie die zuvor erstellte Syslog-Überwachungszielgruppe aus.
- Quellname: Geben Sie einen Namen ein, z. B.
- Klicken Sie auf Senden.
Richtlinie für Systemmeldungen konfigurieren (optional)
- Rufen Sie Fabric> Fabric Policies; Monitoring Policies auf.
- Blenden Sie common > System Message Policies ein.
- Wählen Sie Richtlinie für System-Syslog-Nachrichten aus.
- Wählen Sie die Standardeinrichtung aus.
- Ändern Sie den Schweregrad in Information.
- Klicken Sie auf Aktualisieren.
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten