איסוף יומני חומת האש של Zscaler

נתמכים ב:

במאמר הזה מוסבר איך לייצא את יומני חומת האש של Zscaler על ידי הגדרת פיד של Google Security Operations, ואיך שדות היומן ממפים לשדות של מודל הנתונים המאוחד (UDM) של Google SecOps.

מידע נוסף זמין במאמר סקירה כללית על הטמעת נתונים ב-Google SecOps.

פריסה אופיינית כוללת את חומת האש של Zscaler ואת פיד ה-Webhook של Google SecOps, שמוגדר לשלוח יומנים אל Google SecOps. כל פריסה של לקוח יכולה להיות שונה ומורכבת יותר.

הפריסה כוללת את הרכיבים הבאים:

  • ‫Zscaler Firewall: הפלטפורמה שממנה אתם אוספים יומנים.

  • פיד Google SecOps: הפיד של Google SecOps שמאחזר יומנים מחומת האש של Zscaler וכותב יומנים ב-Google SecOps.

  • ‫Google SecOps: שומרת את היומנים ומנתחת אותם.

תווית הטמעה מזהה את המנתח שמנרמל נתוני יומן גולמיים לפורמט UDM מובנה. המידע במסמך הזה רלוונטי למנתח עם תווית ההטמעה ZSCALER_FIREWALL.

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

ודאו שהדרישות המוקדמות הבאות מתקיימות:

  • גישה למסוף Zscaler Internet Access. מידע נוסף זמין במאמר Secure Internet and SaaS Access ZIA Help.
  • ‫Zscaler Firewall מגרסה 2024 ואילך
  • כל המערכות בארכיטקטורת הפריסה מוגדרות לאזור הזמן UTC.
  • מפתח ה-API שנדרש כדי להשלים את הגדרת הפיד ב-Google Security Operations. מידע נוסף זמין במאמר הגדרת מפתחות API.

הגדרת פידים

כדי להגדיר את סוג היומן הזה:

  1. עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמת SIEM בלבד, עוברים אל הגדרות > פידים.
  2. לוחצים על הוספת פיד חדש.
  3. לוחצים על חבילת הפידים של Zscaler.
  4. מאתרים את סוג היומן הנדרש ולוחצים על הוספת פיד חדש.
  5. מזינים ערכים לפרמטרים הבאים:

    • סוג המקור: תגובה לפעולה מאתר אחר (webhook) (מומלץ)
    • תו מפריד לפיצול: מזינים \n כדי להפריד בין שורות ביומן בפורמט JSON שמופרדות בשורה חדשה (NDJSON) בבקשות webhook באצווה.

    אפשרויות מתקדמות

    • שם הפיד: ערך שמולא מראש ומזהה את הפיד.
    • מרחב השמות של הנכס: מרחב השמות שמשויך לפיד.
    • תוויות הטמעה: תוויות שנוספו לכל האירועים מהפיד הזה.
  6. לוחצים על יצירת פיד.

למידע נוסף על הגדרת כמה פידים לסוגי יומנים שונים במשפחת המוצרים הזו, ראו הגדרת פידים לפי מוצר.

הגדרת חומת האש של Zscaler

  1. במסוף Zscaler Internet Access, לוחצים על Administration > Nanolog Streaming Service > Cloud NSS Feeds ואז על Add Cloud NSS Feed.
  2. מופיע החלון Add Cloud NSS Feed. בחלון Add Cloud NSS Feed, מזינים את הפרטים.
  3. מזינים שם לפיד בשדה שם הפיד.
  4. בקטע סוג NSS, בוחרים באפשרות NSS לחומת אש.
  5. כדי להפעיל או להשבית את פיד ה-NSS, בוחרים את הסטטוס מהרשימה סטטוס.
  6. משאירים את הערך Unlimited בתפריט הנפתח SIEM Rate. כדי להסתיר את זרם הפלט בגלל רישוי או אילוצים אחרים, משנים את הערך.
  7. ברשימה SIEM Type בוחרים באפשרות Other.
  8. ברשימה OAuth 2.0 Authentication, בוחרים באפשרות Disabled.
  9. בשדה גודל אצווה מקסימלי, מזינים מגבלת גודל למטען ייעודי (payload) של בקשת HTTP בודדת בהתאם לשיטה המומלצת של ה-SIEM. לדוגמה, 512KB.
  10. מזינים את כתובת ה-URL מסוג HTTPS של נקודת קצה ל-API של Chronicle בכתובת ה-URL של ה-API בפורמט הבא:

      https://<CHRONICLE_REGION>-chronicle.googleapis.com/v1alpha/projects/<GOOGLE_PROJECT_NUMBER>/locations/<LOCATION>/instances/<CUSTOMER_ID>/feeds/<FEED_ID>:importPushLogs
    
    • ‫CHRONICLE_REGION: האזור שבו מארחים את המכונה של Chronicle. לדוגמה, US.
    • ‫GOOGLE_PROJECT_NUMBER: מספר הפרויקט ב- Google Cloud .
    • ‫LOCATION: אזור Chronicle. לדוגמה, US.
    • ‫CUSTOMER_ID: מזהה הלקוח ב-Chronicle.
    • ‫FEED_ID: מזהה הפיד שמוצג בממשק המשתמש של הפיד ב-webhook החדש שנוצר
    • דוגמה לכתובת URL של API:
    https://us-chronicle.googleapis.com/v1alpha/projects/12345678910/locations/US/instances/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/feeds/yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy:importPushLogs
    
  11. לוחצים על הוספת כותרת HTTP ומוסיפים כותרות HTTP בפורמט הבא:

    • ‫Header 1: מפתח 1: X-goog-api-key וערך 1: מפתח API שנוצר בפרטי הכניסה ל-API של Google Cloud.
    • ‫Header 2: Key2: X-Webhook-Access-Key ו-Value2: API Secret שנוצר ב-"SECRET KEY" של ה-webhook.
  12. ברשימה Log Types, בוחרים באפשרות Firewall Logs.

  13. ברשימה Feed Output Type (סוג פלט הפיד), בוחרים באפשרות JSON.

  14. משביתים את האפשרות JSON Array Notation. כשהאפשרות JSON Array Notation מושבתת, חומת האש של Zscaler שולחת יומנים באצווה כאובייקטים של JSON שמופרדים באמצעות שורה חדשה (NDJSON) ומופרדים באמצעות \n. בהגדרת הפיד של Google SecOps, מגדירים את Split delimiter לערך \n כדי שכל אובייקט JSON ינותח כרשומה ביומן נפרדת.

  15. מגדירים את תו בריחה של הפיד לערך , \ ".

  16. כדי להוסיף שדה חדש לפורמט הפלט של הפיד, בוחרים באפשרות בהתאמה אישית ברשימה סוג הפלט של הפיד.

  17. מעתיקים ומדביקים את פורמט הפלט של הפיד ומוסיפים שדות חדשים. חשוב לוודא ששמות המפתחות תואמים לשמות השדות בפועל.

  18. זהו פורמט הפלט של הפיד שמוגדר כברירת מחדל:

      \{ "sourcetype" : "zscalernss-fw", "event" :\{"datetime":"%s{time}","user":"%s{elogin}","department":"%s{edepartment}","locationname":"%s{elocation}","cdport":"%d{cdport}","csport":"%d{csport}","sdport":"%d{sdport}","ssport":"%d{ssport}","csip":"%s{csip}","cdip":"%s{cdip}","ssip":"%s{ssip}","sdip":"%s{sdip}","tsip":"%s{tsip}","tunsport":"%d{tsport}","tuntype":"%s{ttype}","action":"%s{action}","dnat":"%s{dnat}","stateful":"%s{stateful}","aggregate":"%s{aggregate}","nwsvc":"%s{nwsvc}","nwapp":"%s{nwapp}","proto":"%s{ipproto}","ipcat":"%s{ipcat}","destcountry":"%s{destcountry}","avgduration":"%d{avgduration}","rulelabel":"%s{erulelabel}","inbytes":"%ld{inbytes}","outbytes":"%ld{outbytes}","duration":"%d{duration}","durationms":"%d{durationms}","numsessions":"%d{numsessions}","ipsrulelabel":"%s{ipsrulelabel}","threatcat":"%s{threatcat}","threatname":"%s{ethreatname}","deviceowner":"%s{deviceowner}","devicehostname":"%s{devicehostname}"\}\}
    
  19. ברשימה Timezone, בוחרים את אזור הזמן של השדה Time בקובץ הפלט. כברירת מחדל, אזור הזמן מוגדר לאזור הזמן של הארגון.

  20. בודקים את ההגדרות שנקבעו.

  21. לוחצים על שמירה כדי לבדוק את הקישוריות. אם החיבור הצליח, מופיע סימן וי ירוק לצד ההודעה Test Connectivity Successful: OK (200)‎.

מידע נוסף על פידים של Google SecOps זמין במסמכי התיעוד של פידים של Google SecOps. למידע על הדרישות של כל סוג פיד, קראו את המאמר הגדרת פיד לפי סוג.

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

פורמטים נתמכים של יומני חומת האש של Zscaler

המנתח של Zscaler Firewall תומך ביומנים בפורמט JSON.

יומנים לדוגמה של חומת האש של Zscaler שנתמכים

  • ‫JSON:

    {
      "sourcetype": "zscalernss-fw",
      "event": {
        "datetime": "Tue Apr 11 00:44:01 2023",
        "user": "abc@test.com",
        "department": "Optum%20Tech%20UHC%20Technology",
        "locationname": "Road%20Warrior",
        "cdport": "443",
        "csport": "50407",
        "sdport": "443",
        "ssport": "36223",
        "csip": "198.51.100.8",
        "cdip": "198.51.100.7",
        "ssip": "198.51.100.9",
        "sdip": "198.51.100.10",
        "tsip": "198.51.100.11",
        "tunsport": "0",
        "tuntype": "ZscalerClientConnector",
        "action": "Allow",
        "dnat": "No",
        "stateful": "Yes",
        "aggregate": "Yes",
        "nwsvc": "ZSCALER_PROXY_NW_SERVICES",
        "nwapp": "sharepoint_document",
        "proto": "TCP",
        "ipcat": "Miscellaneous or Unknown",
        "destcountry": "Other",
        "avgduration": "239296",
        "rulelabel": "Default%20Firewall%20Filtering%20Rule",
        "inbytes": "286134",
        "outbytes": "515005",
        "duration": "6461",
        "durationms": "6461000",
        "numsessions": "27",
        "ipsrulelabel": "None",
        "threatcat": "None",
        "threatname": "None",
        "deviceowner": "dummydeviceowner",
        "devicehostname": "dummyhostname"
      }
    }
    

הפניה למיפוי שדות

בטבלה הבאה מפורטים שדות היומן של סוג היומן ZSCALER_FIREWALL והשדות התואמים ב-UDM.

Log field UDM mapping Logic
fwd_gw_name intermediary.resource.name
intermediary.resource.resource_type If the fwd_gw_name log field value is not empty or the ofwd_gw_name log field value is not empty, then the intermediary.resource.resource_type UDM field is set to GATEWAY.
ofwd_gw_name intermediary.resource.name
fwd_type security_result.detection_fields[fwd_type]
ordr_rulename security_result.rule_name
rdr_rulename security_result.rule_name
rulelabel security_result.rule_name
orulelabel security_result.rule_name
erulelabel security_result.rule_name
bypass_etime metadata.collected_timestamp
datetime metadata.event_timestamp
epochtime metadata.event_timestamp
metadata.event_type If the sdport log field value is equal to 80 or the sdport log field value is equal to 443 and the csip log field value is not empty or the ocsip log field value is not empty or the devicename log field value is not empty or the odevicename log field value is not empty and the sdip log field value is not empty, then the metadata.event_type UDM field is set to NETWORK_HTTP.

Else, if the csip log field value is not empty or the ocsip log field value is not empty or the devicename log field value is not empty or the odevicename log field value is not empty and the sdip log field value is not empty, then the metadata.event_type UDM field is set to NETWORK_CONNECTION.

Else, if the csip log field value is not empty or the ocsip log field value is not empty or the devicename log field value is not empty or the odevicename log field value is not empty, then the metadata.event_type UDM field is set to STATUS_UPDATE.

Else, the metadata.event_type UDM field is set to GENERIC_EVENT.
recordid metadata.product_log_id
metadata.product_name The metadata.product_name UDM field is set to Firewall.
metadata.vendor_name The metadata.vendor_name UDM field is set to Zscaler.
proto network.ip_protocol If the proto log field value contain one of the following values, then the proto log field is mapped to the network.ip_protocol UDM field.
  • TCP
  • UDP
  • ICMP
  • GRE
  • IP6IN4
  • IGMP
inbytes network.received_bytes
outbytes network.sent_bytes
avgduration network.session_duration.nanos If the durationms log field value is empty and the avgduration log field value is not empty, then the avgduration log field is mapped to the network.session_duration.nanos UDM field.
durationms network.session_duration.nanos If the durationms log field value is not empty, then the durationms log field is mapped to the network.session_duration.nanos UDM field.
duration network.session_duration.seconds
devicename principal.asset.asset_id If the devicename log field value is not empty, then the Zscaler:devicename log field is mapped to the principal.asset.asset_id UDM field.
devicemodel principal.asset.hardware.model
devicehostname principal.asset.hostname If the devicehostname log field value is not empty, then the devicehostname log field is mapped to the principal.asset.hostname UDM field.
edevicehostname principal.asset.hostname If the edevicehostname log field value is not empty, then the edevicehostname log field is mapped to the principal.asset.hostname UDM field.
principal.asset.platform_software.platform If the deviceostype log field value matches the regular expression pattern (?i)iOS, then the principal.asset.platform_software.platform UDM field is set to IOS.

Else, if the deviceostype log field value matches the regular expression pattern (?i)Android, then the principal.asset.platform_software.platform UDM field is set to ANDROID.

Else, if the deviceostype log field value matches the regular expression pattern (?i)Windows, then the principal.asset.platform_software.platform UDM field is set to WINDOWS.

Else, if the deviceostype log field value matches the regular expression pattern (?i)MAC, then the principal.asset.platform_software.platform UDM field is set to MAC.

Else, if the deviceostype log field value matches the regular expression pattern (?i)Other, then the principal.asset.platform_software.platform UDM field is set to UNKNOWN_PLATFORM.
deviceosversion principal.asset.platform_software.platform_version
external_deviceid principal.asset.product_object_id
csip principal.ip
tsip principal.nat_ip
srcip_country principal.location.country_or_region
location principal.location.name
locationname principal.location.name
ssip intermediary.nat_ip
ssport intermediary.nat_port
csport principal.port
dept principal.user.department
department principal.user.department
login principal.user.email_addresses The login field is extracted from login log field using the Grok pattern, and the login log field is mapped to the principal.user.email_addresses UDM field.
user principal.user.email_addresses The user field is extracted from user log field using the Grok pattern, and the user log field is mapped to the principal.user.email_addresses UDM field.
deviceowner principal.asset.attribute.labels[deviceowner]
security_result.action If the action log field value matches the regular expression pattern ^Allow.*, then the security_result.action UDM field is set to ALLOW.

Else, if the action log field value matches the regular expression pattern ^Drop.* or ^Block.*, then the security_result.action UDM field is set to BLOCK.

Else, if the action log field value is equal to Reset, then the security_result.action UDM field is set to BLOCK.
action security_result.action_details
threat_severity,threat_score security_result.severity If the threat_severity log field value is one of the following: CRITICAL, HIGH, MEDIUM, LOW, NONE then, the threat_severity log field is mapped to the security_result.severity UDM field.
Else, if the threat_score log field value is equal to 0 then, the security_result.severity UDM field is set to NONE. Else, if threat_score log field value > 0 and the threat_score log field value <= 45 then, the security_result.severity UDM field is set to LOW. Else, if threat_score log field value > 45 and the threat_score log field value < 75 then, the security_result.severity UDM field is set to MEDIUM. Else, if threat_score log field value >= 75 and the threat_score log field value < 90 then, the security_result.severity UDM field is set to HIGH. Else, if threat_score log field value >= 90 and the threat_score log field value <= 100 then, the security_result.severity UDM field is set to CRITICAL.
threat_severity,threat_score security_result.severity_details If the threat_score log field value is not empty and the threat_severity log field value is not empty then, %{threat_score} - %{threat_severity} log field is mapped to the security_result.severity_details UDM field.
Else, if threat_severity log field value is not empty then, threat_severity log field is mapped to the security_result.severity_details UDM field.
Else, if threat_score log field value is not empty then, threat_score log field is mapped to the security_result.severity_details UDM field.
security_result.category If the ipcat log field value is not empty or the oipcat log field value is not empty, then the security_result.category UDM field is set to NETWORK_CATEGORIZED_CONTENT.
ipcat security_result.category_details The ipcat log field is mapped to the security_result.category_details UDM field.
threatcat security_result.category_details If the threatcat log field value is not equal to None, then the threatcat log field is mapped to the security_result.category_details UDM field.
security_result.detection_fields[bypassed_session] If the bypassed_session log field value is equal to 0, then the security_result.detection_fields.bypassed_session UDM field is set to the traffic did not bypass Zscaler Client Connector.

Else, if the bypassed_session log field value is equal to 1, then the security_result.detection_fields.bypassed_session UDM field is set to the traffic bypassed Zscaler Client Connector.
odevicehostname principal.asset.hostname If the odevicehostname log field value is not empty, then the odevicehostname log field is mapped to the principal.asset.hostname UDM field.
odevicename principal.asset.asset_id If the odevicename log field value is not empty, then the Zscaler:odevicename log field is mapped to the principal.asset.asset_id UDM field.
odeviceowner principal.asset.attribute.labels[odeviceowner]
oipcat security_result.category_details
oipsrulelabel security_result.rule_name If the oipsrulelabel log field value is not equal to None, then the oipsrulelabel log field is mapped to the security_result.rule_name UDM field.
numsessions security_result.detection_fields[numsessions]
security_result.rule_labels [ips_custom_signature] If the ips_custom_signature log field value is equal to 0, then the security_result.rule_labels.ips_custom_signature UDM field is set to non-custom IPS rule.

Else, if the ips_custom_signature log field value is equal to 1, then the security_result.rule_labels.ips_custom_signature UDM field is set to custom IPS rule.
ipsrulelabel security_result.rule_name If the ipsrulelabel log field value is not equal to None, then the ipsrulelabel log field is mapped to the security_result.rule_name UDM field.
threatname security_result.threat_name If the threatname log field value is not equal to None, then the threatname log field is mapped to the security_result.threat_name UDM field.
ethreatname security_result.threat_name If the ethreatname log field value is not equal to None, then the ethreatname log field is mapped to the security_result.threat_name UDM field.
nwapp target.application
cdfqdn target.domain.name
sdip target.ip
datacentercity target.location.city
destcountry target.location.country_or_region
datacentercountry target.location.country_or_region
datacenter target.location.name
cdip intermediary.ip
cdport intermediary.port
sdport target.port
odnatlabel target.security_result.detection_fields[odnatlabel]
dnat security_result.rule_labels[dnat]
dnatrulelabel security_result.rule_name
odnatrulelabel security_result.rule_name
aggregate additional.fields[aggregate]
day additional.fields[day]
dd additional.fields[dd]
deviceappversion principal.asset.software.version
eedone additional.fields[eedone]
flow_type additional.fields[flow_type]
hh additional.fields[hh]
mm additional.fields[mm]
mon additional.fields[mon]
mth additional.fields[mth]
nwsvc additional.fields[nwsvc]
ocsip principal.ip
ozpa_app_seg_name additional.fields[ozpa_app_seg_name]
ss additional.fields[ss]
sourcetype additional.fields[sourcetype]
stateful additional.fields[stateful]
tz additional.fields[tz]
tuntype additional.fields[traffic_forwarding_method]
tunsport additional.fields[tunsport]
yyyy additional.fields[yyyy]
zpa_app_seg_name additional.fields[zpa_app_seg_name]
ztunnelversion additional.fields[ztunnelversion]

יומן שינויים

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

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