איסוף יומני Sysdig
המנתח הזה מחלץ נתוני אירוע אבטחה מיומני Sysdig בפורמט JSON, וממיר וממפה את השדות של היומן הגולמי לפורמט UDM של Google Security Operations. הוא מטפל בשדות שונים, כולל מטא-נתונים, מידע על חשבון משתמש או יעד, פרטים של תוצאות אבטחה והקשר שקשור ל-Kubernetes, ומעשיר את הנתונים לניתוח ב-Google SecOps. המנתח גם מבצע המרות של סוגי נתונים, טיפול בשגיאות ולוגיקה מותנית על סמך ערכי שדות כדי להבטיח ייצוג מדויק ומקיף של UDM.
לפני שמתחילים
ודאו שאתם עומדים בדרישות המוקדמות הבאות:
- מופע של Google SecOps.
- גישה מיוחדת ל-Sysdig Secure.
יצירת מפתח API לפיד ה-Webhook
נכנסים לדף CredentialsGoogle Cloud במסוף >.
לוחצים על Create credentials ואז על מפתח API.
מגבילים את הגישה של מפתח ה-API ל-Google Security Operations API.
אפשרות 1
הגדרת פידים
כדי להגדיר פיד:
- עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פידים.
- לוחצים על הוספת פיד חדש.
- בדף הבא, לוחצים על הגדרת פיד יחיד.
- בשדה Feed name, נותנים שם לפיד, לדוגמה Sysdig Logs.
- בוחרים באפשרות Webhook בתור סוג המקור.
- בוחרים באפשרות Sysdig בתור Log type.
- לוחצים על הבא.
אופציונלי: מציינים ערכים לפרמטרים הבאים של הקלט:
- Split delimiter: התו המשמש להפרדה בין שורות ביומן, כמו
\n.
- Split delimiter: התו המשמש להפרדה בין שורות ביומן, כמו
לוחצים על הבא.
בודקים את הגדרות הפיד במסך סיום ולוחצים על שליחה.
לוחצים על יצירת מפתח סודי כדי ליצור מפתח סודי לאימות הפיד הזה.
מעתיקים את המפתח הסודי ושומרים אותו. לא תוכלו לראות שוב את המפתח הסודי הזה. במקרה הצורך, אפשר ליצור מחדש מפתח סודי, אבל הפעולה הזו מבטלת את המפתח הסודי הקודם.
בכרטיסייה פרטים, מעתיקים את כתובת ה-URL של נקודת הקצה של הפיד מהשדה פרטי נקודת הקצה. צריך לציין את כתובת ה-URL של נקודת הקצה הזו באפליקציית הלקוח.
לוחצים על סיום.
מציינים את כתובת ה-URL של נקודת הקצה
- באפליקציית הלקוח, מציינים את כתובת ה-URL של נקודת הקצה (endpoint) ב-HTTPS שסופקה בפיד ה-webhook.
כדי להפעיל את האימות, צריך לציין את מפתח ה-API ואת המפתח הסודי כחלק מהכותרת בהתאמה אישית, בפורמט הבא:
X-goog-api-key = API_KEY X-Webhook-Access-Key = SECRETהמלצה: ציינו את מפתח ה-API ככותרת במקום לציין אותו בכתובת ה-URL.
אם לקוח ה-webhook שלכם לא תומך בכותרות בהתאמה אישית, אתם יכולים לציין את מפתח ה-API ואת המפתח הסודי באמצעות פרמטרים של שאילתה בפורמט הבא:
ENDPOINT_URL?key=API_KEY&secret=SECRETמחליפים את מה שכתוב בשדות הבאים:
-
ENDPOINT_URL: כתובת ה-URL של נקודת הקצה של הפיד. -
API_KEY: מפתח ה-API לאימות ב-Google SecOps. -
SECRET: המפתח הסודי שיצרתם כדי לאמת את הפיד.
-
הגדרת Webhook ב-Sysdig
- נכנסים ל-Sysdig Secure עם הרשאות אדמין.
- עוברים אל פרופיל > הגדרות > העברת אירועים.
- לוחצים על +Add Integration (הוספת שילוב) ובוחרים באפשרות Webhook בתפריט הנפתח.
מציינים ערכים לפרמטרים הבאים של הקלט:
- Integration Name: נותנים שם תיאורי ל-webhook (לדוגמה, Google SecOps Webhook).
- נקודת קצה (endpoint): מזינים את ה-Webhook
<ENDPOINT_URL>, ואז את<API_KEYואת<SECRET>. נתונים לשליחה: בוחרים מהתפריט הנפתח את סוגי הנתונים של Sysdig שצריך להעביר.
בודקים את השילוב ומעבירים את המתג למצב מופעל כדי להפעיל אותו.
לוחצים על Save.
אפשרות 2
העברת נתונים ישירות ל-Google SecOps
- נכנסים ל-Sysdig Secure באמצעות פרטי הכניסה של האדמין.
- עוברים אל הגדרות > העברת אירועים.
- לוחצים על +Add Integration ובוחרים באפשרות Google Chronicle בתפריט הנפתח.
- מציינים ערכים לפרמטרים הבאים של הקלט:
- שם השילוב: נותנים שם תיאורי לשילוב (לדוגמה, שילוב עם Google SecOps).
- מספר לקוח: מספר הלקוח ב-Google שמשויך לחשבון Google Cloud . (ב-Google SecOps, אפשר למצוא את זה בקטע הגדרות > ניהול > פרופיל).
- מרחב שמות: אופציונלי: משמש כתג לזיהוי דומיין הנתונים המתאים להוספה לאינדקס ולהעשרה.
- פרטי כניסה ל-JSON: מעלים את פרטי הכניסה ל-Google SecOps בפורמט JSON.
- אזור: בוחרים את האזור, למשל ארה"ב, אירופה או אסיה.
- נתונים לשליחה: בתפריט הנפתח, בוחרים את סוגי הנתונים של Sysdig שרוצים להעביר.
- בודקים את השילוב ומעבירים את המתג למצב מופעל כדי להפעיל אותו.
- לוחצים על Save.
טבלת מיפוי UDM
| שדה ביומן | מיפוי UDM | Logic (פונקציה לוגית) |
|---|---|---|
agentId |
read_only_udm.metadata.product_deployment_id |
הערך של agentId מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
category |
read_only_udm.security_result.category_details |
הערך של category מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
content.fields.container.id |
read_only_udm.target.asset.asset_id |
הערך של content.fields.container.id מהיומן הגולמי מקבל את הקידומת "container_id:" וממופה לשדה הזה ב-UDM. משמש אם containerId ריק. |
content.fields.container.image.repository |
read_only_udm.target.file.full_path |
הערך של content.fields.container.image.repository מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
content.fields.container.image.tag |
read_only_udm.metadata.ingestion_labels.value כשהמפתח הוא tag |
הערך של content.fields.container.image.tag מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
content.fields.evt.res |
read_only_udm.metadata.ingestion_labels.value כשהמפתח הוא evt_res |
הערך של content.fields.evt.res מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
content.fields.evt.type |
read_only_udm.metadata.event_type |
הערך של content.fields.evt.type מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
content.fields.falco.rule |
read_only_udm.security_result.rule_name |
הערך של content.fields.falco.rule מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. משמש אם content.ruleName ריק. |
content.fields.group.gid |
read_only_udm.target.group.product_object_id |
הערך של content.fields.group.gid מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
content.fields.group.name |
read_only_udm.target.group.group_display_name |
הערך של content.fields.group.name מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
content.fields.proc.cmdline |
read_only_udm.target.process.command_line |
הערך של content.fields.proc.cmdline מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
content.fields.proc.pcmdline |
read_only_udm.target.process.parent_process.command_line |
הערך של content.fields.proc.pcmdline מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
content.fields.proc.pid |
read_only_udm.target.process.pid |
הערך של content.fields.proc.pid מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
content.fields.proc.ppid |
read_only_udm.target.process.parent_process.pid |
הערך של content.fields.proc.ppid מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
content.fields.proc.sid |
read_only_udm.metadata.ingestion_labels.value כשהמפתח הוא sid |
הערך של content.fields.proc.sid מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
content.fields.user.loginname |
read_only_udm.principal.user.user_display_name |
הערך של content.fields.user.loginname מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
content.fields.user.uid |
read_only_udm.principal.user.userid |
הערך של content.fields.user.uid מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
content.output |
read_only_udm.additional.fields.value.string_value כשהמפתח הוא content_output |
הערך של content.output מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
content.policyId |
read_only_udm.security_result.rule_id |
הערך של content.policyId מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
content.policyOrigin |
read_only_udm.additional.fields.value.string_value כשהמפתח הוא content_policyOrigin |
הערך של content.policyOrigin מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
content.policyVersion |
read_only_udm.additional.fields.value.string_value כשהמפתח הוא content_policyVersion |
הערך של content.policyVersion מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
content.ruleName |
read_only_udm.security_result.rule_name |
הערך של content.ruleName מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
content.ruleTags |
read_only_udm.security_result.rule_labels |
הערכים במערך content.ruleTags מהיומן הגולמי ממופים לשדה ה-UDM הזה, עם מפתחות שנוצרים באופן דינמי בתור "ruletag_index". |
content.ruleType |
read_only_udm.additional.fields.value.string_value כשהמפתח הוא content_ruleType |
הערך של content.ruleType מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
containerId |
read_only_udm.target.asset.asset_id |
הערך של containerId מהיומן הגולמי מקבל את הקידומת "container_id:" וממופה לשדה הזה ב-UDM. |
description |
read_only_udm.metadata.description |
הערך של description מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
id |
read_only_udm.metadata.product_log_id |
הערך של id מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
labels.container.label.io.kubernetes.container.name |
read_only_udm.additional.fields.value.string_value כשהמפתח הוא container_name |
הערך של labels.container.label.io.kubernetes.container.name מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
labels.container.label.io.kubernetes.pod.name |
read_only_udm.additional.fields.value.string_value כשהמפתח הוא pod_name |
הערך של labels.container.label.io.kubernetes.pod.name מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. משמש אם labels.kubernetes.pod.name ריק. |
labels.container.label.io.kubernetes.pod.namespace |
read_only_udm.principal.namespace |
הערך של labels.container.label.io.kubernetes.pod.namespace מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. משמש אם labels.kubernetes.namespace.name ריק. |
labels.aws.instanceId |
read_only_udm.target.resource.product_object_id |
הערך של labels.aws.instanceId מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
labels.aws.region |
read_only_udm.target.resource.attribute.cloud.availability_zone |
הערך של labels.aws.region מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
labels.host.hostName |
read_only_udm.principal.ip או read_only_udm.principal.hostname |
אם הערך מכיל את המחרוזת "ip", הוא מנותח ככתובת IP וממופה ל-principal.ip. אחרת, הוא ממופה ל-principal.hostname. |
labels.host.mac |
read_only_udm.principal.mac |
הערך של labels.host.mac מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. משמש אם machineId ריק. |
labels.kubernetes.cluster.name |
read_only_udm.additional.fields.value.string_value כשהמפתח הוא kubernetes_cluster_name |
הערך של labels.kubernetes.cluster.name מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
labels.kubernetes.deployment.name |
read_only_udm.additional.fields.value.string_value כשהמפתח הוא kubernetes_deployment_name |
הערך של labels.kubernetes.deployment.name מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
labels.kubernetes.namespace.name |
read_only_udm.principal.namespace |
הערך של labels.kubernetes.namespace.name מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
labels.kubernetes.node.name |
read_only_udm.additional.fields.value.string_value כשהמפתח הוא kubernetes_node_name |
הערך של labels.kubernetes.node.name מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
labels.kubernetes.pod.name |
read_only_udm.additional.fields.value.string_value כשהמפתח הוא pod_name |
הערך של labels.kubernetes.pod.name מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
labels.kubernetes.service.name |
read_only_udm.additional.fields.value.string_value כשהמפתח הוא kubernetes_service_name |
הערך של labels.kubernetes.service.name מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
machineId |
read_only_udm.principal.mac |
הערך של machineId מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
name |
read_only_udm.security_result.summary |
הערך של name מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
severity |
read_only_udm.security_result.severity |
הערך של severity מהיומן הגולמי ממופה לערך מחרוזת על סמך הטווחים הבאים: <4 = HIGH, >3 and <6 = MEDIUM, 6 = LOW, 7 = INFORMATIONAL. |
source |
read_only_udm.security_result.description |
הערך של source מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
timestampRFC3339Nano |
read_only_udm.metadata.event_timestamp |
הערך של timestampRFC3339Nano מהיומן הגולמי מנותח כחותמת זמן וממופה לשדה הזה ב-UDM. |
type |
read_only_udm.metadata.product_event_type |
הערך של type מהיומן הגולמי ממופה ישירות לשדה הזה ב-UDM. |
| (Parser Logic) | read_only_udm.metadata.product_name |
מקודד באופן קשיח ל-"SYSDIG". |
| (Parser Logic) | read_only_udm.metadata.vendor_name |
מקודד באופן קשיח ל-"SYSDIG". |
| (Parser Logic) | read_only_udm.metadata.event_type |
הערך שמוגדר כברירת מחדל הוא PROCESS_UNCATEGORIZED, או GENERIC_EVENT אם השדה labels.host.hostName ריק. |
| (Parser Logic) | read_only_udm.metadata.log_type |
מקודד באופן קשיח ל-"SYSDIG". |
| (Parser Logic) | read_only_udm.target.resource.resource_type |
צריך להגדיר את הערך "CLOUD_PROJECT" אם labels.aws.instanceId קיים. |
יומן שינויים
הצגת יומן השינויים של המנתח הזה
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.