איסוף יומני Sysdig

נתמך ב:

המנתח הזה מחלץ נתוני אירוע אבטחה מיומני Sysdig בפורמט JSON, וממיר וממפה את השדות של היומן הגולמי לפורמט UDM של Google Security Operations. הוא מטפל בשדות שונים, כולל מטא-נתונים, מידע על חשבון משתמש או יעד, פרטים של תוצאות אבטחה והקשר שקשור ל-Kubernetes, ומעשיר את הנתונים לניתוח ב-Google SecOps. המנתח גם מבצע המרות של סוגי נתונים, טיפול בשגיאות ולוגיקה מותנית על סמך ערכי שדות כדי להבטיח ייצוג מדויק ומקיף של UDM.

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

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

  • מופע של Google SecOps.
  • גישה מיוחדת ל-Sysdig Secure.

יצירת מפתח API לפיד ה-Webhook

  1. נכנסים לדף CredentialsGoogle Cloud במסוף >.

    כניסה לדף Credentials

  2. לוחצים על Create credentials ואז על מפתח API.

  3. מגבילים את הגישה של מפתח ה-API ל-Google Security Operations API.

אפשרות 1

הגדרת פידים

כדי להגדיר פיד:

  1. עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פידים.
  2. לוחצים על הוספת פיד חדש.
  3. בדף הבא, לוחצים על הגדרת פיד יחיד.
  4. בשדה Feed name, נותנים שם לפיד, לדוגמה Sysdig Logs.
  5. בוחרים באפשרות Webhook בתור סוג המקור.
  6. בוחרים באפשרות Sysdig בתור Log type.
  7. לוחצים על הבא.
  8. אופציונלי: מציינים ערכים לפרמטרים הבאים של הקלט:

    • Split delimiter: התו המשמש להפרדה בין שורות ביומן, כמו \n.
  9. לוחצים על הבא.

  10. בודקים את הגדרות הפיד במסך סיום ולוחצים על שליחה.

  11. לוחצים על יצירת מפתח סודי כדי ליצור מפתח סודי לאימות הפיד הזה.

  12. מעתיקים את המפתח הסודי ושומרים אותו. לא תוכלו לראות שוב את המפתח הסודי הזה. במקרה הצורך, אפשר ליצור מחדש מפתח סודי, אבל הפעולה הזו מבטלת את המפתח הסודי הקודם.

  13. בכרטיסייה פרטים, מעתיקים את כתובת ה-URL של נקודת הקצה של הפיד מהשדה פרטי נקודת הקצה. צריך לציין את כתובת ה-URL של נקודת הקצה הזו באפליקציית הלקוח.

  14. לוחצים על סיום.

מציינים את כתובת ה-URL של נקודת הקצה

  1. באפליקציית הלקוח, מציינים את כתובת ה-URL של נקודת הקצה (endpoint) ב-HTTPS שסופקה בפיד ה-webhook.
  2. כדי להפעיל את האימות, צריך לציין את מפתח ה-API ואת המפתח הסודי כחלק מהכותרת בהתאמה אישית, בפורמט הבא:

    X-goog-api-key = API_KEY
    X-Webhook-Access-Key = SECRET
    

    המלצה: ציינו את מפתח ה-API ככותרת במקום לציין אותו בכתובת ה-URL.

  3. אם לקוח ה-webhook שלכם לא תומך בכותרות בהתאמה אישית, אתם יכולים לציין את מפתח ה-API ואת המפתח הסודי באמצעות פרמטרים של שאילתה בפורמט הבא:

    ENDPOINT_URL?key=API_KEY&secret=SECRET
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫ENDPOINT_URL: כתובת ה-URL של נקודת הקצה של הפיד.
    • ‫API_KEY: מפתח ה-API לאימות ב-Google SecOps.
    • ‫SECRET: המפתח הסודי שיצרתם כדי לאמת את הפיד.

הגדרת Webhook ב-Sysdig

  1. נכנסים ל-Sysdig Secure עם הרשאות אדמין.
  2. עוברים אל פרופיל > הגדרות > העברת אירועים.
  3. לוחצים על ‎+Add Integration (הוספת שילוב) ובוחרים באפשרות Webhook בתפריט הנפתח.
  4. מציינים ערכים לפרמטרים הבאים של הקלט:

    • ‫Integration Name: נותנים שם תיאורי ל-webhook (לדוגמה, Google SecOps Webhook).
    • נקודת קצה (endpoint): מזינים את ה-Webhook <ENDPOINT_URL>, ואז את <API_KEY ואת <SECRET>.
    • נתונים לשליחה: בוחרים מהתפריט הנפתח את סוגי הנתונים של Sysdig שצריך להעביר.

    • בודקים את השילוב ומעבירים את המתג למצב מופעל כדי להפעיל אותו.

    • לוחצים על Save.

אפשרות 2

העברת נתונים ישירות ל-Google SecOps

  1. נכנסים ל-Sysdig Secure באמצעות פרטי הכניסה של האדמין.
  2. עוברים אל הגדרות > העברת אירועים.
  3. לוחצים על +Add Integration ובוחרים באפשרות Google Chronicle בתפריט הנפתח.
  4. מציינים ערכים לפרמטרים הבאים של הקלט:
    • שם השילוב: נותנים שם תיאורי לשילוב (לדוגמה, שילוב עם 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.