איסוף יומני חומת האש של 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.
הגדרת פידים
כדי להגדיר את סוג היומן הזה:
- עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמת SIEM בלבד, עוברים אל הגדרות > פידים.
- לוחצים על הוספת פיד חדש.
- לוחצים על חבילת הפידים של Zscaler.
- מאתרים את סוג היומן הנדרש ולוחצים על הוספת פיד חדש.
מזינים ערכים לפרמטרים הבאים:
- סוג המקור: תגובה לפעולה מאתר אחר (webhook) (מומלץ)
- תו מפריד לפיצול: מזינים
\nכדי להפריד בין שורות ביומן בפורמט JSON שמופרדות בשורה חדשה (NDJSON) בבקשות webhook באצווה.
אפשרויות מתקדמות
- שם הפיד: ערך שמולא מראש ומזהה את הפיד.
- מרחב השמות של הנכס: מרחב השמות שמשויך לפיד.
- תוויות הטמעה: תוויות שנוספו לכל האירועים מהפיד הזה.
לוחצים על יצירת פיד.
למידע נוסף על הגדרת כמה פידים לסוגי יומנים שונים במשפחת המוצרים הזו, ראו הגדרת פידים לפי מוצר.
הגדרת חומת האש של Zscaler
- במסוף Zscaler Internet Access, לוחצים על Administration > Nanolog Streaming Service > Cloud NSS Feeds ואז על Add Cloud NSS Feed.
- מופיע החלון Add Cloud NSS Feed. בחלון Add Cloud NSS Feed, מזינים את הפרטים.
- מזינים שם לפיד בשדה שם הפיד.
- בקטע סוג NSS, בוחרים באפשרות NSS לחומת אש.
- כדי להפעיל או להשבית את פיד ה-NSS, בוחרים את הסטטוס מהרשימה סטטוס.
- משאירים את הערך Unlimited בתפריט הנפתח SIEM Rate. כדי להסתיר את זרם הפלט בגלל רישוי או אילוצים אחרים, משנים את הערך.
- ברשימה SIEM Type בוחרים באפשרות Other.
- ברשימה OAuth 2.0 Authentication, בוחרים באפשרות Disabled.
- בשדה גודל אצווה מקסימלי, מזינים מגבלת גודל למטען ייעודי (payload) של בקשת HTTP בודדת בהתאם לשיטה המומלצת של ה-SIEM. לדוגמה, 512KB.
מזינים את כתובת ה-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-
לוחצים על הוספת כותרת 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.
-
ברשימה Log Types, בוחרים באפשרות Firewall Logs.
ברשימה Feed Output Type (סוג פלט הפיד), בוחרים באפשרות JSON.
משביתים את האפשרות JSON Array Notation. כשהאפשרות JSON Array Notation מושבתת, חומת האש של Zscaler שולחת יומנים באצווה כאובייקטים של JSON שמופרדים באמצעות שורה חדשה (NDJSON) ומופרדים באמצעות
\n. בהגדרת הפיד של Google SecOps, מגדירים את Split delimiter לערך\nכדי שכל אובייקט JSON ינותח כרשומה ביומן נפרדת.מגדירים את תו בריחה של הפיד לערך
, \ ".כדי להוסיף שדה חדש לפורמט הפלט של הפיד, בוחרים באפשרות בהתאמה אישית ברשימה סוג הפלט של הפיד.
מעתיקים ומדביקים את פורמט הפלט של הפיד ומוסיפים שדות חדשים. חשוב לוודא ששמות המפתחות תואמים לשמות השדות בפועל.
זהו פורמט הפלט של הפיד שמוגדר כברירת מחדל:
\{ "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}"\}\}ברשימה Timezone, בוחרים את אזור הזמן של השדה Time בקובץ הפלט. כברירת מחדל, אזור הזמן מוגדר לאזור הזמן של הארגון.
בודקים את ההגדרות שנקבעו.
לוחצים על שמירה כדי לבדוק את הקישוריות. אם החיבור הצליח, מופיע סימן וי ירוק לצד ההודעה 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.
|
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.