Humio
במאמר הזה מוסבר איך לשלב את Humio עם Google SecOps.
הגדרת השילוב של Humio ב-Google Security Operations
איך מגדירים שילובים ב-Google SecOps
פרמטרים של שילוב
כדי להגדיר את השילוב, משתמשים בפרמטרים הבאים:
| שם הפרמטר לתצוגה | סוג | ערך ברירת המחדל | חובה | תיאור |
|---|---|---|---|---|
| הרמה הבסיסית (root) של ה-API | String | https://cloud.us.humio.com | כן | שורש ה-API של המכונה של Humio. |
| טוקן API | סיסמה | לא רלוונטי | כן | טוקן ה-API של המכונה של Humio. |
| אימות SSL | תיבת סימון | סימן אישור | כן | אם ההגדרה מופעלת, צריך לוודא שאישור ה-SSL של החיבור לשרת Humio תקף. |
תרחישים לדוגמה
- הטמעת האירועים ממאגרים
- חיפוש
פעולות
פינג
תיאור
בודקים את הקישוריות ל-Humio באמצעות הפרמטרים שמופיעים בדף הגדרת השילוב ב-Google SecOps Content Hub.
פרמטרים
לא רלוונטי
ריצה
הפעולה הזו לא פועלת על ישויות, ואין לה פרמטרים של קלט חובה.
תוצאות הפעולה
תוצאת הסקריפט
| שם תוצאת הסקריפט | אפשרויות של ערכים | דוגמה |
|---|---|---|
| is_success | נכון/לא נכון | is_success:False |
קיר נרתיקים
| סוג התוצאות | ערך / תיאור | סוג |
|---|---|---|
| הודעת פלט* | הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק: אם החיבור הצליח: "החיבור לשרת Humio בוצע בהצלחה באמצעות פרמטרי החיבור שסופקו". הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק: אם התגובה נכשלה: "החיבור לשרת Humio נכשל. השגיאה היא {0}".format(exception.stacktrace) |
כללי |
ביצוע חיפוש פשוט
תיאור
חיפוש אירועים לפי פרמטרים ב-Humio.
פרמטרים
| שם הפרמטר לתצוגה | סוג | ערך ברירת המחדל | חובה | תיאור |
|---|---|---|---|---|
| שם המאגר | String | לא רלוונטי | כן | צריך לציין את שם המאגר שבו רוצים לחפש. |
| מסנן שאילתות | String | לא רלוונטי | לא | מציינים את השאילתה שצריך להריץ במהלך החיפוש. הערה: אין לספק את הפונקציות "head()" ו-"select()". |
| מסגרת זמן | DDL | בשעה האחרונה ערכים אפשריים:
|
לא | מציינים מסגרת זמן לתוצאות. אם בוחרים באפשרות "בהתאמה אישית", צריך לציין גם את הפרמטר "שעת התחלה". |
| שעת ההתחלה | String | לא רלוונטי | לא | מציינים את שעת ההתחלה של התוצאות. הפרמטר הזה הוא חובה אם בוחרים באפשרות "בהתאמה אישית" בפרמטר "מסגרת זמן". פורמט: ISO 8601 |
| שעת הסיום | String | לא רלוונטי | לא | מציינים את שעת הסיום של התוצאות. פורמט: ISO 8601. אם לא מציינים ערך ובוחרים באפשרות "בהתאמה אישית" בפרמטר "מסגרת זמן", הפרמטר הזה משתמש בשעה הנוכחית. |
| שדות להחזרה | CSV | לא רלוונטי | לא | מציינים את השדות שיוחזרו. אם לא מציינים שדות, הפעולה מחזירה את כל השדות. |
| שדה המיון | String | לא רלוונטי | לא | צריך לציין באיזה פרמטר להשתמש למיון. כברירת מחדל, השאילתה ממיינת את הנתונים לפי חותמת זמן בסדר עולה. |
| סוג שדה המיון | DDL | String ערכים אפשריים:
|
לא | מציינים את סוג השדה שמשמש למיון. הפרמטר הזה נדרש כדי להבטיח שהתוצאות שיוחזרו יהיו נכונות. |
| סדר המיון | DDL | ASC ערכים אפשריים:
|
לא | מציינים את סדר המיון. |
| מספר התוצאות המקסימלי שיוחזרו | מספר שלם | 50 | לא | מציינים את מספר התוצאות שרוצים לקבל. |
ריצה
הפעולה הזו לא פועלת על ישויות.
תוצאות הפעולה
תוצאת הסקריפט
| שם תוצאת הסקריפט | אפשרויות של ערכים | דוגמה |
|---|---|---|
| is_success | נכון/לא נכון | is_success:False |
תוצאת JSON
[
{
"@timestamp": 1636028056292,
"@rawstring": {
"actor": {
"ip": "31.43.227.151",
"orgRoot": false,
"organizationId": "z4ApqmrB7XbvsQB5E1muelI4WAKz4buZ",
"proxyRequest": false,
"type": "orgUser",
"user": {
"id": "MgPXnBAKQ4gCg25hW5jKhYTo",
"isRoot": false,
"username": "dana@example.com"
}
},
"method": "google",
"sensitive": false,
"timestamp": "2021-11-04T12:14:16.292Z",
"type": "user.signin"
},
"@id": "gZPMhXMMcScGXHwxZ7bRH6Ns_88_264_1636028056"
},
{
"@timestamp": 1636028057934,
"@rawstring": {
"actor": {
"ip": "31.43.227.151",
"orgRoot": false,
"organizationId": "z4ApqmrB7XbvsQB5E1muelI4WAKz4buZ",
"proxyRequest": false,
"type": "orgUser",
"user": {
"id": "MgPXnBAKQ4gCg25hW5jKhYTo",
"isRoot": false,
"username": "dana@example.com"
}
},
"sensitive": false,
"timestamp": "2021-11-04T12:14:17.934Z",
"type": "notifications.user.create"
},
"@id": "lSLLg2gMDW8GwHtpZTGD8GU1_65_108_1636028057"
}
]
קיר נרתיקים
| סוג התוצאות | ערך / תיאור | סוג |
|---|---|---|
| סוג התוצאות | ערך/תיאור | סוג |
| הודעת פלט* | הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק: אם נמצאה לפחות תוצאה אחת (is_success=true): "הוחזרו בהצלחה תוצאות לשאילתה "{query}" ב-Humio." אם לא נמצאו תוצאות (is_succees=true): "לא נמצאו תוצאות לשאילתה "{query}" ב-Humio". הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק: אם יש שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או בעיה אחרת: "Error executing action "Execute Simple Search". הסיבה: {0}''.format(error.Stacktrace) אם מדווח קוד הסטטוס 400: "Error executing action "Execute Simple Search". Reason: {0}''.format(response) אם מדווח קוד הסטטוס 404: "שגיאה בביצוע הפעולה 'ביצוע חיפוש בהתאמה אישית'. Reason: {0}''.format(response) |
כללי |
| קיר נרתיקים | שם: תוצאות | כללי |
הפעלת חיפוש בהתאמה אישית
תיאור
חיפוש אירועים באמצעות שאילתה מותאמת אישית ב-Humio.
פרמטרים
| שם הפרמטר לתצוגה | סוג | ערך ברירת המחדל | חובה | תיאור |
|---|---|---|---|---|
| שם המאגר | String | לא רלוונטי | כן | צריך לציין את שם המאגר שבו רוצים לחפש. |
| שאילתה | String | לא רלוונטי | כן | מציינים את השאילתה שצריך להריץ ב-Humio. הערה: הפונקציה "head()" לא צריכה להיות חלק מהמחרוזת הזו. |
| מספר התוצאות המקסימלי שיוחזרו | מספר שלם | 50 | לא | מציינים את מספר התוצאות שרוצים לקבל. |
ריצה
הפעולה הזו לא פועלת על ישויות.
תוצאות הפעולה
תוצאת הסקריפט
| שם תוצאת הסקריפט | אפשרויות של ערכים | דוגמה |
|---|---|---|
| is_success | נכון/לא נכון | is_success:False |
תוצאת JSON
[
{
"@timestamp": 1636028056292,
"@rawstring": {
"actor": {
"ip": "31.43.227.151",
"orgRoot": false,
"organizationId": "z4ApqmrB7XbvsQB5E1muelI4WAKz4buZ",
"proxyRequest": false,
"type": "orgUser",
"user": {
"id": "MgPXnBAKQ4gCg25hW5jKhYTo",
"isRoot": false,
"username": "dana@example.com"
}
},
"method": "google",
"sensitive": false,
"timestamp": "2021-11-04T12:14:16.292Z",
"type": "user.signin"
},
"@id": "gZPMhXMMcScGXHwxZ7bRH6Ns_88_264_1636028056"
},
{
"@timestamp": 1636028057934,
"@rawstring": {
"actor": {
"ip": "31.43.227.151",
"orgRoot": false,
"organizationId": "z4ApqmrB7XbvsQB5E1muelI4WAKz4buZ",
"proxyRequest": false,
"type": "orgUser",
"user": {
"id": "MgPXnBAKQ4gCg25hW5jKhYTo",
"isRoot": false,
"username": "dana@example.com"
}
},
"sensitive": false,
"timestamp": "2021-11-04T12:14:17.934Z",
"type": "notifications.user.create"
},
"@id": "lSLLg2gMDW8GwHtpZTGD8GU1_65_108_1636028057"
}
]
קיר נרתיקים
| סוג התוצאות | ערך / תיאור | סוג |
|---|---|---|
| הודעת פלט* | הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק: אם נמצאה לפחות תוצאה אחת (is_success=true): "הוחזרו בהצלחה תוצאות לשאילתה "{query}" ב-Humio". אם לא נמצאו תוצאות (is_succees=true): "לא נמצאו תוצאות לשאילתה "{query}" ב-Humio" הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק: אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "שגיאה בביצוע הפעולה 'ביצוע חיפוש בהתאמה אישית'. הסיבה: {0}''.format(error.Stacktrace) אם מדווח קוד הסטטוס 400: "שגיאה בביצוע הפעולה 'ביצוע חיפוש בהתאמה אישית'. הסיבה: {0}''.format(response) אם מדווח קוד הסטטוס 404: "שגיאה בביצוע הפעולה 'ביצוע חיפוש בהתאמה אישית'. Reason: {0}''.format(response) |
כללי |
| קיר נרתיקים | שם: תוצאות | כללי |
מחברים
Humio – מחבר אירועים
תיאור
שליפת מידע על אירועים במאגר מ-Humio.
הגדרת Humio – מחבר אירועים ב-Google SecOps
הוראות מפורטות להגדרת מחבר ב-Google SecOps מופיעות במאמר הגדרת המחבר.
פרמטרים של מחברים
כדי להגדיר את המחבר, משתמשים בפרמטרים הבאים:
| שם הפרמטר לתצוגה | סוג | ערך ברירת המחדל | חובה | תיאור |
|---|---|---|---|---|
| שם שדה המוצר | String | שם המוצר | כן | מזינים את שם השדה של המקור כדי לאחזר את שם השדה של המוצר. |
| שם השדה של האירוע | String | event_field | כן | מזינים את שם שדה המקור כדי לאחזר את שם שדה האירוע. |
| שם השדה של הסביבה | String | "" | לא | מתאר את שם השדה שבו מאוחסן שם הסביבה. אם שדה הסביבה לא נמצא, הסביבה היא סביבת ברירת המחדל. |
| תבנית ביטוי רגולרי של סביבה | String | .* | לא | תבנית של ביטוי רגולרי להפעלה על הערך שנמצא בשדה "שם השדה של הסביבה". ברירת המחדל היא .* כדי לכלול את הכול ולהחזיר את הערך ללא שינוי. משמש כדי לאפשר למשתמש לשנות את שדה הסביבה באמצעות לוגיקה של ביטויים רגולריים. אם תבנית הביטוי הרגולרי היא null או ריקה, או אם ערך הסביבה הוא null, תוצאת הסביבה הסופית היא סביבת ברירת המחדל. |
| זמן קצוב לתפוגה של סקריפט (בשניות) | מספר שלם | 360 | כן | מגבלת הזמן הקצוב לתהליך Python שמריץ את הסקריפט הנוכחי. |
| הרמה הבסיסית (root) של ה-API | String | https://cloud.us.humio.com | כן | שורש ה-API של המכונה של Humio. |
| טוקן API | סיסמה | לא רלוונטי | לא | טוקן ה-API של המכונה של Humio. |
| שם המאגר | String | לא רלוונטי | כן | שם המאגר שממנו יאוחזרו התוצאות. |
| שאילתה | String | לא רלוונטי | לא | שליחת שאילתה לגבי האירועים. הערה: אין להוסיף כאן את הפונקציות select() ו-head(). |
| שם שדה ההתראה | String | לא רלוונטי | לא | שם המפתח שצריך להשתמש בו בשביל שם ההתראה. אם לא צוין ערך או שצוין ערך לא חוקי, המחבר ישתמש ב-"Humio Alert" כברירת מחדל. |
| שם השדה "מידת החומרה" | CSV | לא רלוונטי | כן | רשימה מופרדת בפסיקים של מפתחות שצריך להשתמש בהם למיפוי של רמת החומרה. הערה: אם המפתח מכיל ערכי "מחרוזת", צריך למפות אותם באמצעות "מיפוי חומרת הבעיה ב-JSON". אם המפתח שצוין לא תקין, המערכת תשתמש בערך Default מהפרמטר Severity Mapping JSON. |
| קובץ JSON למיפוי חומרת הבעיה | JSON | { "fieldName": { "value_1": 100, "value_2": 75, "value_3": -1 }, "Default": 50 } |
כן | אובייקט JSON שמכיל את כל המפתחות עם ערכי מחרוזת ממופים. הערה: חובה להשתמש במפתח "Default". |
| מספר השעות המקסימלי אחורה | מספר שלם | 1 | לא | מספר השעות שמהן צריך לאחזר אירועים. |
| מספר האירועים המקסימלי לאחזור | מספר שלם | 20 | לא | כמה אירועים לעבד בכל איטרציה של מחבר. |
| שימוש ברשימת ההיתרים כרשימת חסימה | תיבת סימון | סימן אישור | כן | אם המדיניות מופעלת, רשימת ההיתרים תשמש כרשימת חסימה. |
| אימות SSL | תיבת סימון | סימן אישור | כן | אם ההגדרה מופעלת, המערכת מאמתת שאישור ה-SSL של החיבור ל-Humio תקין. |
| כתובת שרת ה-Proxy | String | לא רלוונטי | לא | הכתובת של שרת ה-Proxy שבו רוצים להשתמש. |
| שם המשתמש בשרת ה-proxy | String | לא רלוונטי | לא | שם המשתמש של שרת ה-proxy לאימות. |
| סיסמת שרת ה-Proxy | סיסמה | לא רלוונטי | לא | הסיסמה לאימות מול שרת ה-proxy. |
כללי מחברים
תמיכה בשרת proxy
המחבר תומך בשרת proxy.
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.