איסוף יומנים של Aqua Security

גרסת המנתח: 1.0

נתמך ב:

המנתח הזה מחלץ שדות מיומני Aqua Security וממיר אותם למודל הנתונים המאוחד (UDM). הוא מנתח את השדה message כ-JSON, מחלץ את המשתמש, את כתובת ה-IP של המקור ושדות רלוונטיים אחרים, ממפה אותם לשדות UDM ומסווג אירועים על סמך השדה action. כך הוא מעשיר את הנתונים בהקשר אבטחה כמו שמות של כללים, תיאורים ופרטי CVE.

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

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

  • מופע של Google SecOps.
  • גישה עם הרשאות למסוף הניהול של Aqua Security.

הגדרת פידים

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

  1. עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פידים.
  2. לוחצים על הוספת פיד חדש.
  3. בדף הבא, לוחצים על הגדרת פיד יחיד.
  4. בשדה Feed name, מזינים שם לפיד (לדוגמה, Aqua Security Logs).
  5. בוחרים באפשרות Webhook בתור סוג המקור.
  6. בוחרים באפשרות Aqua Security בתור סוג היומן.
  7. לוחצים על הבא.
  8. אופציונלי: מציינים ערכים לפרמטרים הבאים של הקלט:
    • Split delimiter: התו המשמש להפרדה בין שורות ביומן, כמו \n.
    • מרחב השמות של הנכס: מרחב השמות של הנכס.
    • תוויות הטמעה: התווית שנוספה לאירועים מהפיד הזה.
  9. לוחצים על הבא.
  10. בודקים את הגדרות הפיד במסך סיום ולוחצים על שליחה.
  11. לוחצים על יצירת מפתח סודי כדי ליצור מפתח סודי לאימות הפיד הזה.
  12. מעתיקים את המפתח הסודי ושומרים אותו. לא תוכלו לראות שוב את המפתח הסודי הזה. במקרה הצורך, אפשר ליצור מחדש מפתח סודי, אבל הפעולה הזו מבטלת את המפתח הסודי הקודם.
  13. בכרטיסייה פרטים, מעתיקים את כתובת ה-URL של נקודת הקצה של הפיד מהשדה פרטי נקודת הקצה. צריך לציין את כתובת ה-URL של נקודת הקצה הזו באפליקציית הלקוח.
  14. לוחצים על סיום.

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

  1. עוברים אל מסוףGoogle Cloud > Credentials.

    כניסה לדף Credentials

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

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

מציינים את כתובת ה-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 ב-Aqua Security ל-Google SecOps

  1. נכנסים למסוף Aqua Security.
  2. עוברים אל הגדרות > Webhook של תוצאות סריקת תמונות.
  3. מסמנים את התיבה הפעלת שליחה של תוצאות סריקת תמונות.
  4. מזינים את <ENDPOINT_URL>, ואז את <API_KEY> ואת <SECRET>.
  5. לוחצים על Save.

טבלת מיפוי UDM

שדה ביומן (בסדר עולה) מיפוי UDM Logic (פונקציה לוגית)
jsonPayload.action metadata.event_type ממופה על סמך הערך של jsonPayload.action. אפשר לראות את קוד המנתח למיפויים ספציפיים.
jsonPayload.action security_result.summary מיפוי ישיר.
jsonPayload.adjective target.file.full_path מיפוי ישיר אם השדה jsonPayload.container ריק.
jsonPayload.category target.asset.category מיפוי ישיר.
jsonPayload.cfappname target.application מיפוי ישיר.
jsonPayload.cfspace principal.user.userid מיפוי ישיר אם השדה jsonPayload.user ריק.
jsonPayload.command principal.ip חולץ באמצעות תבנית grok "user %{GREEDYDATA:user_id} \(%{IP:src_ip}\)".
jsonPayload.command principal.user.userid חולץ באמצעות תבנית grok "user %{GREEDYDATA:user_id} \(%{IP:src_ip}\)".
jsonPayload.container target.asset.product_object_id מיפוי ישיר.
jsonPayload.data security_result.detection_fields מנותח כצמדי מפתח/ערך וממופה לשדות נפרדים בתוך security_result.detection_fields.
jsonPayload.description security_result.description מיפוי ישיר אם השדה jsonPayload.reason ריק.
jsonPayload.host principal.hostname מיפוי ישיר.
jsonPayload.hostgroup target.group.group_display_name מיפוי ישיר.
jsonPayload.hostid target.asset_id מופה בתור "מזהה מארח: %{jsonPayload.hostid}".
jsonPayload.hostip target.ip מיפוי ישיר.
jsonPayload.image target.file.full_path מיפוי ישיר.
jsonPayload.level security_result.action מגדירים את הערך ALLOW אם הערך של jsonPayload.level הוא success.
jsonPayload.reason security_result.description מיפוי ישיר.
jsonPayload.rule security_result.rule_name מיפוי ישיר.
jsonPayload.user principal.user.userid מיפוי ישיר.
jsonPayload.vm_location target.asset.location.name מיפוי ישיר.
jsonPayload.vm_name target.resource.name מיפוי ישיר.
resource.labels.instance_id target.resource.id מיפוי ישיר.
resource.labels.project_id target.asset.attribute.cloud.project.id מיפוי ישיר.
resource.labels.zone target.asset.attribute.cloud.availability_zone מיפוי ישיר.
חותמת זמן metadata.event_timestamp מיפוי ישיר אחרי המרה לפורמט ISO8601.
extensions.auth.type אם הערך של jsonPayload.description מכיל את המחרוזת "SAML", מגדירים את הערך "SSO". אחרת, אם הערך של jsonPayload.action הוא "login" או "Login", מגדירים את הערך "AUTHTYPE_UNSPECIFIED".
metadata.log_type מגדירים את הערך "AQUA_SECURITY".
metadata.product_name מגדירים את הערך "AQUA_SECURITY".
metadata.vendor_name מגדירים את הערך "AQUA_SECURITY".
target.asset.attribute.cloud.environment צריך להגדיר את הערך "GOOGLE_CLOUD_PLATFORM".
target.resource.type צריך להגדיר את הערך "VIRTUAL_MACHINE".

יומן שינויים

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

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