איסוף יומנים של Windows Defender Antivirus

נתמך ב:

במאמר הזה מוסבר איך להטמיע ב-Google Security Operations יומנים של Windows Defender Antivirus באמצעות Bindplane.

Windows Defender Antivirus הוא מנוע מובנה להגנה מפני תוכנות זדוניות ב-Microsoft Windows, שמספק זיהוי איומים בזמן אמת, תוצאות סריקה ויומני אירועים של הגנה. סוכן Bindplane אוסף קובצי יומן אירועים של Windows Defender שיוצאו ישירות ממערכת הקבצים המקומית.

לפני שמתחילים

חשוב לוודא שיש לכם את הדברים הבאים:

  • מכונה של Google SecOps
  • ‫Windows Server 2016 ואילך עם תמיכה בשירות observiq-otel-collector
  • אם אתם משתמשים בשרת proxy, ודאו שהיציאות של חומת האש פתוחות בהתאם לדרישות של סוכן Bindplane.
  • גישת אדמין לנקודות קצה (endpoints) של Windows שפועלת בהן התוכנה Windows Defender Antivirus

קבלת פרטי כניסה ל-Google SecOps בשביל סוכן Bindplane

כדי לאמת את סוכן Bindplane ב-Google SecOps, בוחרים באחת מהשיטות הבאות:

  • פריסות חדשות: משתמשים ב-Chronicle API (אפשרות 1).
  • פריסות קודמות: ממשיכים להשתמש בקובץ האימות להטמעת נתונים (אפשרות 2) עד שה-Ingestion API יופסק ב-20 ביולי 2027.
  1. נכנסים למסוףGoogle Cloud ובוחרים את הפרויקט ב- Google Cloud שמקושר למכונה של Google SecOps.
  2. נכנסים לדף IAM & Admin > Service Accounts.
  3. לוחצים על Create service account.
  4. מזינים את פרטי ההגדרה הבאים:
    • Service account name: מזינים שם לחשבון (לדוגמה, bindplane-ingest).
    • Service account description: מזינים תיאור (לדוגמה, Bindplane agent log ingestion).
  5. לוחצים על Create and continue.
  6. בקטע Grant this service account access to project, לוחצים על Select a role ובוחרים באפשרות Chronicle Editor.
  7. לוחצים על המשך ואז על סיום.
  8. לוחצים על חשבון השירות שיצרתם ועוברים לכרטיסייה Keys.
  9. לוחצים על Add key > Create new key.
  10. בוחרים באפשרות JSON ולוחצים על Create. קובץ המפתח יורד למחשב.
  11. שומרים את קובץ המפתח בתור ingestion-auth.json בספריית Bindplane collector (/opt/observiq-otel-collector/ingestion-auth.json ב-Linux או C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json ב-Windows), או מעדכנים את creds_file_path ב-config.yaml כך שיתאים לנתיב שבו שמרתם אותו.
  12. עוברים אל IAM & Admin > Settings ומעתיקים את הערך של Project number. תצטרכו אותו כדי להגדיר את הייצוא.

אפשרות 2: הורדה של קובץ האימות להטמעת נתונים (גרסה קודמת)

  1. נכנסים למסוף Google SecOps.
  2. עוברים אל הגדרות > ניהול נתונים > סוכני איסוף. אם אתם משתמשים בפלטפורמת SIEM בלבד, עוברים אל הגדרות > סוכני איסוף.
  3. מורידים את קובץ האימות להטמעת נתונים.
  4. שומרים את הקובץ בצורה מאובטחת במערכת שבה יותקן הסוכן של Bindplane.

איך מקבלים את מספר הלקוח ב-Google SecOps

  1. נכנסים למסוף Google SecOps.
  2. עוברים אל הגדרות > ניהול > פרופיל. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פרופיל.
  3. מעתיקים את מספר הלקוח מהקטע פרטי הארגון ושומרים אותו.

התקנת הסוכן של Bindplane

מתקינים את הסוכן של Bindplane במערכת ההפעלה Windows לפי ההוראות הבאות.

התקנת חלונות

  1. פותחים את שורת הפקודה או את PowerShell כאדמין.
  2. מריצים את הפקודה הבאה:

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    
  3. מחכים שההתקנה תסתיים.

  4. כדי לוודא שההתקנה בוצעה, מריצים את הפקודה:

    sc query observiq-otel-collector
    

השירות אמור להופיע כ-RUNNING.

מקורות מידע נוספים בנושא התקנה

במדריך להתקנת הסוכן של Bindplane מפורטות אפשרויות התקנה נוספות ופתרונות לבעיות.

הגדרת סוכן Bindplane להטמעת יומנים ושליחה שלהם ל-Google SecOps

מאתרים את קובץ התצורה

  • Windows:

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

עריכת קובץ התצורה

  • מחליפים את כל התוכן של config.yaml בהגדרות הבאות:

    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
    

פרמטרים להגדרה

מחליפים את ה-placeholders הבאים:

  • הגדרת המקלט:

    • ‫filelog: סוג המקלט לאיסוף קובצי יומן מהדיסק
    • ‫include: רשימה של נתיבי קבצים למעקב. מגדירים את המיקום שאליו מייצאים את יומני האירועים של Windows Defender (לדוגמה, C:\Logs\defender-av\*.evtx)
    • ‫start_at: צריך להגדיר את הערך beginning כדי לקרוא יומנים קיימים, או את הערך end כדי לקרוא רק רשומות חדשות
  • הגדרת הייצוא:

    • ‫windows_defender_av: שם תיאורי של הייצואן
    • ‫creds_file_path: הנתיב המלא לקובץ המפתח של חשבון השירות בפורמט JSON (אפשרות 1):
      • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • ‫<customer_id>: מספר הלקוח מהשלב הקודם
    • ‫location: מחליפים את <LOCATION> באזור של המכונה של Google SecOps (לדוגמה, us,‏ europe או asia-southeast1). המייצא מוסיף את הערך הזה בתחילת chronicle.googleapis.com. לרשימה המלאה, ראו נקודות קצה אזוריות.
    • ‫project: מחליפים את <PROJECT_NUMBER> במספר הפרויקט שמופיע בקטע IAM & Admin > Settings.
    • ‫endpoint: משאירים את הערך chronicle.googleapis.com.
    • ‫WINDOWS_DEFENDER_AV: סוג היומן בדיוק כמו שהוא מופיע ב-Chronicle
    • ‫ingestion_labels: תוויות אופציונליות בפורמט YAML (לדוגמה, env: production)
  • הגדרת צינור עיבוד הנתונים:

    • ‫defender_av_to_chronicle: שם תיאורי של צינור עיבוד הנתונים

מייצא API להטמעה מדור קודם

  • אם אתם משתמשים בקובץ האימות להטמעת נתונים מאפשרות 2, החליפו את הבלוק exporters בקוד הבא. מגדירים את creds_file_path לנתיב של קובץ האימות להטמעת נתונים. אם המכונה נמצאת מחוץ לארה"ב, מחליפים את malachiteingestion-pa.googleapis.com בנקודת הקצה האזורית (לדוגמה, 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
    

שמירת קובץ התצורה

  • אחרי שמסיימים לערוך, שומרים את הקובץ:
    • Windows: לוחצים על קובץ > שמירה

מפעילים מחדש את הסוכן של Bindplane כדי להחיל את השינויים.

כדי להפעיל מחדש את הסוכן של Bindplane ב-Windows:

  1. בוחרים אחת מהאפשרויות האלה:

    • שורת הפקודה או PowerShell כאדמין:
    net stop observiq-otel-collector && net start observiq-otel-collector
    
    • מסוף השירותים:
      1. לוחצים על Win+R, מקלידים services.msc ולוחצים על Enter.
      2. מאתרים את observIQ OpenTelemetry Collector.
      3. לוחצים לחיצה ימנית ובוחרים באפשרות הפעלה מחדש.
  2. מוודאים שהשירות פועל:

    sc query observiq-otel-collector
    
  3. בודקים אם יש שגיאות ביומנים:

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

הגדרת ייצוא של יומן Windows Defender Antivirus

היומנים של Windows Defender Antivirus מאוחסנים ביומן האירועים של Windows בנתיב Microsoft-Windows-Windows Defender/Operational. צריך לייצא את היומנים האלה לקבצים בדיסק כדי שסוכן Bindplane יוכל לאסוף אותם.

  1. יוצרים ספרייה לאחסון קובצי היומן שיוצאו:

    mkdir C:\Logs\defender-av
    
  2. ייצוא של יומני האירועים של Windows Defender Antivirus באמצעות wevtutil:

    wevtutil epl "Microsoft-Windows-Windows Defender/Operational" C:\Logs\defender-av\defender-av.evtx
    
  3. (אופציונלי) תזמון ייצוא קבוע באמצעות 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. מוודאים שקובץ היומן שיוצא נוצר בנתיב `C:\Logs\defender-av`.

  5. מוודאים שהנתיב של סוכן Bindplane include ב-config.yaml תואם לספריית הייצוא.

טבלת מיפוי UDM

שדה ביומן מיפוי UDM Logic (פונקציה לוגית)
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 מוזג עם מפות תוויות {key: field name, value: {string_value: field value}} אם לא ריק
metadata.description הגדרה למחרוזת תיאור ספציפית לאירוע על סמך EventID
metadata.event_type מוגדר כ-"SCAN_HOST" אם has_principal הוא true, אחרת מוגדר כ-"GENERIC_EVENT"; מוגדר כ-"SCAN_FILE" עבור EventID 1011,1116,1117
ProviderGuid metadata.product_deployment_id הערך מ-ProviderGuid אחרי הסרת {}
metadata.product_event_type הגדרה למחרוזת של סוג אירוע ספציפי למוצר על סמך EventID
RecordNumber metadata.product_log_id הערך מועתק ישירות כמחרוזת
platform_version metadata.product_version הערך הועתק ישירות
FWLink metadata.url_back_to_product הערך הועתק ישירות
metadata.vendor_name הגדרה ל-"Microsoft"
metadata.product_name צריך להגדיר את "Windows Defender AV"
SourceModuleType observer.application הערך הועתק ישירות
דומיין, _domain principal.administrative_domain ערך מ-Domain, או ‎_domain שחולץ מ-Detection User באמצעות grok עבור EventID 1116,1117
שם המארח principal.hostname הערך הועתק ישירות
שם התהליך principal.process.file.full_path הערך הועתק ישירות עבור EventID 1116,1117
ProcessID principal.process.pid הערך הועתק ישירות
SourceModuleName principal.resource.name הערך הועתק ישירות
AccountType principal.user.role_description הערך הועתק ישירות
AccountName principal.user.user_display_name הערך הועתק ישירות
User, UserID, _account principal.user.userid הערך מ-User, או מ-UserID אם הוא לא ריק, או מ-_account שחולץ מ-Detection User באמצעות grok עבור EventID 1116,1117
SourceName security_result.about.resource.attribute.labels מוזג עם מפת התוויות {key: "SourceName", value: SourceName} אם היא לא ריקה
security_result.action ההגדרה היא "ALLOW" כברירת מחדל, "BLOCK" למזהה אירוע 1116, ו-"QUARANTINE" למזהה אירוע 1117
security_result.category צריך להגדיר את הערך SOFTWARE_MALICIOUS למזהי האירועים 1011,1116,1117
ActivityID security_result.detection_fields מוזג עם detection_fields {key: "Activity ID", value: ActivityID} אם ActivityID לא ריק ולא "-"
EventID security_result.description צריך להגדיר את הערך "EventID: %{EventID}"
שם האיום security_result.rule_name הערך הועתק ישירות למזהה האירוע 1011,1116,1117
חומרה, רמה, סוג אירוע security_result.severity צריך להגדיר את הערך LOW אם רמת החומרה תואמת ל-verbose|information|info, את הערך MEDIUM אם היא תואמת ל-warning|error, ואת הערך HIGH אם היא תואמת ל-critical. רמת החומרה מוגדרת לפי Level‏ (5|4 -> information,‏ 2|3 -> warning,‏ 1 -> critical), או לפי EventType‏ (ERROR -> %{severity},‏ INFO -> "INFORMATIONAL", אחרת severity_details)
שם רמת החומרה, רמת החומרה security_result.severity_details ערך מ-Severity Name עבור EventID 1011,1116,1117; או מ-severity עבור EventType שאינו ERROR או INFO
שם האיום security_result.summary הערך הועתק ישירות למזהה האירוע 1011,1116,1117
שם הקטגוריה security_result.threat_name הערך הועתק ישירות למזהה האירוע 1011,1116,1117
FWLink security_result.url_back_to_product הערך הועתק ישירות למזהה האירוע 1011,1116,1117
נתיב target.file.full_path הערך הועתק ישירות עבור EventID 1116,1117
target.hostname צריך להגדיר את הערך "" ל-EventID 1117
נתיב target.registry.registry_key הערך הועתק ישירות ל-EventID 1011
EventRecordID event.idm.read_only_udm.metadata.product_log_id מופה מיומן השינויים
Product Version event.idm.read_only_udm.metadata.product_version מופה מיומן השינויים
ProviderGuid event.idm.read_only_udm.metadata.product_deployment_id מופה מיומן השינויים
Hostname event.idm.read_only_udm.principal.asset.hostname מופה מיומן השינויים
xmlns event.idm.read_only_udm.principal.url מופה מיומן השינויים
Threat Resource Path event.idm.read_only_udm.target.file.full_path מופה מיומן השינויים
Hashes event.idm.read_only_udm.target.file.sha1 מופה מיומן השינויים
RenderingInfoLevel event.idm.read_only_udm.security_result.severity_details מופה מיומן השינויים
Action Name event.idm.read_only_udm.security_result.action_details מופה מיומן השינויים
Detection Time event.idm.read_only_udm.security_result.first_discovered_time מופה מיומן השינויים
Threat ID event.idm.read_only_udm.security_result.threat_id מופה מיומן השינויים
Remediation User event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Status Description event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Action ID event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Additional Actions ID event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Additional Actions String event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Category ID event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Detection ID event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Engine Version event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Error Code event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Error Description event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Execution ID event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Execution Name event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Origin ID event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Origin Name event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Post Clean Status event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Pre Execution Status event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Security Intelligence Version event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Severity ID event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Source ID event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
State event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Status Code event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Type ID event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Type Name event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
Level event.idm.read_only_udm.additional.fields מופה מיומן השינויים
Culture event.idm.read_only_udm.additional.fields מופה מיומן השינויים
Keywords event.idm.read_only_udm.additional.fields מופה מיומן השינויים
Opcode event.idm.read_only_udm.additional.fields מופה מיומן השינויים
Product Name event.idm.read_only_udm.additional.fields מופה מיומן השינויים
Provider Name event.idm.read_only_udm.additional.fields מופה מיומן השינויים
RenderingInfoMessage event.idm.read_only_udm.additional.fields מופה מיומן השינויים
Service event.idm.read_only_udm.additional.fields מופה מיומן השינויים
Task event.idm.read_only_udm.additional.fields מופה מיומן השינויים
Version event.idm.read_only_udm.additional.fields מופה מיומן השינויים
Security UserID event.idm.read_only_udm.additional.fields מופה מיומן השינויים
EventID event.idm.read_only_udm.security_result.summary מופה מיומן השינויים

יומן שינויים

הצגת יומן השינויים של המנתח הזה

הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.