איסוף יומנים של Palo Alto Networks Traps

נתמך ב:

במסמך הזה מוסבר איך לאסוף יומני Palo Alto Networks Traps ב-Google Security Operations באמצעות Bindplane. המנתח מטפל ביומנים בפורמטים של CSV ושל מפתח/ערך, וממיר אותם ל-UDM. הוא משתמש בניתוח של grok ו-CSV כדי לחלץ שדות, מבצע לוגיקה מותנית על סמך הודעות ספציפיות ביומן או ערכי שדות כדי למפות לשדות UDM, ומטפל בסוגי אירועים שונים כמו עדכוני סטטוס, סריקות רשת ויצירת תהליכים.

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

  • מוודאים שיש לכם מכונה של Google Security Operations.
  • חשוב לוודא שאתם משתמשים ב-Windows 2016 ואילך, או במארח Linux עם systemd.
  • אם אתם משתמשים בשרת proxy, ודאו שהיציאות של חומת האש פתוחות.
  • מוודאים שיש לכם גישה עם הרשאות ל-Cortex XDR.

קבלת פרטי כניסה ל-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

התקנת חלונות

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

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

התקנה ב-Linux

  1. פותחים טרמינל עם הרשאות root או sudo.
  2. מריצים את הפקודה הבאה:

    sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
    

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

הגדרת סוכן Bindplane להטמעת Syslog ושליחה אל Google SecOps

  1. ניגשים לקובץ התצורה:

    1. מאתרים את הקובץ config.yaml. בדרך כלל, הוא נמצא בספרייה /opt/observiq-otel-collector/ ב-Linux או בספריית ההתקנה ב-Windows.
    2. פותחים את הקובץ באמצעות כלי לעריכת טקסט (לדוגמה, nano,‏ vi או פנקס הרשימות).
  2. עורכים את הקובץ config.yaml:

    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: '/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
            ingestion_labels:
                log_type: PAN_EDR
                raw_log_field: body
    
    service:
        pipelines:
            logs/source0__chronicle_w_labels-0:
                receivers:
                    - udplog
                exporters:
                    - chronicle/chronicle_w_labels
    
  3. מחליפים את היציאה ואת כתובת ה-IP לפי הצורך בתשתית שלכם.

  4. מחליפים את <LOCATION> באזור של המופע של Google SecOps (לדוגמה, us,‏ europe או asia-southeast1). המערכת מוסיפה את הערך הזה בתחילת chronicle.googleapis.com.

  5. מחליפים את <PROJECT_NUMBER> במספר הפרויקט שמופיע בקטע IAM & Admin > Settings.

  6. מחליפים את <customer_id> במספר הלקוח בפועל.

  7. מעדכנים את /path/to/ingestion-authentication-file.json לנתיב שבו נשמר קובץ המפתח של חשבון השירות (אפשרות 1) בקטע קבלת פרטי כניסה ל-Google SecOps בשביל סוכן Bindplane.

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

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

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

  • כדי להפעיל מחדש את הסוכן של Bindplane ב-Linux, מריצים את הפקודה הבאה:

    sudo systemctl restart bindplane-agent
    
  • כדי להפעיל מחדש את הסוכן של Bindplane ב-Windows, אפשר להשתמש במסוף Services או להזין את הפקודה הבאה:

    net stop BindPlaneAgent && net start BindPlaneAgent
    

הגדרת Palo Alto Networks Traps

  1. נכנסים למסוף Cortex XDR ESM.
  2. בוחרים באפשרות הגדרות > ESM > Syslog.
  3. מסמנים את התיבה הפעלת syslog.
  4. מזינים את פרטי ההגדרה הבאים:
    • שרת Syslog: מזינים את כתובת ה-IP של סוכן Bindplane.
    • יציאת Syslog: מזינים את מספר היציאה שהוגדר ב-Bindplane, לדוגמה 514.
    • פרוטוקול Syslog: בוחרים באפשרות CEF.
    • מגדירים את Keep-alive timeout ל-0.
    • פרוטוקול תקשורת: בוחרים באפשרות UDP.
  5. בקטע אירועי אבטחה, מסמנים את התיבות הבאות:
    • אירוע מניעה
    • אירוע התראה
    • אירוע לאחר זיהוי
  6. לוחצים על בדיקת הקישוריות > שמירה.

טבלת מיפוי UDM

שדה ביומן מיפוי UDM Logic (פונקציה לוגית)
agentId event.idm.read_only_udm.additional.fields.value.string_value הערך של agentId מהיומן הגולמי ממופה לשדה string_value בתוך מבנה בתצוגת עץ מתחת ל-additional.fields. הערך של key בשדה הזה מוגדר כ-Agent ID.
agentIp event.idm.read_only_udm.target.ip הערך של agentIp מהיומן הגולמי ממופה לשדה target.ip.
cat event.idm.read_only_udm.security_result.rule_name הערך של cat מהיומן הגולמי ממופה לשדה security_result.rule_name.
class event.idm.read_only_udm.security_result.category_details משמש בשילוב עם subClass כדי לאכלס את security_result.category_details בפורמט class: subClass.
cs1 event.idm.read_only_udm.principal.application, event.idm.read_only_udm.principal.user.email_addresses אם הערך של cs1Label הוא email, והערך של cs1 הוא כתובת אימייל תקינה, הוא ממופה ל-principal.user.email_addresses. אם הערך של cs1Label הוא Initiated by, הוא ממופה ל-principal.application.
cs2 event.idm.read_only_udm.principal.process.command_line, event.idm.read_only_udm.security_result.description אם הערך של cs2Label הוא subtype, הוא ממופה ל-security_result.description. אם הערך של cs2Label הוא Initiator CMD, הוא ממופה ל-principal.process.command_line.
cs3 event.idm.read_only_udm.security_result.action_details אם הערך של cs3Label הוא result, הוא ממופה ל-security_result.action_details.
customerId event.idm.read_only_udm.additional.fields.value.string_value הערך של customerId מהיומן הגולמי ממופה לשדה string_value בתוך מבנה בתצוגת עץ מתחת ל-additional.fields. הערך של key בשדה הזה מוגדר כ-Customer ID.
date_time event.idm.read_only_udm.metadata.event_timestamp.seconds מנותח ומומר לחותמת זמן, ואז ממופה אל metadata.event_timestamp.seconds.
desc event.idm.read_only_udm.metadata.description הערך של desc מהיומן הגולמי ממופה לשדה metadata.description.
deviceName event.idm.read_only_udm.target.hostname הערך של deviceName מהיומן הגולמי ממופה לשדה target.hostname.
email_receiver event.idm.read_only_udm.network.email.to השדה נשלף מהשדה msg אם הוא מכיל כתובת אימייל, וממופה אל network.email.to.
endpoint_desc event.idm.read_only_udm.target.resource.attribute.labels.value נגזר מ-isEndpoint: Yes, host is an endpoint. אם הערך של isEndpoint הוא 1, No, host is not an endpoint אם הערך של isEndpoint הוא 0. הערך בעמודה key הוא Is Endpoint.
eventType event.idm.read_only_udm.metadata.product_event_type, event.idm.read_only_udm.metadata.event_type הערך של eventType מהיומן הגולמי ממופה לשדה metadata.product_event_type. הוא משמש גם כדי להפיק את metadata.event_type על סמך הערך שלו (לדוגמה, Management Audit Logs מוביל ל-EMAIL_TRANSACTION, XDR Analytics BIOC או Behavioral Threat מוביל ל-SCAN_NETWORK).
facility event.idm.read_only_udm.additional.fields.value.string_value הערך של facility מהיומן הגולמי ממופה לשדה string_value במבנה בתצוגת עץ ב-additional.fields. הערך של key בשדה הזה מוגדר כ-Facility.
fileHash event.idm.read_only_udm.principal.process.file.sha256 הערך של fileHash מהיומן הגולמי, שהומר לאותיות קטנות, ממופה לשדה principal.process.file.sha256.
filePath event.idm.read_only_udm.principal.process.file.full_path הערך של filePath מהיומן הגולמי ממופה לשדה principal.process.file.full_path.
friendlyName event.idm.read_only_udm.metadata.description הערך של friendlyName מהיומן הגולמי ממופה לשדה metadata.description.
interm_ip event.idm.read_only_udm.intermediary.ip הערך של interm_ip מהיומן הגולמי ממופה לשדה intermediary.ip.
isEndpoint event.idm.read_only_udm.target.resource.attribute.labels.value משמש להפקת target.resource.attribute.labels.value.
isVdi event.idm.read_only_udm.target.resource.resource_type אם הערך של isVdi הוא 1, הערך של target.resource.resource_type מוגדר כ-VIRTUAL_MACHINE.
msg event.idm.read_only_udm.security_result.summary הערך של msg מהיומן הגולמי ממופה לשדה security_result.summary. משמש גם לחילוץ email_receiver.
msgTextEn event.idm.read_only_udm.security_result.description הערך של msgTextEn מהיומן הגולמי ממופה לשדה security_result.description.
osType event.idm.read_only_udm.target.platform, event.idm.read_only_udm.target.resource.attribute.labels.value אם הערך של osType הוא 1, הערך של target.platform מוגדר כ-WINDOWS. אם הערך של osType הוא 2, הערך של target.platform מוגדר כ-MAC. אם הערך של osType הוא 4, הערך של target.platform מוגדר כ-LINUX. אם הערך של osType הוא 3, הוא ממופה ל-target.resource.attribute.labels.value עם key OS.
osVersion event.idm.read_only_udm.target.platform_version הערך של osVersion מהיומן הגולמי ממופה לשדה target.platform_version.
product_version event.idm.read_only_udm.metadata.product_version הערך של product_version מהיומן הגולמי ממופה לשדה metadata.product_version.
proto event.idm.read_only_udm.network.ip_protocol אם הערך של proto הוא udp, הערך של network.ip_protocol מוגדר כ-UDP.
recordType event.idm.read_only_udm.additional.fields.value.string_value הערך של recordType מהיומן הגולמי ממופה לשדה string_value בתוך מבנה בתצוגת עץ מתחת ל-additional.fields. הערך של key בשדה הזה מוגדר כ-Record Type.
regionId event.idm.read_only_udm.principal.location.country_or_region אם הערך של regionId הוא 10, הערך של principal.location.country_or_region מוגדר כ-Americas (N. Virginia). אם הערך של regionId הוא 70, הערך של principal.location.country_or_region מוגדר כ-EMEA (Frankfurt).
request event.idm.read_only_udm.target.url הערך של request מהיומן הגולמי ממופה לשדה target.url.
sec_category_details event.idm.read_only_udm.security_result.category_details הערך של sec_category_details מהיומן הגולמי ממופה לשדה security_result.category_details.
sec_desc event.idm.read_only_udm.security_result.description הערך של sec_desc מהיומן הגולמי ממופה לשדה security_result.description.
serverHost event.idm.read_only_udm.principal.hostname הערך של serverHost מהיומן הגולמי ממופה לשדה principal.hostname.
severity event.idm.read_only_udm.security_result.severity ממופה ל-security_result.severity לפי הלוגיקה הבאה: 2 -> CRITICAL, ‏ 3 -> ERROR, ‏ 4 -> MEDIUM, ‏ 5 -> LOW, ‏ 6 -> INFORMATIONAL.
severity_val event.idm.read_only_udm.security_result.severity, event.idm.read_only_udm.security_result.severity_details אם הערך של severity_val הוא 0, הערך של security_result.severity_details מוגדר כ-UNKNOWN_SEVERITY. אחרת, הוא ממופה ל-security_result.severity לפי הלוגיקה הבאה: 6 -> LOW, ‏ 8 -> MEDIUM, ‏ 9 -> HIGH.
shost event.idm.read_only_udm.principal.hostname הערך של shost מהיומן הגולמי ממופה לשדה principal.hostname.
src_ip event.idm.read_only_udm.principal.ip הערך של src_ip מהיומן הגולמי ממופה לשדה principal.ip.
subClass event.idm.read_only_udm.security_result.category_details משמש בשילוב עם class כדי לאכלס את security_result.category_details.
suser event.idm.read_only_udm.principal.user.user_display_name הערך של suser מהיומן הגולמי, ללא סוגריים, לוכסנים הפוכים ומירכאות בודדות, ממופה לשדה principal.user.user_display_name.
targetprocesscmd event.idm.read_only_udm.target.process.command_line הערך של targetprocesscmd מהיומן הגולמי ממופה לשדה target.process.command_line.
targetprocessname event.idm.read_only_udm.target.application הערך של targetprocessname מהיומן הגולמי ממופה לשדה target.application.
targetprocesssha256 event.idm.read_only_udm.target.process.file.sha256 הערך של targetprocesssha256 מהיומן הגולמי, שהומר לאותיות קטנות, ממופה לשדה target.process.file.sha256.
tenantname event.idm.read_only_udm.target.resource.attribute.labels.value הערך של tenantname מהיומן הגולמי ממופה לשדה value בתוך מבנה בתצוגת עץ מתחת ל-target.resource.attribute.labels. הערך של key בשדה הזה מוגדר כ-Tenant name.
event.idm.read_only_udm.metadata.event_type כברירת המחדל, מוגדר כ-STATUS_UPDATE. השתנה ל-EMAIL_TRANSACTION אם eventType הוא Management Audit Logs. הערך משתנה ל-SCAN_NETWORK אם הערך של eventType הוא XDR Analytics BIOC או Behavioral Threat, או אם הערך של desc הוא Behavioral Threat. השתנה ל-SCAN_PROCESS אם desc הוא Suspicious Process Creation. הגדרת הערך Palo Alto Networks. הגדרת הערך Cortex XDR. הגדרת הערך PAN_EDR. צריך להגדיר את הערך NETWORK_SUSPICIOUS אם הערך של eventType הוא XDR Analytics BIOC או Behavioral Threat, או אם הערך של desc הוא Behavioral Threat.

יומן שינויים

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

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