הסבר על תחביר החיפוש
המדריך הזה מיועד למנתחי אבטחה שרוצים להגדיר ביטויי חיפוש (ערכי נתונים, תווי בריחה, אופרטורים וכו') בעורך השאילתות של דף החיפוש ב-SIEM.
כשכותבים ביטויי חיפוש ב-YARA-L 2.0 או ב-SQL בעורך השאילתות של Google Security Operations, צריך להגדיר את הפורמט של ערכי הנתונים, האופרטורים ורצפי המילוט של המחרוזות בהתאם לסוג הנתונים המדויק של שדה היעד ב-UDM. תנאי חיפוש מורכב משם שדה UDM, אופרטור השוואה (=, !=, >, <, <=, >=) וערך נתונים בפורמט.
עיצוב ערכי נתונים לפי סוג הנתונים
הקטע הזה עוסק בנושאים הבאים:
ערכים מספריים (enums)
צריך לכתוב את ערכי ה-enum כמחרוזות טקסט באותיות רישיות שתואמות בדיוק להגדרות תקינות במילון UDM, ומוקפות במירכאות כפולות ("), כמו בדוגמה הבאה:
metadata.event_type = "NETWORK_CONNECTION" security_result.action = "BLOCK" network.ip_protocol = "TCP"
ערכים בוליאניים
שדות בוליאניים מקבלים את הערכים true או false (לא תלויי-רישיות, אין צורך במירכאות), כמו בדוגמה הבאה:
network.dns.response = true target.user.is_admin = false
מספרים שלמים וערכים מספריים
מספרים שלמים ומספרי יציאות נכתבים כספרות מילוליות ללא מירכאות כפולות, כמו בדוגמה הבאה:
target.port = 443 network.sent_bytes > 10485760
ערכים מספריים עם נקודה צפה וערכים עשרוניים
בשדות UDM מסוג float או double, מזינים מספר עשרוני או מספר שלם בלי מירכאות כפולות, כמו בדוגמה הבאה:
security_result.about.asset.vulnerabilities.cvss_base_score = 9.8
מחרוזות טקסט
ערכי טקסט רגילים חייבים להיות מוקפים במירכאות כפולות ("), כמו בדוגמה הבאה:
metadata.product_name = "Google Cloud VPC Flow Logs" target.asset.asset_id = "srv-prod-us-central1-a"
התאמה ללא תלות ברישיות (nocase)
כברירת מחדל, השוואות של מחרוזות ב-YARA-L 2.0 הן תלויות אותיות רישיות. כדי להתאים לכל שילוב של אותיות רישיות וקטנות, מוסיפים את האופרטור nocase ישירות בסוף התנאי, כמו בדוגמה הבאה:
principal.hostname != "http-server" nocase principal.user.userid = "jdoe" nocase
תווי בריחה במחרוזת (\ ו-")
אם ליטרל מחרוזת מכיל לוכסנים הפוכים או מירכאות כפולות, צריך לסמן את התווים האלה בתו בריחה באמצעות לוכסן הפוך מוביל (\\), כמו בדוגמה הבאה:
- משתמשים ב-
\\כדי להתאים לוכסן הפוך מילולי (\\). כדי להתאים למירכאות כפולות ליטרליות (
"), משתמשים ב-\".חיפוש נתיבי קבצים ב-Windows עם לוכסנים הפוכים שהתווים שלהם הוחלפו בתווי בריחה:
principal.process.file.full_path = "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe"חיפוש שורות פקודה שמכילות מירכאות כפולות מוטמעות:
target.process.command_line = "cmd.exe /c \"c:\\program files\\malicious.exe\""
ביטויים רגולריים (תחביר RE2)
כדי לחפש באמצעות ביטויים רגולריים, צריך להקיף את תבנית הביטוי הרגולרי בלוכסנים (/ /) במקום במירכאות כפולות. ב-Google SecOps נעשה שימוש במנוע הביטויים הרגולריים הסטנדרטי RE2:
התאמה לכל כתובת IP ראשית בטווח 10.x.x.x, למשל:
principal.ip = /10\..*/מחפשים את ההפעלה של PsExec עם סיומת
.exeאופציונלית, ללא תלות באותיות רישיות, כמו בדוגמה הבאה:target.process.command_line = /\bpsexec(\.exe)?\b/ nocaseהתאמה של שמות מארחים של עדכון DNS דינמי לפי תבנית ממוספרת, כמו בדוגמה הבאה:
principal.hostname = /dns-server-[0-9]+/ nocase
לוגיקה בוליאנית וסדר קדימויות של אופרטורים
אפשר לשלב כמה תנאי חיפוש באמצעות האופרטורים AND, OR ו-NOT. אפשר להשתמש בסוגריים () כדי לקבץ ביטויים באופן מפורש ולשלוט בסדר הקדימויות של ההערכה, כמו בדוגמאות הבאות:
חיפוש אירועים ספציפיים של התחברות משתמשים במארח רגיש, כמו בדוגמה הבאה:
metadata.event_type = "USER_LOGIN" AND target.hostname = "finance-db-prod"משתמשים בסוגריים כדי לבודד תנאי OR משרשראות AND, כמו בדוגמה הבאה:
metadata.event_type = "PROCESS_LAUNCH" AND principal.process.file.full_path = /winword.exe/ nocase AND (target.process.file.full_path = /cmd.exe/ OR target.process.file.full_path = /powershell.exe/)
חיפוש צמדי מפתח/ערך בשדות additional ו-labels
השדות additional ו-labels משמשים כמכלים גמישים לנתוני אירועים בהתאמה אישית ולמאפיינים של ספקים חיצוניים שלא ממופים לשדות UDM רגילים. כל רשומה מאחסנת צמד מפתח/ערך:
additionalfields: יכול להכיל כמה צמדי מפתח/ערך לכל אירוע (additional.fields["key"] = "value").labelsfields: יכול להכיל רק צמד אחד של מפתח/ערך לכל אירוע (labels["key"] = "value").
התאמה מדויקת של מפתח-ערך (field["key"] = "value")
כדי לשלוח שאילתה ישירות למפתח ספציפי ולערך המחרוזת התואם שלו, משתמשים בתחביר של סוגריים מרובעים, כמו בדוגמה הבאה:
additional.fields["pod_name"] = "kube-scheduler-prod" metadata.ingestion_labels["MetadataKeyDeletion"] = "startup-script"
ביטויים רגולריים מתקדמים והתאמת ערכים שהם לא מחרוזות בשדות additional
אם אתם צריכים לשלוח שאילתות לגבי ערכים מספריים או בוליאניים בשדות additional, או להתאים בין מפתחות וערכים באמצעות ביטויים רגולריים, השתמשו בנתיב המלא של שדה ה-protobuf:
התאמה לכל מחרוזת ערך בתוך המאגר הנוסף באמצעות ביטוי רגולרי:
additional.fields.value.string_value = /suspicious_payload_.*/ nocaseהתאמה של ערכים בוליאניים או מספריים בתוך שדות בהתאמה אישית:
additional.fields.value.bool_value = true additional.fields.value.number_value > 500חיפוש בכמה מפתחות דינמיים שתואמים לתחילית של ביטוי רגולרי:
additional.fields.key = /^myKeyNumber_.*/בודקים אם מפתח קיים בלי קשר לערך:
additional.fields["pod_name"] != ""אפשר להשתמש בביטויים רגולריים וב-
nocaseישירות עם תחביר של סוגריים מרובעים:additional.fields["pod_name"] = /br/ additional.fields["pod_name"] = bar nocaseאפשר לשלב כמה צמדי מפתח/ערך של
additional.fieldsבאמצעותAND:additional.fields["pod_name"] = "kube-scheduler" AND additional.fields["namespace"] = "kube-system"
חיפוש שדות מקובצים
שדות מקובצים הם כינויים לקבוצות של שדות UDM קשורים. אתם יכולים להשתמש בהם כדי לשלוח שאילתות לכמה שדות UDM בו-זמנית בלי להקליד כל שדה בנפרד.
בדוגמה הבאה מוצגת שאילתה שתואמת לשדות ה-UDM הנפוצים שעשויים להכיל את כתובת ה-IP שצוינה:
ip = "1.2.3.4"
אפשר להתאים שדה מקובץ באמצעות ביטוי רגולרי והאופרטור nocase. אפשר גם להשתמש ברשימות של קובצי עזר. אפשר גם להשתמש בשדות מקובצים בשילוב עם שדות UDM רגילים, כמו בדוגמה הבאה:
ip = "5.6.7.8" AND metadata.event_type = "NETWORK_CONNECTION"
סוגים של שדות UDM מקובצים
אפשר לחפש בכל שדות ה-UDM המקובצים הבאים:
| שם השדה המקובץ | שדות UDM משויכים |
|---|---|
domain |
about.administrative_domainabout.asset.network_domainnetwork.dns.questions.namenetwork.dns_domainprincipal.administrative_domainprincipal.asset.network_domaintarget.administrative_domaintarget.asset.hostnametarget.asset.network_domaintarget.hostname |
email |
intermediary.user.email_addressesnetwork.email.fromnetwork.email.toprincipal.user.email_addressessecurity_result.about.user.email_addressestarget.user.email_addresses |
file_path |
principal.file.full_pathprincipal.process.file.full_pathprincipal.process.parent_process.file.full_pathtarget.file.full_pathtarget.process.file.full_pathtarget.process.parent_process.file.full_path |
hash |
about.file.md5about.file.sha1about.file.sha256principal.process.file.md5principal.process.file.sha1principal.process.file.sha256security_result.about.file.sha256target.file.md5target.file.sha1target.file.sha256target.process.file.md5target.process.file.sha1target.process.file.sha256 |
hostname |
intermediary.hostnameobserver.hostnameprincipal.asset.hostnameprincipal.hostnamesrc.asset.hostnamesrc.hostnametarget.asset.hostnametarget.hostname |
ip |
intermediary.ipobserver.ipprincipal.artifact.ipprincipal.asset.ipprincipal.ipsrc.artifact.ipsrc.asset.ipsrc.iptarget.artifact.iptarget.asset.iptarget.ip |
namespace |
principal.namespacesrc.namespacetarget.namespace |
process_id |
principal.process.parent_process.pidprincipal.process.parent_process.product_specific_process_idprincipal.process.pidprincipal.process.product_specific_process_idtarget.process.parent_process.pidtarget.process.parent_process.product_specific_process_idtarget.process.pidtarget.process.product_specific_process_id |
user |
about.user.useridobserver.user.useridprincipal.user.user_display_nameprincipal.user.useridprincipal.user.windows_sidsrc.user.useridtarget.user.user_display_nametarget.user.useridtarget.user.windows_sid |
הוספת הערות לשאילתה
אתם יכולים להוסיף הערות בתוך עורך החיפוש כדי לתעד לוגיקה מורכבת של איתור איומים, או להשבית תנאים באופן זמני במהלך הבדיקה:
- תגובות בשורה אחת: מוסיפים שני לוכסנים (
//) לפני הטקסט של התגובה. כל מה שמופיע אחרי הלוכסנים באותה שורה לא נכלל. - הערות בלוק עם כמה שורות: תוחמים את טקסט ההערה ב-
/*וב-*/. הערות בלוק יכולות להתפרס על פני כמה שורות.
דוגמה:
metadata.event_type = "NETWORK_CONNECTION" AND
// Exclude approved corporate proxy traffic
target.ip != "192.0.2.100" AND
/* Uncomment the lines below when investigating specific lateral
movement across subnet 10.240.0.0/16 */
// principal.ip = /10.240\..*/ AND
// network.sent_bytes > 5000000
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.