Windows Defender Antivirus-Protokolle erfassen
In diesem Dokument wird beschrieben, wie Sie Windows Defender Antivirus-Logs mit Bindplane in Google Security Operations aufnehmen.
Windows Defender Antivirus ist die integrierte Antimalware-Engine in Microsoft Windows, die Echtzeit-Bedrohungserkennung, Scanergebnisse und Schutzereignisprotokolle bietet. Der Bindplane-Agent erfasst exportierte Windows Defender-Ereignisprotokolldateien direkt aus dem lokalen Dateisystem.
Hinweis
Prüfen Sie, ob folgende Voraussetzungen erfüllt sind:
- Eine Google SecOps-Instanz
- Windows Server 2016 oder höher mit
observiq-otel-collector-Dienstunterstützung - Wenn der Agent hinter einem Proxy ausgeführt wird, müssen die Firewallports gemäß den Anforderungen des Bindplane-Agents geöffnet sein.
- Administratorzugriff auf Windows-Endpunkte, auf denen Windows Defender Antivirus ausgeführt wird
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-Agent auf Ihrem Windows-Betriebssystem gemäß der folgenden Anleitung.
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-collector
Der Dienst sollte als RUNNING angezeigt werden.
Zusätzliche Installationsressourcen
Weitere Installationsoptionen und Informationen zur Fehlerbehebung finden Sie in der Installationsanleitung für den Bindplane-Agenten.
Bindplane-Agent so konfigurieren, dass Logs aufgenommen und an Google SecOps gesendet werden
Konfigurationsdatei suchen
Windows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
Konfigurationsdatei bearbeiten
Ersetzen Sie den gesamten Inhalt von
config.yamldurch die folgende Konfiguration:receivers: filelog: include: - C:\Logs\defender-av\*.evtx start_at: beginning exporters: chronicle/windows_defender_av: 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: 'C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json' customer_id: '<customer_id>' endpoint: chronicle.googleapis.com log_type: WINDOWS_DEFENDER_AV raw_log_field: body ingestion_labels: env: production service: pipelines: logs/defender_av_to_chronicle: receivers: - filelog exporters: - chronicle/windows_defender_av
Konfigurationsparameter
Ersetzen Sie die folgenden Platzhalter:
Empfängerkonfiguration:
filelog: Der Empfängertyp zum Erfassen von Logdateien vom Laufwerkinclude: Liste der zu überwachenden Dateipfade. Legen Sie hier den Speicherort fest, an den Sie Windows Defender-Ereignisprotokolle exportieren (z. B.C:\Logs\defender-av\*.evtx).start_at: Wird aufbeginninggesetzt, um vorhandene Logs zu lesen, oder aufend, um nur neue Einträge zu lesen.
Exporter-Konfiguration:
windows_defender_av: Aussagekräftiger Name für den Exportercreds_file_path: Vollständiger Pfad zur JSON-Schlüsseldatei des Dienstkontos (Option 1):- Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Windows:
<customer_id>: Kundennummer aus dem vorherigen Schrittlocation: 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.WINDOWS_DEFENDER_AV: Logtyp genau so, wie er in Chronicle angezeigt wirdingestion_labels: Optionale Labels im YAML-Format (z. B.env: production)
Pipeline-Konfiguration:
defender_av_to_chronicle: Aussagekräftiger Name für die Pipeline
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/windows_defender_av: compression: gzip creds_file_path: 'C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: WINDOWS_DEFENDER_AV raw_log_field: body ingestion_labels: env: production
Konfigurationsdatei speichern
- Speichern Sie die Datei nach der Bearbeitung:
- Windows: Klicken Sie auf Datei > Speichern.
Starten Sie den Bindplane-Agent neu, um die Änderungen zu übernehmen.
So starten Sie den Bindplane-Agenten unter Windows neu:
Wählen Sie eine der folgenden Optionen aus:
- Eingabeaufforderung oder PowerShell als Administrator:
net stop observiq-otel-collector && net start observiq-otel-collector- Dienstkonsole:
- 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.
- Drücken Sie
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"
Logexport für Windows Defender Antivirus konfigurieren
Windows Defender Antivirus-Logs werden im Windows-Ereignisprotokoll unter Microsoft-Windows-Windows Defender/Operational gespeichert. Sie müssen diese Logs in Dateien auf dem Laufwerk exportieren, damit der Bindplane-Agent sie erfassen kann.
Erstellen Sie ein Verzeichnis zum Speichern der exportierten Logdateien:
mkdir C:\Logs\defender-avExportieren Sie Windows Defender Antivirus-Ereignisprotokolle mit
wevtutil:wevtutil epl "Microsoft-Windows-Windows Defender/Operational" C:\Logs\defender-av\defender-av.evtxOptional: Planen Sie regelmäßige Exporte mit dem Windows-Aufgabenplanungsdienst:
$action = New-ScheduledTaskAction -Execute "wevtutil" -Argument 'epl "Microsoft-Windows-Windows Defender/Operational" C:\Logs\defender-av\defender-av.evtx /ow:true' $trigger = New-ScheduledTaskTrigger -RepetitionInterval (New-TimeSpan -Hours 1) -Once -At (Get-Date) Register-ScheduledTask -Action $action -Trigger $trigger -TaskName "ExportDefenderLogs" -Description "Export Windows Defender AV logs for Bindplane agent"Prüfen Sie, ob die exportierte Protokolldatei unter `C:\Logs\defender-av` erstellt wird.
Achten Sie darauf, dass der Pfad des Bindplane-Agents
includeinconfig.yamlmit dem Exportverzeichnis übereinstimmt.
UDM-Zuordnungstabelle
| Logfeld | UDM-Zuordnung | Logik |
|---|---|---|
| OpcodeValue, ThreadID, Channel, engine_version, security_intelligence_version, network_realtime_inspection_engine_version, network_realtime_inspection_security_intelligence_version, rtp_state, oa_state, ioav_state, bm_state, antivirus_security_intelligence_age, antispyware_security_intelligence_age, last_quick_scan_age, last_full_scan_age, antivirus_security_intelligence_creation_time, antispyware_security_intelligence_creation_time, last_quick_scan_start_time, last_quick_scan_end_time, last_quick_scan_source, last_full_scan_start_time, last_full_scan_end_time, last_full_scan_source, product_status | additional.fields | Zusammengeführt mit Labelzuordnungen {key: field name, value: {string_value: field value}}, wenn nicht leer |
| metadata.description | Auf ereignisspezifischen Beschreibungsstring basierend auf EventID festlegen | |
| metadata.event_type | Wird auf „SCAN_HOST“ gesetzt, wenn „has_principal“ „true“ ist, andernfalls auf „GENERIC_EVENT“; „SCAN_FILE“ für EventID 1011,1116,1117 | |
| ProviderGuid | metadata.product_deployment_id | Wert aus ProviderGuid nach dem Entfernen von {} |
| metadata.product_event_type | Wird basierend auf der EventID auf einen ereignisspezifischen String für den Produktereignistyp festgelegt | |
| RecordNumber | metadata.product_log_id | Wert direkt als String kopiert |
| platform_version | metadata.product_version | Wert direkt kopiert |
| FWLink | metadata.url_back_to_product | Wert direkt kopiert |
| metadata.vendor_name | Legen Sie diesen Wert auf „Microsoft“ fest. | |
| metadata.product_name | Auf „Windows Defender AV“ festgelegt | |
| SourceModuleType | observer.application | Wert direkt kopiert |
| Domain, _domain | principal.administrative_domain | Wert aus Domain oder _domain, extrahiert aus Detection User mit grok für EventID 1116,1117 |
| Hostname | principal.hostname | Wert direkt kopiert |
| Prozessname | principal.process.file.full_path | Wert direkt für EventID 1116,1117 kopiert |
| ProcessID | principal.process.pid | Wert direkt kopiert |
| SourceModuleName | principal.resource.name | Wert direkt kopiert |
| AccountType | principal.user.role_description | Wert direkt kopiert |
| AccountName | principal.user.user_display_name | Wert direkt kopiert |
| User, UserID, _account | principal.user.userid | Wert aus „User“ oder „UserID“, falls nicht leer, oder „_account“ aus „Detection User“ mit grok für EventID 1116,1117 extrahiert |
| SourceName | security_result.about.resource.attribute.labels | Zusammengeführt mit Labelzuordnung {key: „SourceName“, value: SourceName}, wenn nicht leer |
| security_result.action | Standardmäßig auf „ALLOW“ festgelegt; „BLOCK“ für EventID 1116; „QUARANTINE“ für EventID 1117 | |
| security_result.category | Für die Ereignis-IDs 1011, 1116 und 1117 auf „SOFTWARE_MALICIOUS“ festgelegt | |
| ActivityID | security_result.detection_fields | Zusammengeführt mit detection_fields {key: „Activity ID“, value: ActivityID}, wenn ActivityID nicht leer und nicht „-“ ist |
| EventID | security_result.description | Legen Sie „EventID: %{EventID}“ fest. |
| Name der Bedrohung | security_result.rule_name | Wert direkt für EventID 1011,1116,1117 kopiert |
| Severity, Level, EventType | security_result.severity | Set to LOW if Severity matches verbose|information|info, MEDIUM if warning|error, HIGH if critical; Severity set from Level (5|4 -> information, 2|3 -> warning, 1 -> critical); or from EventType (ERROR -> %{severity}, INFO -> "INFORMATIONAL", else severity_details) |
| Schweregradname, Schweregrad | security_result.severity_details | Wert aus „Severity Name“ für EventID 1011, 1116, 1117 oder aus „severity“ für EventType, der nicht ERROR oder INFO ist |
| Name der Bedrohung | security_result.summary | Wert direkt für EventID 1011,1116,1117 kopiert |
| Name der Kategorie | security_result.threat_name | Wert direkt für EventID 1011,1116,1117 kopiert |
| FWLink | security_result.url_back_to_product | Wert direkt für EventID 1011,1116,1117 kopiert |
| Pfad | target.file.full_path | Wert direkt für EventID 1116,1117 kopiert |
| target.hostname | Für EventID 1117 auf „“ festlegen | |
| Pfad | target.registry.registry_key | Wert direkt für EventID 1011 kopiert |
EventRecordID |
event.idm.read_only_udm.metadata.product_log_id |
Aus Änderungsprotokoll zugeordnet |
Product Version |
event.idm.read_only_udm.metadata.product_version |
Aus Änderungsprotokoll zugeordnet |
ProviderGuid |
event.idm.read_only_udm.metadata.product_deployment_id |
Aus Änderungsprotokoll zugeordnet |
Hostname |
event.idm.read_only_udm.principal.asset.hostname |
Aus Änderungsprotokoll zugeordnet |
xmlns |
event.idm.read_only_udm.principal.url |
Aus Änderungsprotokoll zugeordnet |
Threat Resource Path |
event.idm.read_only_udm.target.file.full_path |
Aus Änderungsprotokoll zugeordnet |
Hashes |
event.idm.read_only_udm.target.file.sha1 |
Aus Änderungsprotokoll zugeordnet |
RenderingInfoLevel |
event.idm.read_only_udm.security_result.severity_details |
Aus Änderungsprotokoll zugeordnet |
Action Name |
event.idm.read_only_udm.security_result.action_details |
Aus Änderungsprotokoll zugeordnet |
Detection Time |
event.idm.read_only_udm.security_result.first_discovered_time |
Aus Änderungsprotokoll zugeordnet |
Threat ID |
event.idm.read_only_udm.security_result.threat_id |
Aus Änderungsprotokoll zugeordnet |
Remediation User |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Status Description |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Action ID |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Additional Actions ID |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Additional Actions String |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Category ID |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Detection ID |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Engine Version |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Error Code |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Error Description |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Execution ID |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Execution Name |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Origin ID |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Origin Name |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Post Clean Status |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Pre Execution Status |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Security Intelligence Version |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Severity ID |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Source ID |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
State |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Status Code |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Type ID |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Type Name |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
Level |
event.idm.read_only_udm.additional.fields |
Aus Änderungsprotokoll zugeordnet |
Culture |
event.idm.read_only_udm.additional.fields |
Aus Änderungsprotokoll zugeordnet |
Keywords |
event.idm.read_only_udm.additional.fields |
Aus Änderungsprotokoll zugeordnet |
Opcode |
event.idm.read_only_udm.additional.fields |
Aus Änderungsprotokoll zugeordnet |
Product Name |
event.idm.read_only_udm.additional.fields |
Aus Änderungsprotokoll zugeordnet |
Provider Name |
event.idm.read_only_udm.additional.fields |
Aus Änderungsprotokoll zugeordnet |
RenderingInfoMessage |
event.idm.read_only_udm.additional.fields |
Aus Änderungsprotokoll zugeordnet |
Service |
event.idm.read_only_udm.additional.fields |
Aus Änderungsprotokoll zugeordnet |
Task |
event.idm.read_only_udm.additional.fields |
Aus Änderungsprotokoll zugeordnet |
Version |
event.idm.read_only_udm.additional.fields |
Aus Änderungsprotokoll zugeordnet |
Security UserID |
event.idm.read_only_udm.additional.fields |
Aus Änderungsprotokoll zugeordnet |
EventID |
event.idm.read_only_udm.security_result.summary |
Aus Änderungsprotokoll zugeordnet |
Änderungsprotokoll
Änderungsprotokoll für diesen Parser ansehen
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten