Mengumpulkan log Windows Defender Antivirus

Didukung di:

Dokumen ini menjelaskan cara menyerap log Windows Defender Antivirus ke Google Security Operations menggunakan Bindplane.

Windows Defender Antivirus adalah mesin antimalware bawaan di Microsoft Windows yang menyediakan deteksi ancaman real-time, hasil pemindaian, dan log peristiwa perlindungan. Agen Bindplane mengumpulkan file log peristiwa Windows Defender yang diekspor langsung dari sistem file lokal.

Sebelum memulai

Pastikan Anda memiliki prasyarat berikut:

  • Instance Google SecOps
  • Windows Server 2016 atau yang lebih baru dengan dukungan layanan observiq-otel-collector
  • Jika beroperasi dari balik proxy, pastikan port firewall terbuka sesuai dengan persyaratan agen Bindplane
  • Akses administrator ke endpoint Windows yang menjalankan Windows Defender Antivirus

Mendapatkan kredensial Google SecOps untuk agen Bindplane

Untuk mengautentikasi agen Bindplane ke Google SecOps, pilih salah satu metode berikut:

  • Deployment baru: Gunakan Chronicle API (Opsi 1).
  • Deployment lama: Terus gunakan file autentikasi penyerapan (Opsi 2) hingga Ingestion API dihentikan pada 20 Juli 2027.
  1. Login ke konsolGoogle Cloud dan pilih project Google Cloud yang ditautkan ke instance Google SecOps Anda.
  2. Buka IAM & Admin > Service Accounts.
  3. Klik Create service account.
  4. Berikan detail konfigurasi berikut:
    • Service account name: Masukkan nama akun (misalnya, bindplane-ingest).
    • Service account description: Masukkan deskripsi (misalnya, Bindplane agent log ingestion).
  5. Klik Create and continue.
  6. Di bagian Grant this service account access to project, klik Select a role, lalu pilih Chronicle Editor.
  7. Klik Continue lalu klik Done.
  8. Klik akun layanan yang Anda buat, lalu buka tab Keys.
  9. Klik Add key > Create new key.
  10. Pilih JSON dan klik Create. File kunci akan didownload ke komputer Anda.
  11. Simpan file kunci sebagai ingestion-auth.json di direktori kolektor Bindplane (/opt/observiq-otel-collector/ingestion-auth.json di Linux atau C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json di Windows), atau perbarui creds_file_path di config.yaml agar sesuai dengan jalur tempat Anda menyimpannya.
  12. Buka IAM & Admin > Settings dan salin Project number. Anda akan memerlukannya untuk konfigurasi pengekspor.

Opsi 2: Mendownload file autentikasi penyerapan (lama)

  1. Login ke konsol Google SecOps.
  2. Buka Settings > Data Management > Collection Agents. Jika Anda menggunakan platform khusus SIEM, buka Settings > Collection Agents.
  3. Download file autentikasi penyerapan.
  4. Simpan file dengan aman di sistem tempat agen Bindplane akan diinstal.

Mendapatkan ID pelanggan Google SecOps

  1. Login ke konsol Google SecOps.
  2. Buka Setelan > Administrasi > Profil. Jika Anda menggunakan platform khusus SIEM, buka Settings > Profile.
  3. Salin dan simpan ID Pelanggan dari bagian Detail Organisasi.

Menginstal agen Bindplane

Instal agen Bindplane di sistem operasi Windows Anda sesuai dengan petunjuk berikut.

Penginstalan Windows

  1. Buka Command Prompt atau PowerShell sebagai administrator.
  2. Jalankan perintah berikut:

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    
  3. Tunggu hingga penginstalan selesai.

  4. Verifikasi penginstalan dengan menjalankan:

    sc query observiq-otel-collector
    

Layanan akan ditampilkan sebagai RUNNING.

Referensi penginstalan tambahan

Untuk opsi pemasangan dan pemecahan masalah tambahan, lihat Panduan pemasangan agen Bindplane.

Mengonfigurasi agen Bindplane untuk menyerap log dan mengirimkannya ke Google SecOps

Menemukan file konfigurasi

  • Windows:

    notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
    

Mengedit file konfigurasi

  • Ganti seluruh konten config.yaml dengan konfigurasi berikut:

    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
    

Parameter konfigurasi

Ganti placeholder berikut:

  • Konfigurasi penerima:

    • filelog: Jenis penerima untuk mengumpulkan file log dari disk
    • include: Daftar jalur file yang akan dipantau. Tetapkan ini ke lokasi tempat Anda mengekspor log peristiwa Windows Defender (misalnya, C:\Logs\defender-av\*.evtx)
    • start_at: Tetapkan ke beginning untuk membaca log yang ada atau end untuk hanya membaca entri baru
  • Konfigurasi pengekspor:

    • windows_defender_av: Nama deskriptif untuk pengekspor
    • creds_file_path: Jalur lengkap ke file kunci JSON akun layanan (Opsi 1):
      • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • <customer_id>: ID Pelanggan dari langkah sebelumnya
    • location: Ganti <LOCATION> dengan region instance Google SecOps Anda (misalnya, us, europe, atau asia-southeast1). Pengekspor mengawali chronicle.googleapis.com dengan nilai ini. Lihat Endpoint Regional untuk mengetahui daftar lengkapnya.
    • project: Ganti <PROJECT_NUMBER> dengan nomor project dari IAM & Admin > Settings.
    • endpoint: Tetap tetapkan ke chronicle.googleapis.com.
    • WINDOWS_DEFENDER_AV: Jenis log persis seperti yang muncul di Chronicle
    • ingestion_labels: Label opsional dalam format YAML (misalnya, env: production)
  • Konfigurasi pipeline:

    • defender_av_to_chronicle: Nama deskriptif untuk pipeline

Pengekspor API penyerapan lama

  • Jika Anda menggunakan file autentikasi penyerapan dari Opsi 2, ganti blok exporters dengan kode berikut. Tetapkan creds_file_path ke jalur ke file autentikasi penyerapan, dan jika instance Anda berada di luar AS, ganti malachiteingestion-pa.googleapis.com dengan endpoint regional Anda (misalnya, 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
    

Simpan file konfigurasi

  • Setelah mengedit, simpan file:
    • Windows: Klik File > Save

Mulai ulang agen Bindplane untuk menerapkan perubahan

Untuk memulai ulang agen Bindplane di Windows:

  1. Pilih salah satu opsi berikut:

    • Command Prompt atau PowerShell sebagai administrator:
    net stop observiq-otel-collector && net start observiq-otel-collector
    
    • Konsol layanan:
      1. Tekan Win+R, ketik services.msc, lalu tekan Enter.
      2. Cari observIQ OpenTelemetry Collector.
      3. Klik kanan, lalu pilih Restart.
  2. Pastikan layanan sedang berjalan:

    sc query observiq-otel-collector
    
  3. Periksa log untuk mengetahui error:

    type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
    

Mengonfigurasi ekspor log Windows Defender Antivirus

Log Windows Defender Antivirus disimpan di Log Peristiwa Windows di bagian Microsoft-Windows-Windows Defender/Operational. Anda perlu mengekspor log ini ke file di disk agar agen Bindplane dapat mengumpulkannya.

  1. Buat direktori untuk menyimpan file log yang diekspor:

    mkdir C:\Logs\defender-av
    
  2. Ekspor log peristiwa Windows Defender Antivirus menggunakan wevtutil:

    wevtutil epl "Microsoft-Windows-Windows Defender/Operational" C:\Logs\defender-av\defender-av.evtx
    
  3. (Opsional) Jadwalkan ekspor rutin menggunakan Windows Task Scheduler:

    $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"
    
  4. Pastikan file log yang diekspor sedang dibuat di `C:\Logs\defender-av`.

  5. Pastikan jalur include agen Bindplane di config.yaml cocok dengan direktori ekspor.

Tabel pemetaan UDM

Kolom Log Pemetaan UDM Logika
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 Digabungkan dengan peta label {key: field name, value: {string_value: field value}} jika tidak kosong
metadata.description Ditetapkan ke string deskripsi khusus peristiwa berdasarkan EventID
metadata.event_type Tetapkan ke "SCAN_HOST" jika has_principal benar, jika tidak, "GENERIC_EVENT"; "SCAN_FILE" untuk EventID 1011,1116,1117
ProviderGuid metadata.product_deployment_id Nilai dari ProviderGuid setelah menghapus {}
metadata.product_event_type Ditetapkan ke string jenis peristiwa produk khusus peristiwa berdasarkan EventID
RecordNumber metadata.product_log_id Nilai disalin langsung sebagai string
platform_version metadata.product_version Nilai disalin langsung
FWLink metadata.url_back_to_product Nilai disalin langsung
metadata.vendor_name Setel ke "Microsoft"
metadata.product_name Setel ke "Windows Defender AV"
SourceModuleType observer.application Nilai disalin langsung
Domain, _domain principal.administrative_domain Nilai dari Domain, atau _domain yang diekstrak dari Detection User menggunakan grok untuk EventID 1116,1117
Hostname principal.hostname Nilai disalin langsung
Nama Proses principal.process.file.full_path Nilai disalin langsung untuk EventID 1116,1117
ProcessID principal.process.pid Nilai disalin langsung
SourceModuleName principal.resource.name Nilai disalin langsung
AccountType principal.user.role_description Nilai disalin langsung
AccountName principal.user.user_display_name Nilai disalin langsung
User, UserID, _account principal.user.userid Nilai dari Pengguna, atau UserID jika tidak kosong, atau _account yang diekstrak dari Pengguna Deteksi menggunakan grok untuk EventID 1116,1117
SourceName security_result.about.resource.attribute.labels Digabungkan dengan peta label {key: "SourceName", value: SourceName} jika tidak kosong
security_result.action Ditetapkan ke "ALLOW" secara default; "BLOCK" untuk EventID 1116; "QUARANTINE" untuk EventID 1117
security_result.category Tetapkan ke "SOFTWARE_MALICIOUS" untuk EventID 1011,1116,1117
ActivityID security_result.detection_fields Digabungkan dengan detection_fields {key: "Activity ID", value: ActivityID} jika ActivityID tidak kosong dan bukan "-"
EventID security_result.description Tetapkan ke "EventID: %{EventID}"
Nama Ancaman security_result.rule_name Nilai disalin langsung untuk EventID 1011,1116,1117
Severity, Level, EventType security_result.severity Setel ke LOW jika Severity cocok dengan verbose|information|info, MEDIUM jika warning|error, HIGH jika critical; Severity ditetapkan dari Level (5|4 -> information, 2|3 -> warning, 1 -> critical); atau dari EventType (ERROR -> %{severity}, INFO -> "INFORMATIONAL", else severity_details)
Nama Tingkat Keparahan, tingkat keparahan security_result.severity_details Nilai dari Severity Name untuk EventID 1011,1116,1117; atau dari severity untuk EventType yang bukan ERROR atau INFO
Nama Ancaman security_result.summary Nilai disalin langsung untuk EventID 1011,1116,1117
Nama Kategori security_result.threat_name Nilai disalin langsung untuk EventID 1011,1116,1117
FWLink security_result.url_back_to_product Nilai disalin langsung untuk EventID 1011,1116,1117
Jalur target.file.full_path Nilai disalin langsung untuk EventID 1116,1117
target.hostname Tetapkan ke "" untuk EventID 1117
Jalur target.registry.registry_key Nilai disalin langsung untuk EventID 1011
EventRecordID event.idm.read_only_udm.metadata.product_log_id Dipetakan dari log perubahan
Product Version event.idm.read_only_udm.metadata.product_version Dipetakan dari log perubahan
ProviderGuid event.idm.read_only_udm.metadata.product_deployment_id Dipetakan dari log perubahan
Hostname event.idm.read_only_udm.principal.asset.hostname Dipetakan dari log perubahan
xmlns event.idm.read_only_udm.principal.url Dipetakan dari log perubahan
Threat Resource Path event.idm.read_only_udm.target.file.full_path Dipetakan dari log perubahan
Hashes event.idm.read_only_udm.target.file.sha1 Dipetakan dari log perubahan
RenderingInfoLevel event.idm.read_only_udm.security_result.severity_details Dipetakan dari log perubahan
Action Name event.idm.read_only_udm.security_result.action_details Dipetakan dari log perubahan
Detection Time event.idm.read_only_udm.security_result.first_discovered_time Dipetakan dari log perubahan
Threat ID event.idm.read_only_udm.security_result.threat_id Dipetakan dari log perubahan
Remediation User event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Status Description event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Action ID event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Additional Actions ID event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Additional Actions String event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Category ID event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Detection ID event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Engine Version event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Error Code event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Error Description event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Execution ID event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Execution Name event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Origin ID event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Origin Name event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Post Clean Status event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Pre Execution Status event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Security Intelligence Version event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Severity ID event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Source ID event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
State event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Status Code event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Type ID event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Type Name event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
Level event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
Culture event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
Keywords event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
Opcode event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
Product Name event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
Provider Name event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
RenderingInfoMessage event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
Service event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
Task event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
Version event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
Security UserID event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
EventID event.idm.read_only_udm.security_result.summary Dipetakan dari log perubahan

Log Perubahan

Melihat Log Perubahan untuk parser ini

Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.