CommVault-Sicherungs- und Wiederherstellungslogs erfassen
In diesem Dokument wird beschrieben, wie Sie CommVault Backup and Recovery-Logs (CommCell) mit dem Bindplane-Agent in Google Security Operations aufnehmen.
CommVault CommCell generiert Syslog-Nachrichten für Benachrichtigungen, Audit-Trails und Ereignisse im Zusammenhang mit Sicherungs- und Wiederherstellungsvorgängen. Der Parser extrahiert Felder und ordnet sie dem Unified Data Model (UDM) zu.
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 - Netzwerkverbindung zwischen dem Bindplane-Agenten und dem CommVault CommCell-System
- 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 Commvault CommCell-Web-UI
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" /quietWarten Sie, bis die Installation abgeschlossen ist.
Überprüfen Sie die Installation mit folgendem Befehl:
sc query observiq-otel-collectorDer Dienst sollte als RUNNING 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-collectorDer Dienst sollte als active (running) angezeigt werden.
Zusätzliche Installationsressourcen
Weitere Installationsoptionen und Informationen zur Fehlerbehebung finden Sie in der Installationsanleitung für den Bindplane-Agenten.
Bindplane-Agent für die Aufnahme von Syslog und das Senden an Google SecOps konfigurieren
Konfigurationsdatei suchen
Linux:
sudo nano /opt/observiq-otel-collector/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/commvault_commcell: 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 creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: '<customer_id>' endpoint: chronicle.googleapis.com log_type: COMMVAULT_COMMCELL raw_log_field: body service: pipelines: logs/commvault_commcell_to_chronicle: receivers: - udplog exporters: - chronicle/commvault_commcell
Konfigurationsparameter
Ersetzen Sie die folgenden Platzhalter:
Empfängerkonfiguration:
listen_address: IP-Adresse und Port, auf dem gelauscht werden soll:0.0.0.0, um auf allen Schnittstellen zu lauschen (empfohlen)- Port
514ist der Standard-Syslog-Port (erfordert Root unter Linux; verwenden Sie1514für Nicht-Root).
Exporter-Konfiguration:
creds_file_path: Vollständiger Pfad zur JSON-Schlüsseldatei des Dienstkontos (Option 1):- Linux:
/opt/observiq-otel-collector/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
customer_id: Kundennummer, die aus der Google SecOps-Konsole kopiert wurdelocation: 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.project: Ersetzen Sie<PROJECT_NUMBER>durch die Projektnummer aus IAM & Verwaltung > Einstellungen.endpoint: Behalten Sie die Einstellungchronicle.googleapis.combei.
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/commvault_commcell: compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: COMMVAULT_COMMCELL raw_log_field: body
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
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-collectorPrüfen Sie, ob der Dienst ausgeführt wird:
```bash sudo systemctl status observiq-otel-collector ```Prüfen Sie die Logs auf Fehler:
```bash sudo journalctl -u observiq-otel-collector -f ```
Wählen Sie eine der folgenden Optionen aus, um den Bindplane-Agenten unter Windows neu zu starten:
Eingabeaufforderung oder PowerShell als Administrator:
net stop observiq-otel-collector && net start observiq-otel-collectorDienstkonsole:
- Drücken Sie
Win+R, geben Sieservices.mscein und drücken Sie die Eingabetaste. - Suchen Sie nach observIQ OpenTelemetry Collector.
- Rechtsklicken Sie und wählen Sie Neu starten aus.
Prüfen Sie, ob der Dienst ausgeführt wird:
sc query observiq-otel-collectorPrüfen Sie die Logs auf Fehler:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
- Drücken Sie
Commvault-Syslog-Server konfigurieren
- Melden Sie sich in der Web-UI von Commvault CommCell an.
- Wähle Verwalten > System aus.
- Klicken Sie auf Syslog-Server.
- Geben Sie die folgenden Details des Syslog-Servers an:
- Hostname: Geben Sie die IP-Adresse des Bindplane-Agents ein.
- Port: Geben Sie den BindPlane-Port ein, z. B.
514. - Klicken Sie auf den Schalter Aktivieren, um die Syslog-Server-Einstellung zu aktivieren.
- Wählen Sie im Feld An Syslog weiterleiten die Optionen Benachrichtigungen, Audit-Trails und Ereignisse aus.
- Klicken Sie auf Senden.
UDM-Zuordnungstabelle
| Logfeld | UDM-Zuordnung | Logik |
|---|---|---|
| AgentType | observer.application | Wird direkt aus dem Feld AgentType im Ereignisprotokoll zugeordnet. |
| Alertid | security_result.detection_fields.Alertid.value | Wird direkt aus dem Feld Alertid im Benachrichtigungslog zugeordnet. |
| Alertname | security_result.detection_fields.Alertname.value | Wird direkt aus dem Feld Alertname im Benachrichtigungslog zugeordnet. |
| Alertseverity | security_result.severity | Aus dem Feld Alertseverity im Benachrichtigungslog zugeordnet. Übersetzt in UDM-Schweregrade (INFORMATIONAL, HIGH, LOW, CRITICAL). |
| Benachrichtigungszeitpunkt | metadata.event_timestamp | Wird aus dem Feld Alerttime im Benachrichtigungslog geparst und in einen Zeitstempel konvertiert. |
| Audittime | metadata.event_timestamp | Wird aus dem Feld Audittime im Audit-Log geparst und in einen Zeitstempel konvertiert. |
| Kunde | principal.hostname, principal.asset.hostname | Wird direkt aus dem Feld Client im Ereignis-, Benachrichtigungs- oder Audit-Log zugeordnet. |
| CommCell | Dieses UDM-Feld stammt nicht aus dem Rohlog. Wenn der Wert aus der Benachrichtigungsbeschreibung extrahiert wird, wird er auf backupcv gesetzt. |
|
| Computer | Dieses UDM-Feld stammt nicht aus dem Rohlog. Er wird auf backupcv gesetzt, wenn er aus dem Ereignisprotokoll extrahiert wird. |
|
| Beschreibung | security_result.description | Wird entweder aus dem Feld Description im Ereignisprotokoll oder dem geparsten Feld event_description aus dem Feld Alertdescription im Benachrichtigungsprotokoll zugeordnet. Wenn das Feld Description den Wert A suspicious file enthält, wird es mit A suspicious file is Detected überschrieben. |
| Details | Wird verwendet, um das Feld Client mit grok zu extrahieren. |
|
| Dauer | Dieses UDM-Feld stammt nicht aus dem Rohlog. Sie wird auf die Dauer festgelegt, die aus der Terminbeschreibung extrahiert wurde. | |
| Eventid | metadata.product_log_id | Wird direkt aus dem Feld Eventid im Ereignisprotokoll zugeordnet. |
| Eventseverity | security_result.severity | Wird aus dem Feld Eventseverity im Ereignisprotokoll zugeordnet. Übersetzt in UDM-Schweregrade (INFORMATIONAL, HIGH, LOW, CRITICAL). |
| file_name | security_result.detection_fields.SuspiciousFileName.value | Wird mit Grok aus dem Feld Alertdescription im Benachrichtigungslog extrahiert. |
| Jobid | principal.process.pid | Wird direkt aus dem Feld Jobid im Ereignis- oder Benachrichtigungslog zugeordnet. |
| media_agent | security_result.detection_fields.MediaAgent.value | Wird mit Grok aus dem Feld Alertdescription im Benachrichtigungslog extrahiert. |
| no_of_files_created | security_result.detection_fields.no_of_files_created.value | Wird mit Grok aus dem Feld Alertdescription im Benachrichtigungslog extrahiert. |
| no_of_files_deleted | security_result.detection_fields.no_of_files_deleted.value | Wird mit Grok aus dem Feld Alertdescription im Benachrichtigungslog extrahiert. |
| no_of_files_modified | security_result.detection_fields.no_of_files_modified.value | Wird mit Grok aus dem Feld Alertdescription im Benachrichtigungslog extrahiert. |
| no_of_files_renamed | security_result.detection_fields.no_of_files_renamed.value | Wird mit Grok aus dem Feld Alertdescription im Benachrichtigungslog extrahiert. |
| Occurrencetime | metadata.event_timestamp | Aus dem Feld Occurrencetime im Ereignisprotokoll geparst und in einen Zeitstempel konvertiert. |
| Vorgang | security_result.detection_fields.Operation.value | Wird direkt aus dem Feld Operation im Audit-Log zugeordnet. |
| Opid | security_result.detection_fields.Opid.value | Wird direkt aus dem Feld Opid im Audit-Log zugeordnet. |
| Programm | principal.application | Wird direkt aus dem Feld Program im Ereignisprotokoll zugeordnet. |
| Schweregrad | security_result.severity | Wird aus dem Feld Severitylevel im Audit-Log zugeordnet. Übersetzt in UDM-Schweregrade (INFORMATIONAL, HIGH, LOW, CRITICAL). |
| Typ | security_result.detection_fields.Type.value | Direkt aus dem Feld Type zugeordnet, das aus dem Feld Alertdescription im Benachrichtigungslog extrahiert wurde. |
| URL | network.http.referral_url | Direkt aus dem Feld url zugeordnet, das aus dem Feld Alertdescription im Benachrichtigungslog extrahiert wurde. |
| Nutzername | principal.user.userid | Wird direkt aus dem Feld Username im Audit-Log zugeordnet. Wenn der Nutzername Administrator lautet, wird das Feld principal.user.user_role stattdessen auf ADMINISTRATOR gesetzt. |
| - | metadata.vendor_name | Dieses UDM-Feld stammt nicht aus dem Rohlog. Sie ist auf COMMVAULT festgelegt. |
| - | metadata.product_name | Dieses UDM-Feld stammt nicht aus dem Rohlog. Der Wert ist auf COMMVAULT_COMMCELL festgelegt. |
| - | metadata.log_type | Dieses UDM-Feld stammt nicht aus dem Rohlog. Der Wert ist auf COMMVAULT_COMMCELL festgelegt. |
| - | metadata.event_type | Dieses UDM-Feld stammt nicht aus dem Rohlog. Es wird auf STATUS_UPDATE gesetzt, wenn das Feld Client vorhanden ist, andernfalls auf GENERIC_EVENT. |
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten