איסוף יומנים של GitLab

גרסת המנתח: 9.0

נתמך ב:

המנתח הזה מחלץ שדות מיומני JSON של GitLab, מנרמל אותם למודל הנתונים המאוחד (UDM) ומעשיר את הנתונים בהקשר נוסף. הוא מטפל בסוגים שונים של אירועים ב-GitLab, ומתמקד בפעולות של משתמשים, בגישה למשאבים ובתוצאות אבטחה, תוך עיבוד מידע שקשור לרשת ולאפליקציות. המנתח גם מבצע לוגיקה שמבוססת על תפקידים ופעולות ב-GitLab, מסווג אירועים ומקצה רמות חומרה מתאימות.

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

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

  • מופע של Google SecOps.
  • גישה עם הרשאות מיוחדות ל-GitLab.

הגדרת פידים

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

  1. עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פידים.
  2. לוחצים על הוספת פיד חדש.
  3. בדף הבא, לוחצים על הגדרת פיד יחיד.
  4. בשדה Feed name, נותנים שם לפיד (לדוגמה, GitLab Logs).
  5. בוחרים באפשרות Webhook בתור סוג המקור.
  6. בוחרים באפשרות Gitlab בתור סוג היומן.
  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 ל-Chronicle API.

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

  1. באפליקציית הלקוח, מציינים את כתובת ה-URL של נקודת הקצה (endpoint) ב-HTTPS שסופקה בפיד ה-webhook.
  2. כדי להפעיל את האימות, צריך לציין את מפתח ה-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 Security Operations.
  • ‫SECRET: המפתח הסודי שיצרתם כדי לאמת את הפיד.

הגדרת webhook ב-GitLab ל-Google SecOps

  1. פותחים את דפדפן האינטרנט ועוברים לפרויקט ב-GitLab שרוצים להגדיר בשבילו את ה-webhook.
  2. בפרויקט, עוברים אל הגדרות > תגובות לפעולה מאתר אחר (webhooks).
  3. לוחצים על הוספת תגובה לפעולה מאתר אחר (webhook).
  4. בשדה URL, מדביקים את כתובת ה-URL של נקודת הקצה של Google SecOps.
  5. לוחצים על הוספת כותרת בהתאמה אישית.
  6. בשדה Header Name (שם הכותרת) מקלידים X-Webhook-Access-Key.
  7. בשדה Header Value, מעתיקים את המפתח הסודי שנוצר במהלך הגדרת הפיד של Google SecOps.
  8. לוחצים על הוספת כותרת בהתאמה אישית.
  9. בשדה Header Name, מקלידים X-goog-api-key.
  10. בשדה Header Value, מעתיקים את מפתח ה-API שנוצר במהלך הגדרת הפיד של Google SecOps. הערה: כדי לשפר את האבטחה, יוצרים טוקן סודי ומוסיפים אותו גם להגדרת ה-webhook של GitLab וגם להגדרת הפיד התואמת של Google SecOps. כך אפשר לאמת את האותנטיות של תגובות לפעולה מאתר אחר (webhook) נכנסות.
  11. בוחרים את האירועים ב-GitLab שיפעילו את ה-webhook. לדוגמה, אתם יכולים לבחור באפשרות Push events כדי לשלוח נתונים ל-Google SecOps בכל פעם שקוד נשלח למאגר. חשוב לשקול היטב אילו אירועים רלוונטיים לצורכי הניטור שלכם לצורכי אבטחה. יותר מדי אירועים עלולים לגרום לעומס מיותר.
  12. כדי להבין טוב יותר את מטרת ה-webhook, תנו לו שם משמעותי, כמו Google SecOps Webhook.
  13. מוודאים שהתיבה הפעלת אימות SSL מסומנת. זה חיוני לתקשורת מאובטחת.
  14. לוחצים על Add webhook (הוספת תגובה לפעולה מאתר אחר) כדי לשמור את ההגדרות.

טבלת מיפוי UDM

שדה ביומן מיפוי UDM Logic (פונקציה לוגית)
author_id principal.user.userid הומר למחרוזת.
author_name principal.user.email_addresses אם הערך תואם לביטוי רגולרי של כתובת אימייל.
author_name principal.user.user_display_name אם הערך לא תואם לביטוי הרגולרי של כתובת אימייל.
details.as principal.resource.attribute.labels נוספה כתווית עם המפתח "as".
details.add principal.resource.attribute.labels נוסף כתווית עם המפתח "add".
details.as principal.user.role_name הערך של שדה היומן הגולמי.
details.as principal.user.attribute.roles.type מגדירים את הערך "ADMINISTRATOR" אם details.as הוא "Owner", את הערך "SERVICE_ACCOUNT" אם details.as הוא "Developer",‏ "Maintainer" או "Reporter", ואת הערך "TYPE_UNSPECIFIED" אם details.as הוא "Guest".
details.custom_message security_result.description הערך של שדה היומן הגולמי.
details.custom_message.action security_result.summary הערך של שדה היומן הגולמי.
details.entity_path target.file.full_path הערך של שדה היומן הגולמי.
details.target_id target.resource.id הומר למחרוזת.
entity_path target.file.full_path הערך של שדה היומן הגולמי.
entity_type target.resource.attribute.labels נוסף כתווית עם המפתח "Entity Type".
event_type metadata.product_event_type הערך של שדה היומן הגולמי.
insertId metadata.product_log_id הערך של שדה היומן הגולמי.
ip_address principal.ip, principal.asset.ip הערך של שדה היומן הגולמי.
jsonPayload.action additional.fields נוסף כשדה עם המפתח "action" וערך מחרוזת.
jsonPayload.controller additional.fields נוסף כשדה עם המפתח "controller" וערך מחרוזת.
jsonPayload.correlation_id principal.asset_id עם הקידומת "id: ".
jsonPayload.cpu_s additional.fields נוסף כשדה עם המפתח "cpu_s" וערך מחרוזת.
jsonPayload.details.custom_message.protocol network.application_protocol הערך מוגדר כ-"UNKNOWN_APPLICATION_PROTOCOL" אם הערך הוא "web", אחרת הוא מומר לאותיות רישיות. הוא מתווסף גם כשדה נוסף עם המפתח "פרוטוקול אפליקציה" אם הערך הוא "אינטרנט".
jsonPayload.mem_total_bytes additional.fields נוסף כשדה עם המפתח "mem_total_bytes" וערך מחרוזת.
jsonPayload.meta_caller_id additional.fields נוסף כשדה עם המפתח "Caller Id" וערך מחרוזת.
jsonPayload.meta_client_id target.user.userid הערך של שדה היומן הגולמי.
jsonPayload.meta_feature_category additional.fields הוא נוסף כשדה עם המפתח Feature Category וערך מחרוזת.
jsonPayload.meta_remote_ip principal.ip, principal.asset.ip ערך השדה של היומן הגולמי, שנותח כמערך JSON ומוזג לשדות ה-IP.
jsonPayload.meta_user principal.user.userid משמש כגיבוי אם jsonPayload.username ריק.
jsonPayload.method network.http.method הערך של שדה היומן הגולמי.
jsonPayload.path target.process.file.full_path הערך של שדה היומן הגולמי.
jsonPayload.pid target.process.pid הומר למחרוזת.
jsonPayload.remote_ip principal.ip, principal.asset.ip הערך של שדה היומן הגולמי.
jsonPayload.request_urgency additional.fields נוסף כשדה עם המפתח "דחיפות הבקשה" וערך מחרוזת.
jsonPayload.severity security_result.severity מגדירים את הערך INFORMATIONAL אם הערך הוא INFO, את הערך ERROR אם הערך הוא ERROR, ואת הערך MEDIUM אם הערך הוא NOTICE.
jsonPayload.status network.http.response_code אם הערך הוא לא ACTIVE, הוא מומר למספר שלם.
jsonPayload.ua network.http.user_agent הערך של שדה היומן הגולמי.
jsonPayload.username principal.user.userid הערך של שדה היומן הגולמי.
jsonPayload.worker_id principal.application הערך של שדה היומן הגולמי.
labels.instance_name principal.hostname, principal.asset.hostname ערך השדה של היומן הגולמי, שמשמש אם ההודעה מכילה את הטקסט "Removing user".
logName security_result.category_details הערך של שדה היומן הגולמי.
message security_result.summary ערך השדה של היומן הגולמי, שמשמש אם הערך של jsonPayload.severity הוא "ERROR".
protoPayload.@type additional.fields נוסף כשדה עם המפתח "protoPayload type" וערך מחרוזת.
protoPayload.authenticationInfo.principalEmail principal.user.email_addresses, principal.user.userid הערך של שדה היומן הגולמי.
protoPayload.authenticationInfo.principalSubject additional.fields נוסף כשדה עם המפתח authenticationInfo principalSubject וערך מחרוזת.
protoPayload.authenticationInfo.serviceAccountKeyName additional.fields נוסף כשדה עם המפתח "authenticationInfo serviceAccountKeyName" וערך מחרוזת.
protoPayload.authorizationInfo target.resource.attribute.labels, security_result.action הערכים בשדה הזה מתווספים כתוויות עם מפתחות שמתחילים ב-authenticationInfo. הערך של security_result.action מוגדר כ-ALLOW אם הערך ב-granted הוא true, וכ-BLOCK אם הערך הוא false. שדות בתצוגת עץ כמו resourceAttributes מתווספים גם כתוויות עם מפתחות עם הקידומת "authenticationInfo_resourceAttributes".
protoPayload.methodName additional.fields נוסף כשדה עם המפתח "protoPayload methodName" וערך מחרוזת.
protoPayload.request.@type additional.fields נוסף כשדה עם המפתח "Request Type" וערך מחרוזת.
protoPayload.request.resource target.resource.attribute.labels נוסף כתווית עם המפתח "Request resource".
protoPayload.requestMetadata.callerIp additional.fields נוסף כשדה עם המפתח requestMetadata callerIp וערך מחרוזת.
protoPayload.requestMetadata.callerSuppliedUserAgent additional.fields נוסף כשדה עם המפתח requestMetadata callerSuppliedUserAgent וערך מחרוזת.
protoPayload.serviceName additional.fields נוסף כשדה עם המפתח "serviceName" וערך מחרוזת.
protoPayload.status.code additional.fields נוסף כשדה עם המפתח "protoPayload status code" וערך מחרוזת.
protoPayload.status.message additional.fields, target.user.email_addresses, target.user.userid נוסף כשדה עם המפתח "protoPayload status message" וערך מחרוזת. אם אפשר לחלץ כתובת אימייל מההודעה, היא תתווסף אל target.user.email_addresses ואל target.user.userid.
receiveTimestamp metadata.event_timestamp, timestamp מנותח כחותמת הזמן של האירוע.
resource.labels.project_id target.resource.attribute.labels נוסף כתווית עם המפתח "מזהה פרויקט".
resource.labels.zone target.cloud.availability_zone הערך של שדה היומן הגולמי.
resource.type target.cloud.environment אם הערך תואם ל-"gce", מגדירים את הערך "GOOGLE_CLOUD_PLATFORM".
security_result.action security_result.action נגזר מ-protoPayload.authorizationInfo.granted.
security_result.category_details security_result.category_details מוזגה עם logName.
security_result.description security_result.description נגזר מ-jsonPayload.details.custom_message.
security_result.severity security_result.severity נגזר מ-severity או מ-jsonPayload.severity.
security_result.summary security_result.summary נגזר מ-jsonPayload.details.custom_message.action או מ-jsonPayload.message.
severity security_result.severity מגדירים את הערך INFORMATIONAL אם הערך הוא INFO, את הערך ERROR אם הערך הוא ERROR, ואת הערך MEDIUM אם הערך הוא NOTICE.
sourceLocation principal.resource.attribute.labels הערכים בשדה הזה מתווספים כתוויות.
target_details target.resource.attribute.labels נוסף כתווית עם המפתח "פרטי היעד".
target_type target.resource.attribute.labels נוסף כתווית עם המפתח "target type".
timestamp timestamp הערך של שדה היומן הגולמי. ההגדרה נקבעת לפי הנוכחות של שדות המקור והיעד. אם לא מתקיים תנאי ספציפי, ברירת המחדל היא "GENERIC_EVENT". הערכים האפשריים הם "USER_RESOURCE_UPDATE_CONTENT",‏ "USER_RESOURCE_ACCESS",‏ "USER_UNCATEGORIZED". צריך להגדיר את הערך "GITLAB". צריך להגדיר את הערך "GITLAB".

יומן שינויים

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

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