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 תקף.

תרחישים לדוגמה

  1. הטמעת האירועים ממאגרים
  2. חיפוש

פעולות

פינג

תיאור

בודקים את הקישוריות ל-Humio באמצעות הפרמטרים שמופיעים בדף הגדרת השילוב ב-Google SecOps Content Hub.

פרמטרים

לא רלוונטי

ריצה

הפעולה הזו לא פועלת על ישויות, ואין לה פרמטרים של קלט חובה.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
קיר נרתיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם החיבור הצליח: "החיבור לשרת Humio בוצע בהצלחה באמצעות פרמטרי החיבור שסופקו".

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם התגובה נכשלה: "החיבור לשרת Humio נכשל. השגיאה היא {0}".format(exception.stacktrace)

כללי

תיאור

חיפוש אירועים לפי פרמטרים ב-Humio.

פרמטרים

שם הפרמטר לתצוגה סוג ערך ברירת המחדל חובה תיאור
שם המאגר String לא רלוונטי כן צריך לציין את שם המאגר שבו רוצים לחפש.
מסנן שאילתות String לא רלוונטי לא

מציינים את השאילתה שצריך להריץ במהלך החיפוש.

הערה: אין לספק את הפונקציות "head()‎" ו-"select()‎".

מסגרת זמן DDL

בשעה האחרונה

ערכים אפשריים:

  • בשעה האחרונה
  • 6 השעות האחרונות
  • ‫24 השעות האחרונות
  • בשבוע שעבר
  • בחודש שעבר
  • בהתאמה אישית
לא

מציינים מסגרת זמן לתוצאות.

אם בוחרים באפשרות "בהתאמה אישית", צריך לציין גם את הפרמטר "שעת התחלה".

שעת ההתחלה String לא רלוונטי לא

מציינים את שעת ההתחלה של התוצאות.

הפרמטר הזה הוא חובה אם בוחרים באפשרות "בהתאמה אישית" בפרמטר "מסגרת זמן".

פורמט: ISO 8601

שעת הסיום String לא רלוונטי לא

מציינים את שעת הסיום של התוצאות.

פורמט: ISO 8601.

אם לא מציינים ערך ובוחרים באפשרות "בהתאמה אישית" בפרמטר "מסגרת זמן", הפרמטר הזה משתמש בשעה הנוכחית.

שדות להחזרה CSV לא רלוונטי לא

מציינים את השדות שיוחזרו.

אם לא מציינים שדות, הפעולה מחזירה את כל השדות.

שדה המיון String לא רלוונטי לא

צריך לציין באיזה פרמטר להשתמש למיון.

כברירת מחדל, השאילתה ממיינת את הנתונים לפי חותמת זמן בסדר עולה.

סוג שדה המיון DDL

String

ערכים אפשריים:

  • String
  • מספר
  • הקסדצימלי
לא

מציינים את סוג השדה שמשמש למיון.

הפרמטר הזה נדרש כדי להבטיח שהתוצאות שיוחזרו יהיו נכונות.

סדר המיון DDL

ASC

ערכים אפשריים:

  • ASC
  • DESC
לא מציינים את סדר המיון.
מספר התוצאות המקסימלי שיוחזרו מספר שלם 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.