Sophos Endpoint-Logs erfassen
In diesem Dokument wird erläutert, wie Sie Sophos Endpoint-Logs (früher Sophos AV/Intercept X) mit dem Bindplane-Agent erfassen. Der Parser wandelt JSON-Logs in ein einheitliches Datenmodell (Unified Data Model, UDM) um. Es extrahiert Felder aus verschachtelten JSON-Strukturen, ordnet sie UDM-Feldern zu und führt eine Ereigniskategorisierung basierend auf dem Feld „type“ durch. Dabei werden die Daten mit spezifischen Details und Aktionen für verschiedene Sophos AV-Ereignistypen angereichert.
Hinweis
Prüfen Sie, ob folgende Voraussetzungen erfüllt sind:
- Eine Google SecOps-Instanz
- Windows 2016 oder höher oder ein Linux-Host mit
systemd - Ein zusätzlicher Windows- oder Linux-Computer, auf dem Python kontinuierlich ausgeführt werden kann
- 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 Sophos Central Admin-Konsole
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" /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 dieser Installationsanleitung.
Bindplane-Agent für die Aufnahme von Syslog und das Senden an Google SecOps konfigurieren
- 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,vioder Notepad).
- Suchen Sie die Datei
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: 'SOPHOS_AV' raw_log_field: body ingestion_labels: service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labelsErsetzen 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,europeoderasia-southeast1). Der Exporter stellt diesem Wertchronicle.googleapis.comvoran.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.jsonauf 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
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/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: 'SOPHOS_AV' 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-agentWenn 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
Sophos Central API-Zugriff konfigurieren
- Melden Sie sich in Sophos Central Admin an.
- Wählen Sie Globale Einstellungen > API-Token-Verwaltung aus.
- Klicken Sie auf Add Token (Token hinzufügen), um ein neues Token zu erstellen.
- Geben Sie einen Tokennamen ein und klicken Sie auf Speichern. Die API-Token-Zusammenfassung für das angegebene Token wird angezeigt.
- Klicken Sie im Abschnitt API Token Summary (API-Token-Zusammenfassung) auf Copy (Kopieren), um die API-Zugriffs-URL und die Header zu kopieren.
Python auf dem zusätzlichen Computer installieren
- Öffnen Sie den Webbrowser und rufen Sie die Python-Website auf.
- Klicken Sie auf Download Python (Python herunterladen) für Ihr Betriebssystem (Windows oder Mac).
Python installieren
- Unter Windows:
- Führen Sie das Installationsprogramm aus.
- Klicken Sie das Kästchen Add Python to PATH (Python zu PATH hinzufügen) an.
- Klicken Sie auf Jetzt installieren.
Auf dem Mac:
- Python ist möglicherweise bereits installiert. Falls nicht, können Sie die aktuelle Version über das Terminal installieren.
- Öffnen Sie das Terminal und geben Sie den folgenden Befehl ein:
python --version
- Unter Windows:
Sophos-Integrationsskript herunterladen
- Rufen Sie die GitHub-Seite für das Sophos Central SIEM Integration GitHub Repository auf.
- Klicken Sie auf die grüne Schaltfläche Code > ZIP herunterladen.
- Extrahieren Sie die ZIP-Datei.
Scriptkonfiguration einrichten
- Suchen Sie die Datei
config.iniund öffnen Sie sie in einem Texteditor. - Bearbeiten Sie die Konfigurationsdatei:
- API-Token: Geben Sie den API-Schlüssel ein, den Sie zuvor aus Sophos Central kopiert haben.
- Syslog-Serverdetails: Geben Sie die Details Ihres Syslog-Servers ein.
- Host: Geben Sie die Bindplane-IP-Adresse ein.
- Port: Geben Sie die Bindplane-Portnummer ein.
- Protokoll: Geben Sie UDP ein. Je nach Einrichtung können Sie auch TCP oder TLS verwenden.
- Speichern Sie die Datei.
Skript ausführen
Wechseln Sie zum Skriptordner.
Unter Windows:
- Drücken Sie die Windows-Taste und geben Sie
cmdein. - Klicken Sie auf Eingabeaufforderung.
- Wechseln Sie zum Skriptordner:
cd C:UsersYourNameDownloadsSophos-Central-SIEM-Integration- Drücken Sie die Windows-Taste und geben Sie
Unter macOS:
- Gehen Sie zu Anwendungen > Dienstprogramme.
- Öffnen Sie das Terminal.
- Wechseln Sie zum Skriptordner:
cd /Users/YourName/Downloads/Sophos-Central-SIEM-Integration
Führen Sie das Script aus:
Geben Sie den folgenden Befehl ein, um das Skript zu starten:
python siem.py
Automatisieren Sie das Skript, damit es unter Windows kontinuierlich ausgeführt wird (mit der Aufgabenplanung):
- Öffnen Sie die Aufgabenplanung, indem Sie im Startmenü Aufgabenplanung eingeben.
- Klicken Sie auf Aufgabe erstellen.
- Auf dem Tab Allgemein:
- Geben Sie der Aufgabe einen Namen, z. B.
Sophos AV Log Export.
- Geben Sie der Aufgabe einen Namen, z. B.
- Auf dem Tab Trigger:
- Klicken Sie auf Neu und legen Sie fest, dass die Aufgabe Täglich oder Beim Start ausgeführt werden soll (je nach Ihren Anforderungen).
- Auf dem Tab Aktionen:
- Klicken Sie auf Neu und wählen Sie Programm starten aus.
- Suchen Sie nach der ausführbaren Datei
python.exe(normalerweise unterC:PythonXXpython.exe). - Geben Sie im Feld Argumente hinzufügen den Pfad zum Skript ein, z. B.
C:UsersYourNameDownloadsSophos-Central-SIEM-Integrationsiem.py.
- Klicken Sie auf OK, um die Aufgabe zu speichern.
Automatisieren Sie das Script, damit es auf dem Mac kontinuierlich ausgeführt wird (mit Cron-Jobs):
- Öffnen Sie das Terminal.
- Geben Sie
crontab -eein und drücken SieEnter. Fügen Sie am Ende der Datei eine neue Zeile hinzu:
* * * * * /usr/bin/python /Users/YourName/Downloads/Sophos-Central-SIEM-Integration/siem.pySpeichern Sie die Datei und schließen Sie den Editor.
UDM-Zuordnungstabelle
| Logfeld | UDM-Zuordnung | Logik |
|---|---|---|
s_ip |
intermediary.ip |
Zusammengeführt |
description |
metadata.description |
Direkt zugeordnet |
name |
metadata.description |
Direkt zugeordnet |
security_result.description |
metadata.description |
Umbenannt/zugeordnet |
end |
metadata.event_timestamp |
Geparst als RFC 3339 |
ts |
metadata.event_timestamp |
Geparst als RFC 3339 |
action |
metadata.event_type |
Zugeordnet: unknown → NETWORK_CONNECTION, allowed → SCAN_PROCESS, blocked → `SCAN_PROC... |
e_type |
metadata.event_type |
Zugeordnete Werte (insgesamt 11, z.B. NonCompliant → SCAN_HOST, SavDisabled → `SETTING_MODIFIC... |
type |
metadata.event_type |
Zugeordnete Werte (insgesamt 13, z.B. Event::Endpoint::NonCompliant → SCAN_HOST, `Event::Endpoin... |
e_type |
metadata.product_event_type |
Direkt zugeordnet |
type |
metadata.product_event_type |
Direkt zugeordnet |
action |
network.direction |
Zugeordnet: warned → OUTBOUND, unknown → OUTBOUND |
e_type |
network.direction |
Zugeordnet: WindowsFirewall::Blocked → OUTBOUND |
type |
network.direction |
Zugeordnet: Event::Endpoint::WindowsFirewall::Blocked → OUTBOUND |
action |
network.ip_protocol |
Zugeordnet: warned → TCP, unknown → TCP |
appSha256 |
principal.file.sha256 |
Direkt zugeordnet |
dhost |
principal.hostname |
Direkt zugeordnet |
host |
principal.hostname |
Direkt zugeordnet |
source_info.ip |
principal.ip |
Zusammengeführt |
src_ip |
principal.ip |
Zusammengeführt |
id |
principal.resource.id |
Direkt zugeordnet |
suser |
principal.user.user_display_name |
Direkt zugeordnet |
suser |
principal.user.userid |
Direkt zugeordnet |
user |
principal.user.userid |
Direkt zugeordnet |
user_id |
principal.user.userid |
Direkt zugeordnet |
endpoint_id_label |
security_result.about.labels |
Zusammengeführt |
endpoint_type_label |
security_result.about.labels |
Zusammengeführt |
action |
security_result.action |
Zugeordnete Werte (insgesamt 5, z.B. allow → sec_action, unknown → sec_action, allowed → `... |
sec_action |
security_result.action |
Zusammengeführt |
group |
security_result.category_details |
Zusammengeführt |
sub_cat |
security_result.category_details |
Zusammengeführt |
desc |
security_result.description |
Direkt zugeordnet |
e_type |
security_result.description |
Zugeordnet: (UpdateRebootRequired/ServiceNotRunning/NonCompliant/OutOfDate) → `security_result... |
type |
security_result.description |
Zugeordnet: Event::Endpoint::(UpdateRebootRequired/ServiceNotRunning/NonCompliant/OutOfDate) →... |
rule |
security_result.rule_name |
Direkt zugeordnet |
rules |
security_result.rule_name |
Direkt zugeordnet |
severity |
security_result.severity |
Zugeordnete Werte (insgesamt 6, z.B. low → LOW, low → MEDIUM, low → HIGH) |
security_result.description |
security_result.summary |
Umbenannt/zugeordnet |
application |
target.application |
Direkt zugeordnet |
endpoint_id |
target.asset_id |
Direkt zugeordnet |
f_path |
target.file.full_path |
Direkt zugeordnet |
f_size |
target.file.size |
Umbenannt/zugeordnet |
dhost |
target.hostname |
Direkt zugeordnet |
host |
target.hostname |
Direkt zugeordnet |
application |
target.process.file.full_path |
Direkt zugeordnet |
customer_id |
target.resource.id |
Direkt zugeordnet |
e_type |
target.resource.name |
Zugeordnet: SavDisabled → Real time protection, OutOfDate → Device Registration, `Regist... |
p_device |
target.resource.name |
Direkt zugeordnet |
scan_name |
target.resource.name |
Direkt zugeordnet |
type |
target.resource.name |
Zugeordnet: Event::Endpoint::SavDisabled → Real time protection, `Event::Endpoint::OutOfDate... |
action |
target.resource.type |
Zugeordnet: blocked → Device, restricted to read-only → Device |
e_type |
target.resource.type |
Zugeordnete Werte (insgesamt 5, z.B. SavDisabled → SETTING, OutOfDate → SETTING, `Registered... |
type |
target.resource.type |
Zugeordnete Werte (insgesamt 5, z.B. Event::Endpoint::SavDisabled → SETTING, `Event::Endpoint::O... |
url |
target.url |
Direkt zugeordnet |
duid |
target.user.userid |
Direkt zugeordnet |
suser |
target.user.userid |
Direkt zugeordnet |
user |
target.user.userid |
Direkt zugeordnet |
| – | metadata.event_type |
Konstante: GENERIC_EVENT |
| – | metadata.product_name |
Konstante: Sophos Anti-Virus |
| – | metadata.vendor_name |
Konstante: Sophos |
| – | network.direction |
Konstante: OUTBOUND |
| – | network.ip_protocol |
Konstante: TCP |
| – | security_result.description |
Konstante: security_result.summary |
| – | security_result.severity |
Konstante: LOW |
| – | target.resource.name |
Konstante: Real time protection |
| – | target.resource.type |
Konstante: SETTING |
Änderungsprotokoll
Änderungsprotokoll für diesen Parser ansehen
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten