איסוף יומני OpenCanary

נתמך ב:

המנתח הזה מחלץ שדות מיומני SYSLOG ו-JSON של OpenCanary, מנרמל אותם לפורמט UDM ומעשיר את הנתונים בשדות נגזרים כמו metadata.event_type ו-security_result.severity. הוא מטפל בפורמטים שונים של יומנים, מבצע אימות של כתובות IP וממפה שדות לאובייקטים מתאימים של UDM כמו principal,‏ target ו-network.

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

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

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

הגדרת פידים

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

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

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

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

    כניסה לדף Credentials

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

  3. מגבילים את הגישה של מפתח ה-API ל-Google Security Operations 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 Security Operations.
    • ‫SECRET: המפתח הסודי שיצרתם כדי לאמת את הפיד.

הגדרת תגובה לפעולה מאתר אחר (Webhook) של OpenCanary ל-Google SecOps

  1. מאתרים את קובץ התצורה של OpenCanary,‏ config.json.

  2. פותחים את הקובץ config.json בכלי לעריכת טקסט.

  3. מאתרים את הקטע alerters בקובץ התצורה.

  4. אם כבר קיים התרעה מסוג webhook, צריך לשנות אותה. אחרת, צריך להוסיף רשומה חדשה למערכת ההתראות של webhook.

  5. משתמשים בהגדרות הבאות (מחליפים את ENDPOINT_URL,‏ SECRET ו-API_KEY בערכים שלכם):

"handlers": {
    "Webhook": {
        "class": "opencanary.logger.WebhookHandler",
        "url": "<ENDPOINT_URL>",
        "method": "POST",
        "data": {"message": "%(message)s"},
        "status_code": 200,
        "headers": {
            "X-Webhook-Access-Key": "<SECRET>",
            "X-goog-api-key": "<API_KEY>"
         }
    }
}
  1. שומרים את קובץ ה-config.json.
  2. מפעילים מחדש את שירות OpenCanary כדי להחיל את השינויים. (לדוגמה, sudo systemctl restart opencanary).

טבלת מיפוי UDM

שדה ביומן מיפוי UDM Logic (פונקציה לוגית)
dst_host target.asset.ip השדה dst_host ביומן הגולמי ממופה ל-UDM. ממופה גם אל target.ip.
dst_host target.ip השדה dst_host ביומן הגולמי ממופה ל-UDM. ממופה גם אל target.asset.ip.
dst_port target.port השדה dst_port ביומן הגולמי מומר למחרוזת ואז למספר שלם, וממופה ל-UDM.
local_time metadata.event_timestamp השדה local_time ביומן הגולמי משמש לאכלוס השדה metadata.event_timestamp ב-UDM. המנתח משתמש ב-create_time מאובייקט ה-batch אם השדה local_time לא קיים.
local_time_adjusted security_result.detection_fields השדה local_time_adjusted של היומן הגולמי מתווסף כצמד מפתח/ערך למערך security_result.detection_fields ב-UDM.
logdata.COMMUNITY_STRING security_result.detection_fields השדה logdata.COMMUNITY_STRING של היומן הגולמי מתווסף כצמד מפתח/ערך למערך security_result.detection_fields ב-UDM.
logdata.DOMAIN principal.administrative_domain השדה logdata.DOMAIN ביומן הגולמי ממופה ל-UDM.
logdata.FILENAME target.file.full_path השדה logdata.FILENAME ביומן הגולמי ממופה ל-UDM.
logdata.HOSTNAME principal.asset.hostname אם השדה logdata.HOSTNAME הוא לא כתובת IP, הוא ממופה ל-UDM. ממופה גם אל principal.hostname.
logdata.HOSTNAME principal.asset.ip אם השדה logdata.HOSTNAME הוא כתובת IP, הוא ממופה ל-UDM. ממופה גם אל principal.ip.
logdata.HOSTNAME principal.hostname אם השדה logdata.HOSTNAME הוא לא כתובת IP, הוא ממופה ל-UDM. ממופה גם אל principal.asset.hostname.
logdata.HOSTNAME principal.ip אם השדה logdata.HOSTNAME הוא כתובת IP, הוא ממופה ל-UDM. ממופה גם אל principal.asset.ip.
logdata.LOCALNAME principal.asset.hostname השדה logdata.LOCALNAME ביומן הגולמי ממופה ל-UDM. ממופה גם אל principal.hostname.
logdata.LOCALNAME principal.hostname השדה logdata.LOCALNAME ביומן הגולמי ממופה ל-UDM. ממופה גם אל principal.asset.hostname.
logdata.LOCALVERSION principal.platform_version השדה logdata.LOCALVERSION ביומן הגולמי ממופה ל-UDM.
logdata.PASSWORD extensions.auth.mechanism הנוכחות של השדה logdata.PASSWORD מפעילה את המנתח כדי להגדיר את extensions.auth.mechanism ל-USERNAME_PASSWORD ב-UDM.
logdata.PATH network.http.referral_url השדה logdata.PATH ביומן הגולמי ממופה ל-UDM.
logdata.REMOTENAME target.asset.hostname השדה logdata.REMOTENAME ביומן הגולמי ממופה ל-UDM. ממופה גם אל target.hostname.
logdata.REMOTENAME target.hostname השדה logdata.REMOTENAME ביומן הגולמי ממופה ל-UDM. ממופה גם אל target.asset.hostname.
logdata.REMOTEVERSION target.platform_version השדה logdata.REMOTEVERSION ביומן הגולמי ממופה ל-UDM.
logdata.SMBVER network.application_protocol הנוכחות של השדה logdata.SMBVER מפעילה את המנתח כדי להגדיר את network.application_protocol ל-SMB ב-UDM.
logdata.USERAGENT network.http.parsed_user_agent השדה logdata.USERAGENT ביומן הגולמי מומר לסוכן משתמש מנותח וממופה ל-UDM.
logdata.USERAGENT network.http.user_agent השדה logdata.USERAGENT ביומן הגולמי ממופה ל-UDM.
logdata.USERNAME target.user.userid השדה logdata.USERNAME ביומן הגולמי ממופה ל-UDM.
loglevel security_result.severity השדה loglevel ביומן הגולמי קובע את הערך של security_result.severity ב-UDM. ‫WARNING ממופה ל-HIGH, INFO/INFORMATION ממופה ל-LOW.
logtype security_result.detection_fields השדה logtype של היומן הגולמי נוסף כצמד מפתח/ערך למערך security_result.detection_fields ב-UDM.
node_id principal.asset.asset_id השדה node_id ביומן הגולמי מתחיל ב-"id:" וממופה ל-UDM.
src_host principal.asset.ip השדה src_host ביומן הגולמי ממופה ל-UDM. ממופה גם אל principal.ip.
src_host principal.ip השדה src_host ביומן הגולמי ממופה ל-UDM. ממופה גם אל principal.asset.ip.
src_port principal.port השדה src_port ביומן הגולמי מומר למספר שלם וממופה ל-UDM.
utc_time security_result.detection_fields השדה utc_time של היומן הגולמי מתווסף כצמד מפתח/ערך למערך security_result.detection_fields ב-UDM.

יומן שינויים

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

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