איסוף יומני Jenkins

נתמכים ב:

מנתח הנתונים הזה מחלץ מידע חשוב כמו חותמות זמן, מזהי משתמשים, כתובות IP של מקורות, פעולות ומזהי אובייקטים מיומנים בפורמט JSON ו-SYSLOG. הוא משתמש בתבניות grok כדי להתאים לפורמטים שונים של הודעות ביומן, מטפל בווריאציות במבנה ומאכלס מודל נתונים מאוחד (UDM) בשדות שחולצו. המנתח גם מסווג אירועים לפי נוכחות של פרטי משתמש או כתובת IP.

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

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

  • מכונה של Google Security Operations.
  • גישה מורחבת ל Google Cloud ניהול זהויות והרשאות גישה (IAM).
  • גישה עם הרשאות ניהול ל-Cloud Storage.
  • גישה מיוחדת ל-Jenkins.

יצירת קטגוריה של Cloud Storage

  1. נכנסים ל-Cloud Storage.
  2. יוצרים קטגוריה חדשה. בוחרים שם ייחודי ואזור מתאים.
  3. מוודאים שיש לקטגוריה אמצעי בקרת גישה מתאימים (לדוגמה, רק חשבונות שירות מורשים יכולים לכתוב בה).

יצירת Google Cloud חשבון שירות

  1. עוברים אל IAM & Admin > Service Accounts.
  2. יוצרים חשבון שירות חדש. נותנים לו שם תיאורי (לדוגמה, jenkins-logs).
  3. מקצים לחשבון השירות את התפקיד יצירת אובייקטים של אחסון בקטגוריה של Cloud Storage שיצרתם בשלב הקודם.
  4. יוצרים מפתח SSH לחשבון השירות: יצירה ומחיקה של מפתחות לחשבונות שירות.
  5. מורידים קובץ מפתח בפורמט JSON לחשבון השירות.

התקנת הפלאגין של Cloud Storage ב-Jenkins

  1. עוברים אל Manage Jenkins > Plugins.
  2. לוחצים על פלאגינים זמינים.
  3. מחפשים את הפלאגין של Google Cloud Storage.
  4. מתקינים את הפלאגין ומפעילים מחדש את Jenkins אם צריך.

התקנת הפלאגין Google OAuth Credentials ב-Jenkins

  1. עוברים אל Manage Jenkins > Plugins.
  2. לוחצים על פלאגינים זמינים.
  3. מחפשים את הפלאגין Google OAuth Credentials.
  4. מתקינים את הפלאגין ומפעילים מחדש את Jenkins אם צריך.

הגדרת Jenkins לאימות באמצעות Google Cloud

  1. עוברים אל Manage Jenkins > Credentials > System.

  2. לוחצים על add Add Credentials.

  3. Kind: בוחרים באפשרות Google Service Account from private key.

  4. שם הפרויקט: מגדירים שם לפרטי הכניסה.

  5. מעלים את קובץ המפתח בפורמט JSON שקיבלתם במהלך Google Cloud יצירת חשבון השירות.

  6. לוחצים על יצירה.

הגדרת יומני Jenkins להעלאה ל-Google SecOps

  1. בהגדרות האישיות של המשימה ב-Jenkins, מוסיפים את האפשרות Google Storage Build Log Upload לפעולות שאחרי ה-build, עם הפרמטרים הבאים:
    • ‫Google Credentials: השם של פרטי הכניסה ל-Google שיצרתם בשלב הקודם.
    • ‫Log Name: שם הקובץ שבו יישמר יומן ה-build של Jenkins, בנתיב האחסון שצוין.
    • ‫Storage Location: שם הקטגוריה שאליה רוצים להעלות את היומנים. לחשבון השירות שיצרתם צריכה להיות גישה לקטגוריה.
  2. בודקים את העלאת היומנים.

הגדרת פידים

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

  1. עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמת SIEM בלבד, עוברים אל הגדרות > פידים.
  2. לוחצים על הוספת פיד חדש.
  3. בדף הבא, לוחצים על הגדרת פיד יחיד.
  4. בשדה Feed name, מזינים שם לפיד, לדוגמה Jenkins Logs.
  5. בוחרים באפשרות Google Cloud Storage V2 בתור סוג המקור.
  6. בוחרים באפשרות Jenkins בתור Log type.
  7. לוחצים על Get Service Account בתור Chronicle Service Account.
  8. מציינים ערכים לפרמטרים הבאים של הקלט:

    • ‫Storage Bucket URI: כתובת ה-URL של הקטגוריה ב-Cloud Storage בפורמט gs://my-bucket/<value>/. כתובת ה-URL הזו חייבת להסתיים בקו נטוי (/).
    • אפשרויות למחיקת מקור: בוחרים את אפשרות המחיקה הרצויה.
  9. לוחצים על יצירת פיד.

טבלת מיפוי UDM

שדה ביומן מיפוי UDM היגיון
act security_result.action_details חולץ מהשדות msg1 או msg2. מייצג את הפעולה שבוצעה. רווחים לבנים בתחילת הטקסט יוסרו.
data principal.user.userid או principal.ip או metadata.description אם הנתונים תואמים לתבנית של כתובת IP, הם ממופים ל-principal.ip. אם הוא תואם לתבנית של שם משתמש, הוא ממופה ל-principal.user.userid. אחרת, הוא ממופה ל-metadata.description.
msg1 target.asset.product_object_id או security_result.action_details משמש לחילוץ אובייקט ופעולה. אם קיים /, הוא מפוצל לאובייקט ופעולה. אם קיים », הוא מפוצל לאובייקט ופעולה. אחרת, הוא מטופל כפעולה ועשוי לעבור ניתוח נוסף.
msg2 metadata.description או security_result.action_details אם הוא קיים, הוא ממופה בהתחלה ל-metadata.description. אם הוא מכיל את המחרוזת "completed:", הערך שאחריה מחולץ וממופה אל security_result.action_details.
object target.asset.product_object_id חולץ מ-msg1. מייצג את האובייקט שעליו בוצעה הפעולה.
object_id target.resource.attribute.labels.value חולץ מאובייקט אם קיים /. מייצג מזהה אובייקט ספציפי יותר. המפתח מקודד כ-"Plugin Name".
src_ip principal.ip חולץ מהודעה או מנתונים. מייצג את כתובת ה-IP של המקור.
user principal.user.userid חולץ מהודעה או מנתונים. מייצג את המשתמש שמשויך לאירוע.
metadata.event_timestamp הועתק מהשדה המחושב ‎@timestamp.
metadata.event_type נקבע לפי הלוגיקה של המנתח. הערך מוגדר כ-USER_UNCATEGORIZED אם user קיים, כ-STATUS_UNCATEGORIZED אם src_ip קיים, וכ-GENERIC_EVENT אחרת.
metadata.product_name מקודד באופן קשיח כ-Jenkins.
metadata.product_version מקודד באופן קשיח כ-Jenkins.
metadata.vendor_name מקודד באופן קשיח כ-JENKINS.
metadata.event_timestamp התאריך מורכב מהשדות year,‏ month,‏ day,‏ time ו-ampm.

יומן שינויים

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

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