איסוף יומנים של GitLab
גרסת המנתח: 9.0
המנתח הזה מחלץ שדות מיומני JSON של GitLab, מנרמל אותם למודל הנתונים המאוחד (UDM) ומעשיר את הנתונים בהקשר נוסף. הוא מטפל בסוגים שונים של אירועים ב-GitLab, ומתמקד בפעולות של משתמשים, בגישה למשאבים ובתוצאות אבטחה, תוך עיבוד מידע שקשור לרשת ולאפליקציות. המנתח גם מבצע לוגיקה שמבוססת על תפקידים ופעולות ב-GitLab, מסווג אירועים ומקצה רמות חומרה מתאימות.
לפני שמתחילים
ודאו שאתם עומדים בדרישות המוקדמות הבאות:
- מופע של Google SecOps.
- גישה עם הרשאות מיוחדות ל-GitLab.
הגדרת פידים
כדי להגדיר פיד:
- עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פידים.
- לוחצים על הוספת פיד חדש.
- בדף הבא, לוחצים על הגדרת פיד יחיד.
- בשדה Feed name, נותנים שם לפיד (לדוגמה, GitLab Logs).
- בוחרים באפשרות Webhook בתור סוג המקור.
- בוחרים באפשרות Gitlab בתור סוג היומן.
- לוחצים על הבא.
- אופציונלי: מציינים ערכים לפרמטרים הבאים של הקלט:
- Split delimiter: התו המשמש להפרדה בין שורות ביומן, כמו
\n. - מרחב השמות של הנכס: מרחב השמות של הנכס.
- תוויות הטמעה: התווית שנוספה לאירועים מהפיד הזה.
- Split delimiter: התו המשמש להפרדה בין שורות ביומן, כמו
- לוחצים על הבא.
- בודקים את הגדרות הפיד במסך סיום ולוחצים על שליחה.
- לוחצים על יצירת מפתח סודי כדי ליצור מפתח סודי לאימות הפיד הזה.
- מעתיקים את המפתח הסודי ושומרים אותו. לא תוכלו לראות שוב את המפתח הסודי הזה. במקרה הצורך, אפשר ליצור מחדש מפתח סודי, אבל הפעולה הזו מבטלת את המפתח הסודי הקודם.
- בכרטיסייה פרטים, מעתיקים את כתובת ה-URL של נקודת הקצה של הפיד מהשדה פרטי נקודת הקצה. צריך לציין את כתובת ה-URL של נקודת הקצה הזו באפליקציית הלקוח.
- לוחצים על סיום.
יצירת מפתח API לפיד ה-Webhook
נכנסים לדף CredentialsGoogle Cloud במסוף >.
לוחצים על Create credentials ואז על מפתח API.
מגבילים את הגישה של מפתח ה-API ל-Chronicle API.
מציינים את כתובת ה-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 Security Operations. -
SECRET: המפתח הסודי שיצרתם כדי לאמת את הפיד.
הגדרת webhook ב-GitLab ל-Google SecOps
- פותחים את דפדפן האינטרנט ועוברים לפרויקט ב-GitLab שרוצים להגדיר בשבילו את ה-webhook.
- בפרויקט, עוברים אל הגדרות > תגובות לפעולה מאתר אחר (webhooks).
- לוחצים על הוספת תגובה לפעולה מאתר אחר (webhook).
- בשדה URL, מדביקים את כתובת ה-URL של נקודת הקצה של Google SecOps.
- לוחצים על הוספת כותרת בהתאמה אישית.
- בשדה Header Name (שם הכותרת) מקלידים X-Webhook-Access-Key.
- בשדה Header Value, מעתיקים את המפתח הסודי שנוצר במהלך הגדרת הפיד של Google SecOps.
- לוחצים על הוספת כותרת בהתאמה אישית.
- בשדה Header Name, מקלידים X-goog-api-key.
- בשדה Header Value, מעתיקים את מפתח ה-API שנוצר במהלך הגדרת הפיד של Google SecOps. הערה: כדי לשפר את האבטחה, יוצרים טוקן סודי ומוסיפים אותו גם להגדרת ה-webhook של GitLab וגם להגדרת הפיד התואמת של Google SecOps. כך אפשר לאמת את האותנטיות של תגובות לפעולה מאתר אחר (webhook) נכנסות.
- בוחרים את האירועים ב-GitLab שיפעילו את ה-webhook. לדוגמה, אתם יכולים לבחור באפשרות Push events כדי לשלוח נתונים ל-Google SecOps בכל פעם שקוד נשלח למאגר. חשוב לשקול היטב אילו אירועים רלוונטיים לצורכי הניטור שלכם לצורכי אבטחה. יותר מדי אירועים עלולים לגרום לעומס מיותר.
- כדי להבין טוב יותר את מטרת ה-webhook, תנו לו שם משמעותי, כמו Google SecOps Webhook.
- מוודאים שהתיבה הפעלת אימות SSL מסומנת. זה חיוני לתקשורת מאובטחת.
- לוחצים על 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.