איסוף יומני Jenkins
מנתח הנתונים הזה מחלץ מידע חשוב כמו חותמות זמן, מזהי משתמשים, כתובות IP של מקורות, פעולות ומזהי אובייקטים מיומנים בפורמט JSON ו-SYSLOG. הוא משתמש בתבניות grok כדי להתאים לפורמטים שונים של הודעות ביומן, מטפל בווריאציות במבנה ומאכלס מודל נתונים מאוחד (UDM) בשדות שחולצו. המנתח גם מסווג אירועים לפי נוכחות של פרטי משתמש או כתובת IP.
לפני שמתחילים
ודאו שאתם עומדים בדרישות המוקדמות הבאות:
- מכונה של Google Security Operations.
- גישה מורחבת ל Google Cloud ניהול זהויות והרשאות גישה (IAM).
- גישה עם הרשאות ניהול ל-Cloud Storage.
- גישה מיוחדת ל-Jenkins.
יצירת קטגוריה של Cloud Storage
- נכנסים ל-Cloud Storage.
- יוצרים קטגוריה חדשה. בוחרים שם ייחודי ואזור מתאים.
- מוודאים שיש לקטגוריה אמצעי בקרת גישה מתאימים (לדוגמה, רק חשבונות שירות מורשים יכולים לכתוב בה).
יצירת Google Cloud חשבון שירות
- עוברים אל IAM & Admin > Service Accounts.
- יוצרים חשבון שירות חדש. נותנים לו שם תיאורי (לדוגמה, jenkins-logs).
- מקצים לחשבון השירות את התפקיד יצירת אובייקטים של אחסון בקטגוריה של Cloud Storage שיצרתם בשלב הקודם.
- יוצרים מפתח SSH לחשבון השירות: יצירה ומחיקה של מפתחות לחשבונות שירות.
מורידים קובץ מפתח בפורמט JSON לחשבון השירות.
התקנת הפלאגין של Cloud Storage ב-Jenkins
- עוברים אל Manage Jenkins > Plugins.
- לוחצים על פלאגינים זמינים.
- מחפשים את הפלאגין של Google Cloud Storage.
- מתקינים את הפלאגין ומפעילים מחדש את Jenkins אם צריך.
התקנת הפלאגין Google OAuth Credentials ב-Jenkins
- עוברים אל Manage Jenkins > Plugins.
- לוחצים על פלאגינים זמינים.
- מחפשים את הפלאגין Google OAuth Credentials.
- מתקינים את הפלאגין ומפעילים מחדש את Jenkins אם צריך.
הגדרת Jenkins לאימות באמצעות Google Cloud
עוברים אל Manage Jenkins > Credentials > System.
לוחצים על add Add Credentials.
Kind: בוחרים באפשרות Google Service Account from private key.
שם הפרויקט: מגדירים שם לפרטי הכניסה.
מעלים את קובץ המפתח בפורמט JSON שקיבלתם במהלך Google Cloud יצירת חשבון השירות.
לוחצים על יצירה.
הגדרת יומני Jenkins להעלאה ל-Google SecOps
- בהגדרות האישיות של המשימה ב-Jenkins, מוסיפים את האפשרות Google Storage Build Log Upload לפעולות שאחרי ה-build, עם הפרמטרים הבאים:
- Google Credentials: השם של פרטי הכניסה ל-Google שיצרתם בשלב הקודם.
- Log Name: שם הקובץ שבו יישמר יומן ה-build של Jenkins, בנתיב האחסון שצוין.
- Storage Location: שם הקטגוריה שאליה רוצים להעלות את היומנים. לחשבון השירות שיצרתם צריכה להיות גישה לקטגוריה.
- בודקים את העלאת היומנים.
הגדרת פידים
כדי להגדיר פיד:
- עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמת SIEM בלבד, עוברים אל הגדרות > פידים.
- לוחצים על הוספת פיד חדש.
- בדף הבא, לוחצים על הגדרת פיד יחיד.
- בשדה Feed name, מזינים שם לפיד, לדוגמה Jenkins Logs.
- בוחרים באפשרות Google Cloud Storage V2 בתור סוג המקור.
- בוחרים באפשרות Jenkins בתור Log type.
- לוחצים על Get Service Account בתור Chronicle Service Account.
מציינים ערכים לפרמטרים הבאים של הקלט:
- Storage Bucket URI: כתובת ה-URL של הקטגוריה ב-Cloud Storage בפורמט
gs://my-bucket/<value>/. כתובת ה-URL הזו חייבת להסתיים בקו נטוי (/). - אפשרויות למחיקת מקור: בוחרים את אפשרות המחיקה הרצויה.
- Storage Bucket URI: כתובת ה-URL של הקטגוריה ב-Cloud Storage בפורמט
לוחצים על יצירת פיד.
טבלת מיפוי 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.