איסוף יומנים של Keycloak

נתמכים ב:

במאמר הזה מוסבר איך להגדיר את Keycloak כדי לשלוח יומנים ל-Google Security Operations באמצעות תגובות לפעולות אינטרנט.

‫Keycloak הוא פתרון בקוד פתוח לניהול זהויות והרשאות גישה (IAM) שמספק יכולות של כניסה יחידה (SSO), איחוד משתמשים, תיווך זהויות והתחברות באמצעות חשבון ברשת חברתית. הוא תומך בפרוטוקולים OpenID Connect,‏ OAuth 2.0 ו-SAML 2.0, ועוקב אחרי אירועי משתמשים (כניסה, יציאה, הרשמה, שינויי סיסמה) ואירועי אדמין (פעולות ניהול של משתמשים, לקוחות, תחומים ותפקידים) לצורך ביקורת אבטחה.

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

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

  • מכונה של Google SecOps
  • מופע פעיל של Keycloak (מומלץ להשתמש בגרסה 20 ואילך)
  • גישת אדמין למסוף Admin של Keycloak
  • גישה למערכת הקבצים או למאגר של שרת Keycloak כדי לפרוס תוספים
  • גישה למסוף Google Cloud (כדי ליצור מפתח API)

יצירת פיד של תגובה לפעולה מאתר אחר (webhook) ב-Google SecOps

יצירת הפיד

  1. עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמת SIEM בלבד, עוברים אל הגדרות > פידים.
  2. לוחצים על הוספת פיד חדש.
  3. בדף הבא, לוחצים על הגדרת פיד יחיד.
  4. בשדה שם הפיד, מזינים שם לפיד (לדוגמה, Keycloak Events).
  5. בקטע Source type, בוחרים באפשרות Webhook.
  6. בוחרים באפשרות Keycloak בתור סוג היומן.
  7. לוחצים על הבא.
  8. מציינים ערכים לפרמטרים הבאים של הקלט:
    • תו מפריד לפיצול (אופציונלי): מזינים \n כדי לפצל אירועים עם כמה שורות (כל בקשת POST של תגובה לפעולה מאתר אחר מכילה אירוע אחד, אז אפשר להשאיר את השדה הזה ריק).
    • מרחב השמות של הנכס: מרחב השמות של הנכס
    • תוויות הטמעה: התווית שתתווסף לאירועים מהפיד הזה
  9. לוחצים על הבא.
  10. בודקים את הגדרות הפיד החדש במסך סיום ולוחצים על שליחה.

יצירה ושמירה של מפתח סודי

אחרי שיוצרים את הפיד, צריך ליצור מפתח סודי לאימות:

  1. בדף הפרטים של הפיד, לוחצים על יצירת מפתח סודי.
  2. תיפתח תיבת דו-שיח עם המפתח הסודי.
  3. מעתיקים ושומרים את המפתח הסודי באופן מאובטח.

חשוב: המפתח הסודי מוצג רק פעם אחת ואי אפשר לאחזר אותו מאוחר יותר. אם מאבדים אותו, צריך ליצור מפתח סודי חדש.

איך מקבלים את כתובת ה-URL של נקודת הקצה של הפיד

  1. עוברים לכרטיסייה פרטים של הפיד.
  2. בקטע Endpoint Information, מעתיקים את Feed endpoint URL.
  3. הפורמט של כתובת ה-URL הוא:

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import
    

    כאשר {region} הוא האזור של המופע של Google SecOps (לדוגמה, us,‏ europe או asia-southeast1), ו-{parent} הוא נתיב המשאב בפורמט projects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.

  4. שומרים את כתובת ה-URL הזו לשלבים הבאים.

  5. לוחצים על סיום.

יצירת מפתח API של Google Cloud

כדי לבצע אימות ב-Chronicle, צריך מפתח API. יוצרים מפתח API מוגבל במסוף Google Cloud.

יצירת מפתח ה-API

  1. נכנסים לדף Credentials במסוף Google Cloud.
  2. בוחרים את הפרויקט (הפרויקט שמשויך למכונה שלכם ב-Chronicle).
  3. לוחצים על Create credentials > מפתח API.
  4. מפתח ה-API נוצר ומוצג בתיבת דו-שיח.
  5. לוחצים על Edit API key כדי להגביל את מפתח ה-API.

הגבלת מפתח ה-API

  1. בדף ההגדרות של מפתח ה-API:
    • שם: מזינים שם תיאורי (לדוגמה, Chronicle Webhook API Key)
  2. בקטע API restrictions:
    1. לוחצים על הגבלת המפתח.
    2. בתפריט הנפתח Select APIs, מחפשים ובוחרים את Google SecOps API (או Chronicle API).
  3. לוחצים על Save.
  4. מעתיקים את הערך של מפתח ה-API מהשדה API key שבחלק העליון של הדף.
  5. שומרים את מפתח ה-API בצורה מאובטחת.

הפעלת אחסון אירועים ב-Keycloak

לפני שמגדירים את תוסף ה-webhook, צריך להפעיל את אחסון האירועים ב-Keycloak כדי שהאירועים ייווצרו ויהיו זמינים להעברה.

הפעלת אירועי משתמשים

  1. נכנסים למסוף Admin של Keycloak.
  2. בתפריט הנפתח של התחום בפינה הימנית העליונה, בוחרים את התחום שרוצים לעקוב אחריו.
  3. עוברים אל Realm Settings > Events.
  4. בוחרים בכרטיסיית המשנה User events settings.
  5. מפעילים את המתג שמירת אירועים.
  6. מגדירים את תקופת התפוגה (המינימום המומלץ: 7 ימים).
  7. לוחצים על Save.

הפעלת אירועי אדמין

  1. באותה כרטיסייה, אירועים, בוחרים בכרטיסיית המשנה הגדרות של אירועי אדמין.
  2. מפעילים את המתג שמירת אירועים.
  3. מפעילים את המתג Include representation כדי לתעד את הפרטים המלאים של האובייקטים שהשתנו.
  4. מגדירים את תקופת התפוגה (המינימום המומלץ: 7 ימים).
  5. לוחצים על Save.

התקנת התוסף webhook רכיב event listener

‫Keycloak לא כולל רכיב event listener מקורי של webhook. מתקינים את התוסף keycloak-events מ-Phase Two‏ (p2-inc) כדי להפעיל את העברת התגובות לפעולה מאתר אחר (webhook).

הורדה ופריסה של התוסף

  1. מורידים את קובץ ה-JAR של הגרסה האחרונה מדף הגרסאות של keycloak-events ב-Maven Central או יוצרים מקובץ המקור:

    git clone https://github.com/p2-inc/keycloak-events.git
    cd keycloak-events
    mvn clean install
    
  2. מעתיקים את קובץ ה-JAR שנוצר לספרייה providers של Keycloak:

    cp target/keycloak-events-*.jar /opt/keycloak/providers/
    
  3. בונים מחדש ומפעילים מחדש את Keycloak:

    /opt/keycloak/bin/kc.sh build
    /opt/keycloak/bin/kc.sh start
    

הפעלת רכיב ה-event listener של ה-webhook

  1. נכנסים למסוף Admin של Keycloak.
  2. בוחרים את התחום הרצוי מהתפריט הנפתח של התחומים.
  3. עוברים אל Realm Settings > Events.
  4. בתפריט הנפתח Event listeners (רכיבי event listener), בוחרים באפשרות ext-event-webhook.
  5. לוחצים על Save.

הגדרת תגובה לפעולה מאתר אחר (webhook) ב-Keycloak

יצירת כתובת ה-URL של ה-webhook

  • משלבים את כתובת ה-URL של נקודת הקצה (endpoint) של Chronicle ואת מפתח ה-API:

    <ENDPOINT_URL>?key=<API_KEY>
    
  • לדוגמה:

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...
    

יצירת מינוי ל-webhook באמצעות API בארכיטקטורת REST של Keycloak

התוסף keycloak-events מספק נקודות קצה (endpoints) של REST לניהול מינויים ל-webhook. משתמשים ב-Keycloak Admin API בארכיטקטורת REST כדי ליצור webhook.

שלב 1: מקבלים טוקן גישה

  • מבקשים אסימון גישה מ-Keycloak באמצעות חשבון אדמין:

    TOKEN=$(curl -sS -X POST "https://<KEYCLOAK_HOST>/realms/master/protocol/openid-connect/token" \
      -H "Content-Type: application/x-www-form-urlencoded" \
      --data-urlencode "grant_type=password" \
      --data-urlencode "client_id=admin-cli" \
      --data-urlencode "username=<ADMIN_USERNAME>" \
      --data-urlencode "password=<ADMIN_PASSWORD>" \
      | sed -n 's/.*"access_token":"\([^"]*\)".*/\1/p')
    

מחליפים את מה שכתוב בשדות הבאים:

  • ‫<KEYCLOAK_HOST>: שם המארח והיציאה של שרת Keycloak (לדוגמה, keycloak.example.com:8443)
  • ‫<ADMIN_USERNAME>: שם המשתמש של האדמין ב-Keycloak
  • ‫<ADMIN_PASSWORD>: סיסמת האדמין של Keycloak

שלב 2: יוצרים את ה-webhook

  • שולחים בקשת POST כדי ליצור את המינוי ל-webhook לתחום היעד:

    curl -sS -X POST "https://<KEYCLOAK_HOST>/realms/<REALM_NAME>/webhooks" \
      -H "Authorization: Bearer ${TOKEN}" \
      -H "Content-Type: application/json" \
      -d '{
        "enabled": "true",
        "url": "<ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>",
        "secret": "<WEBHOOK_HMAC_SECRET>",
        "eventTypes": ["*"]
      }'
    

מחליפים את מה שכתוב בשדות הבאים:

  • ‫<KEYCLOAK_HOST>: שם המארח של שרת Keycloak
  • ‫<REALM_NAME>: שם התחום שרוצים לעקוב אחריו (לדוגמה, master או my-realm)
  • ‫<ENDPOINT_URL>: כתובת ה-URL של נקודת הקצה של הפיד ב-Chronicle שהעתקתם קודם
  • ‫<API_KEY>: מפתח ה-API של Google Cloud שנוצר קודם לכן
  • ‫<SECRET_KEY>: המפתח הסודי של ה-webhook ב-Chronicle שנוצר קודם לכן
  • ‫<WEBHOOK_HMAC_SECRET>: מחרוזת סודית שרירותית לחתימת HMAC של מטענים ייעודיים (payloads) של webhook (לדוגמה, mySecretKey123)

שלב 3: מאמתים את ה-webhook

  • כדי לוודא שה-webhook נוצר, מציגים את כל ה-webhooks של התחום:

    curl -sS -X GET "https://<KEYCLOAK_HOST>/realms/<REALM_NAME>/webhooks" \
      -H "Authorization: Bearer ${TOKEN}" \
      -H "Accept: application/json"
    

התגובה מחזירה רשימה של אובייקטים של webhook. מוודאים שה-webhook מופיע עם "enabled": "true" וכתובת ה-URL הנכונה.

סוגי אירועים של תגובה לפעולה מאתר אחר (webhook)

השדה eventTypes מקבל מערך של ביטויים כדי לסנן את האירועים שנשלחים:

  • * — שליחת כל האירועים (מומלץ לשילוב עם SIEM)
  • ‫access.* — שליחת כל אירועי הגישה
  • ‫admin.* — שליחת כל אירועי האדמין
  • ‫admin.USER-* – שליחת כל אירועי האדמין שקשורים למשתמשים
  • ‫admin-USER-CREATE — שליחה של אירועי אדמין שקשורים ליצירת משתמשים בלבד

איך פועל הניסיון החוזר של ה-webhook

התוסף משתמש בהשהיה מעריכית לפני ניסיון חוזר (exponential backoff) אוטומטית לניסיונות חוזרים כשמתקבלת תגובה שהיא לא 2xx:

פרמטר ערך ברירת המחדל תיאור
backoffInitialInterval ‫500 אלפיות השנייה מרווח הזמן הראשוני לניסיון חוזר
backoffMaxElapsedTime ‫900,000 אלפיות השנייה (15 דקות) משך הזמן המקסימלי הכולל לניסיונות חוזרים
backoffMaxInterval ‫180,000 אלפיות השנייה (3 דקות) המרווח המקסימלי בין ניסיונות חוזרים
backoffMultiplier 5 מכפיל לכל מרווח זמן בין ניסיונות חוזרים
backoffRandomizationFactor 0.5 גורם אקראיות לריצוד

מידע על שיטות אימות

פידים של תגובות לפעילות אינטרנט ב-Chronicle תומכים בכמה שיטות אימות. בוחרים את השיטה שבה הספק תומך.

אם הספק תומך בכותרות HTTP בהתאמה אישית, כדאי להשתמש בשיטה הזו כדי לשפר את האבטחה.

  • פורמט הבקשה:

    POST <ENDPOINT_URL> HTTP/1.1
    Content-Type: application/json
    x-goog-chronicle-auth: <API_KEY>
    x-chronicle-auth: <SECRET_KEY>
    
    {
            "event": "data",
            "timestamp": "2025-01-15T10:30:00Z"
    }
    

יתרונות:

  • מפתח ה-API והסוד לא גלויים בכתובת ה-URL
  • מאובטח יותר (הכותרות לא מתועדות ביומני הגישה של שרת האינטרנט)
  • השיטה המועדפת כשהספק תומך בה

שיטה 2: פרמטרים של שאילתה

אם הספק לא תומך בכותרות בהתאמה אישית, צריך להוסיף את פרטי הכניסה לכתובת ה-URL.

  • פורמט כתובת ה-URL:

    <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>
    
  • לדוגמה:

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
    
  • פורמט הבקשה:

    POST <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY> HTTP/1.1
    Content-Type: application/json
    
    {
            "event": "data",
            "timestamp": "2025-01-15T10:30:00Z"
    }
    

החסרונות:

  • פרטי כניסה שגלויים בכתובת ה-URL
  • יכול להיות שהם יתועדו ביומני הגישה של שרת האינטרנט
  • פחות מאובטח מכותרות

שיטה 3: משולבת (כתובת URL + כותרת)

בחלק מההגדרות, מפתח ה-API נמצא בכתובת ה-URL והמפתח הסודי נמצא בכותרת.

  • פורמט הבקשה:

    POST <ENDPOINT_URL>?key=<API_KEY> HTTP/1.1
    Content-Type: application/json
    x-chronicle-auth: <SECRET_KEY>
    
    {
            "event": "data",
            "timestamp": "2025-01-15T10:30:00Z"
    }
    

שמות של כותרות אימות

‫Chronicle מקבל את שמות הכותרות הבאים לאימות:

למפתח API:

  • x-goog-chronicle-auth (מומלץ)
  • X-Goog-Chronicle-Auth (לא תלוי-רישיות)

למפתח סודי:

  • x-chronicle-auth (מומלץ)
  • X-Chronicle-Auth (לא תלוי-רישיות)

מגבלות ושיטות מומלצות לשימוש ב-webhook

מגבלות על בקשות

הגבלה ערך
גודל בקשה מקסימלי 4 MB
מספר מקסימלי של שאילתות לשנייה (QPS) 15,000
פסק זמן לבקשה ‫30 שניות
התנהגות של ניסיון חוזר אוטומטי עם השהיה מעריכית לפני ניסיון חוזר (exponential backoff)

דוגמאות ליומנים נתמכים

הדוגמאות הבאות מציגות יומני JSON של Keycloak שהמנתח שמוגדר כברירת מחדל ממפה לסוגי אירועים של Unified Data Model ‏(UDM):

  • אירוע התחברות של משתמש (USER_LOGIN)

    {
      "timestamp": "2024-10-12T15:10:04.123456789Z",
      "log_type": "KEYCLOAK",
      "uuid": "dummy_user_01",
      "read_timestamp": "2024-10-12T15:10:04Z",
      "source_timestamp": "2024-10-12T15:10:04.123456781Z",
      "object": "synth_object_01",
      "read_method": "synth_read_method_01",
      "stream_name": "synth_stream_name_01",
      "schema_key": "synth_schema_key_01",
      "sort_keys": "synth_sort_keys_01",
      "source_metadata": {
        "schema": "synth_schema_01",
        "table": "synth_table_01",
        "is_deleted": true,
        "change_type": "synth_change_type_01",
        "tx_id": "synth_tx_id_01",
        "lsn": "synth_lsn_01",
        "primary_keys": "synth_primary_keys_01"
      },
      "payload": {
        "id": "synth_id_01",
        "client_id": "synth_client_id_01",
        "error": "synth_error_01",
        "ip_address": "1.1.1.1",
        "realm_id": "synth_realm_id_01",
        "session_id": "synth_session_id_01",
        "event_time": "2024-10-12T15:10:04Z",
        "type": "LOGIN",
        "user_id": "dummy_user_01",
        "details_json": "{\"uuid\":\"dummy_user_01\",\"read_timestamp\":\"2024-10-12T15:10:04Z\",\"source_timestamp\":\"2024-10-12T15:10:04.123456781Z\",\"object\":\"synth_object_01\",\"read_method\":\"synth_read_method_01\",\"stream_name\":\"synth_stream_name_01\",\"schema_key\":\"synth_schema_key_01\",\"sort_keys\":\"synth_sort_keys_01\",\"username\":\"dummy_user_01\",\"redirect_uri\":\"synth_redirect_uri_01\",\"st\":\"synth_st_01\",\"refresh_token_id\":\"synth_refresh_token_id_01\",\"token_id\":\"synth_token_id_01\",\"environnement\":\"synth_environnement_01\",\"status_code\":\"200\",\"parameters\":{}}"
      },
      "username": "dummy_user_01",
      "redirect_uri": "synth_redirect_uri_01",
      "ctx": {
        "actionId": "synth_actionId_01",
        "clientId": "synth_clientId_01",
        "executionId": "synth_executionId_01",
        "host": "host-01.dummy.net",
        "ip": "1.1.1.1",
        "messageId": "dummy_user_01@dummy.net",
        "process": "synth_process_01",
        "realmId": "synth_realmId_01",
        "referer": "synth_referer_01",
        "requestId": "synth_requestId_01",
        "sessionId": "synth_sessionId_01",
        "source": "synth_source_01",
        "trackerId": "synth_trackerId_01",
        "uri": "synth_uri_01",
        "userAgent": "dummy_user_01",
        "userId": "dummy_user_01",
        "username": "dummy_user_01"
      },
      "env": {
        "application": "synth_application_01",
        "instance": "synth_instance_01",
        "st": "synth_st_01"
      },
      "st": "synth_st_01",
      "refresh_token_id": "synth_refresh_token_id_01",
      "token_id": "synth_token_id_01",
      "environnement": "synth_environnement_01",
      "status_code": "200",
      "events": [
        {
          "typeEv": "LOGIN",
          "message": "HTTP 200 Found"
        }
      ]
    }
    
  • אירוע התנתקות של משתמש (USER_LOGOUT)

    {
      "timestamp": "2024-10-12T16:17:17.123456789Z",
      "log_type": "KEYCLOAK",
      "uuid": "dummy_admin_02",
      "read_timestamp": "2024-10-12T16:17:17Z",
      "source_timestamp": "2024-10-12T16:17:17.123456782Z",
      "object": "synth_object_02",
      "read_method": "synth_read_method_02",
      "stream_name": "synth_stream_name_02",
      "schema_key": "synth_schema_key_02",
      "sort_keys": "synth_sort_keys_02",
      "source_metadata": {
        "schema": "synth_schema_02",
        "table": "synth_table_02",
        "is_deleted": false,
        "change_type": "synth_change_type_02",
        "tx_id": "synth_tx_id_02",
        "lsn": "synth_lsn_02",
        "primary_keys": "synth_primary_keys_02"
      },
      "payload": {
        "id": "synth_id_02",
        "client_id": "synth_client_id_02",
        "error": "synth_error_02",
        "ip_address": "1.1.1.2",
        "realm_id": "synth_realm_id_02",
        "session_id": "synth_session_id_02",
        "event_time": "2024-10-12T16:17:17Z",
        "user_id": "dummy_admin_02",
        "details_json": "{\"parameters\":{}}"
      },
      "username": "dummy_admin_02",
      "redirect_uri": "synth_redirect_uri_02",
      "ctx": {
        "actionId": "synth_actionId_02",
        "clientId": "synth_clientId_02",
        "executionId": "synth_executionId_02",
        "host": "gw-edge-02.dummy.net",
        "ip": "1.1.1.2",
        "messageId": "dummy_admin_02@dummy.net",
        "process": "synth_process_02",
        "realmId": "synth_realmId_02",
        "referer": "synth_referer_02",
        "requestId": "synth_requestId_02",
        "sessionId": "synth_sessionId_02",
        "source": "synth_source_02",
        "trackerId": "synth_trackerId_02",
        "uri": "synth_uri_02",
        "userAgent": "dummy_admin_02",
        "userId": "dummy_admin_02",
        "username": "dummy_admin_02"
      },
      "env": {
        "application": "synth_application_02",
        "instance": "synth_instance_02",
        "st": "synth_st_02"
      },
      "st": "synth_st_02",
      "refresh_token_id": "synth_refresh_token_id_02",
      "token_id": "synth_token_id_02",
      "environnement": "synth_environnement_02",
      "status_code": "200",
      "events": [
        {
          "typeEv": "LOGOUT",
          "message": "HTTP 302 Found"
        }
      ]
    }
    
  • אירוע גישה של משתמש למשאב (USER_RESOURCE_ACCESS)

    {
      "timestamp": "2024-10-12T17:24:30.123456789Z",
      "log_type": "KEYCLOAK",
      "uuid": "dummy_svc_03",
      "read_timestamp": "2024-10-12T17:24:30Z",
      "source_timestamp": "2024-10-12T17:24:30.123456783Z",
      "object": "synth_object_03",
      "read_method": "synth_read_method_03",
      "stream_name": "synth_stream_name_03",
      "schema_key": "synth_schema_key_03",
      "sort_keys": "synth_sort_keys_03",
      "source_metadata": {
        "schema": "synth_schema_03",
        "table": "synth_table_03",
        "is_deleted": true,
        "change_type": "synth_change_type_03",
        "tx_id": "synth_tx_id_03",
        "lsn": "synth_lsn_03",
        "primary_keys": "synth_primary_keys_03"
      },
      "payload": {
        "id": "synth_id_03",
        "client_id": "synth_client_id_03",
        "error": "synth_error_03",
        "ip_address": "1.1.1.3",
        "realm_id": "synth_realm_id_03",
        "session_id": "synth_session_id_03",
        "event_time": "2024-10-12T17:24:30Z",
        "user_id": "dummy_svc_03",
        "details_json": "{\"parameters\":{}}"
      },
      "username": "dummy_svc_03",
      "redirect_uri": "synth_redirect_uri_03",
      "ctx": {
        "actionId": "synth_actionId_03",
        "clientId": "synth_clientId_03",
        "executionId": "synth_executionId_03",
        "host": "auth-srv-03.dummy.net",
        "ip": "1.1.1.3",
        "messageId": "dummy_svc_03@dummy.net",
        "process": "synth_process_03",
        "realmId": "synth_realmId_03",
        "referer": "synth_referer_03",
        "requestId": "synth_requestId_03",
        "sessionId": "synth_sessionId_03",
        "source": "synth_source_03",
        "trackerId": "synth_trackerId_03",
        "uri": "synth_uri_03",
        "userAgent": "dummy_svc_03",
        "userId": "dummy_svc_03",
        "username": "dummy_svc_03"
      },
      "env": {
        "application": "synth_application_03",
        "instance": "synth_instance_03",
        "st": "synth_st_03"
      },
      "st": "synth_st_03",
      "refresh_token_id": "synth_refresh_token_id_03",
      "token_id": "synth_token_id_03",
      "environnement": "synth_environnement_03",
      "status_code": "200",
      "events": [
        {
          "typeEv": "USER_INFO_REQUEST",
          "message": "HTTP 401 Found"
        }
      ]
    }
    
  • אירוע של חיבור לרשת (NETWORK_CONNECTION)

    {
      "timestamp": "2024-10-12T18:31:43.123456789Z",
      "log_type": "KEYCLOAK",
      "uuid": "dummy_auditor_04",
      "read_timestamp": "2024-10-12T18:31:43Z",
      "source_timestamp": "2024-10-12T18:31:43.123456784Z",
      "object": "synth_object_04",
      "read_method": "synth_read_method_04",
      "stream_name": "synth_stream_name_04",
      "schema_key": "synth_schema_key_04",
      "sort_keys": "synth_sort_keys_04",
      "source_metadata": {
        "schema": "synth_schema_04",
        "table": "synth_table_04",
        "is_deleted": false,
        "change_type": "synth_change_type_04",
        "tx_id": "synth_tx_id_04",
        "lsn": "synth_lsn_04",
        "primary_keys": "synth_primary_keys_04"
      },
      "payload": {
        "id": "synth_id_04",
        "client_id": "synth_client_id_04",
        "error": "synth_error_04",
        "ip_address": "1.1.1.4",
        "realm_id": "synth_realm_id_04",
        "session_id": "synth_session_id_04",
        "event_time": "2024-10-12T18:31:43Z",
        "user_id": "dummy_auditor_04",
        "details_json": "{\"parameters\":{}}"
      },
      "username": "dummy_auditor_04",
      "redirect_uri": "synth_redirect_uri_04",
      "ctx": {
        "actionId": "synth_actionId_04",
        "clientId": "synth_clientId_04",
        "executionId": "synth_executionId_04",
        "host": "db-node-04.dummy.net",
        "ip": "1.1.1.4",
        "messageId": "dummy_auditor_04@dummy.net",
        "process": "synth_process_04",
        "realmId": "synth_realmId_04",
        "referer": "synth_referer_04",
        "requestId": "synth_requestId_04",
        "sessionId": "synth_sessionId_04",
        "source": "synth_source_04",
        "trackerId": "synth_trackerId_04",
        "uri": "synth_uri_04",
        "userAgent": "dummy_auditor_04",
        "userId": "dummy_auditor_04",
        "username": "dummy_auditor_04"
      },
      "env": {
        "application": "synth_application_04",
        "instance": "synth_instance_04",
        "st": "synth_st_04"
      },
      "st": "synth_st_04",
      "refresh_token_id": "synth_refresh_token_id_04",
      "token_id": "synth_token_id_04",
      "environnement": "synth_environnement_04",
      "status_code": "200",
      "events": [
        {
          "message": "HTTP 403 Found",
          "typeEv": ""
        }
      ]
    }
    
  • אירוע עדכון סטטוס (STATUS_UPDATE)

    {
      "timestamp": "2024-10-12T19:38:56.123456789Z",
      "log_type": "KEYCLOAK",
      "uuid": "dummy_analyst_05",
      "read_timestamp": "2024-10-12T19:38:56Z",
      "source_timestamp": "2024-10-12T19:38:56.123456785Z",
      "object": "synth_object_05",
      "read_method": "synth_read_method_05",
      "stream_name": "synth_stream_name_05",
      "schema_key": "synth_schema_key_05",
      "sort_keys": "synth_sort_keys_05",
      "source_metadata": {
        "schema": "synth_schema_05",
        "table": "synth_table_05",
        "is_deleted": true,
        "change_type": "synth_change_type_05",
        "tx_id": "synth_tx_id_05",
        "lsn": "synth_lsn_05",
        "primary_keys": "synth_primary_keys_05"
      },
      "payload": {
        "id": "synth_id_05",
        "client_id": "synth_client_id_05",
        "error": "synth_error_05",
        "ip_address": "1.1.1.5",
        "realm_id": "synth_realm_id_05",
        "session_id": "synth_session_id_05",
        "event_time": "2024-10-12T19:38:56Z",
        "user_id": "dummy_analyst_05",
        "details_json": "{\"parameters\":{}}"
      },
      "username": "dummy_analyst_05",
      "redirect_uri": "synth_redirect_uri_05",
      "ctx": {
        "actionId": "synth_actionId_05",
        "clientId": "synth_clientId_05",
        "executionId": "synth_executionId_05",
        "ip": "1.1.1.5",
        "messageId": "dummy_analyst_05@dummy.net",
        "process": "synth_process_05",
        "realmId": "synth_realmId_05",
        "referer": "synth_referer_05",
        "requestId": "synth_requestId_05",
        "sessionId": "synth_sessionId_05",
        "source": "synth_source_05",
        "trackerId": "synth_trackerId_05",
        "uri": "synth_uri_05",
        "userAgent": "dummy_analyst_05",
        "userId": "dummy_analyst_05",
        "username": "dummy_analyst_05"
      },
      "env": {
        "application": "synth_application_05",
        "instance": "synth_instance_05",
        "st": "synth_st_05"
      },
      "st": "synth_st_05",
      "refresh_token_id": "synth_refresh_token_id_05",
      "token_id": "synth_token_id_05",
      "environnement": "synth_environnement_05",
      "status_code": "200",
      "events": [
        {
          "message": "HTTP 404 Found",
          "typeEv": ""
        }
      ]
    }
    
  • אירוע משתמש ללא שיוך לקטגוריה (USER_UNCATEGORIZED)

    {
      "timestamp": "2024-10-12T20:45:09.123456789Z",
      "log_type": "KEYCLOAK",
      "uuid": "dummy_user_01",
      "read_timestamp": "2024-10-12T20:45:09Z",
      "source_timestamp": "2024-10-12T20:45:09.123456786Z",
      "object": "synth_object_06",
      "read_method": "synth_read_method_06",
      "stream_name": "synth_stream_name_06",
      "schema_key": "synth_schema_key_06",
      "sort_keys": "synth_sort_keys_06",
      "source_metadata": {
        "schema": "synth_schema_06",
        "table": "synth_table_06",
        "is_deleted": false,
        "change_type": "synth_change_type_06",
        "tx_id": "synth_tx_id_06",
        "lsn": "synth_lsn_06",
        "primary_keys": "synth_primary_keys_06"
      },
      "payload": {
        "id": "synth_id_06",
        "client_id": "synth_client_id_06",
        "error": "synth_error_06",
        "realm_id": "synth_realm_id_06",
        "session_id": "synth_session_id_06",
        "event_time": "2024-10-12T20:45:09Z",
        "user_id": "dummy_user_01",
        "details_json": "{\"parameters\":{}}"
      },
      "username": "dummy_user_01",
      "redirect_uri": "synth_redirect_uri_06",
      "ctx": {
        "actionId": "synth_actionId_06",
        "clientId": "synth_clientId_06",
        "executionId": "synth_executionId_06",
        "host": "host-01.dummy.net",
        "messageId": "dummy_user_01@dummy.net",
        "process": "synth_process_06",
        "realmId": "synth_realmId_06",
        "referer": "synth_referer_06",
        "requestId": "synth_requestId_06",
        "sessionId": "synth_sessionId_06",
        "source": "synth_source_06",
        "trackerId": "synth_trackerId_06",
        "uri": "synth_uri_06",
        "userAgent": "dummy_user_01",
        "userId": "dummy_user_01",
        "username": "dummy_user_01"
      },
      "env": {
        "application": "synth_application_06",
        "instance": "synth_instance_06",
        "st": "synth_st_06"
      },
      "st": "synth_st_06",
      "refresh_token_id": "synth_refresh_token_id_06",
      "token_id": "synth_token_id_06",
      "environnement": "synth_environnement_06",
      "status_code": "200",
      "events": [
        {
          "message": "HTTP 200 Found",
          "typeEv": ""
        }
      ]
    }
    
  • אירוע כללי (GENERIC_EVENT)

    {
      "timestamp": "2024-10-12T21:52:22.123456789Z",
      "log_type": "KEYCLOAK",
      "read_timestamp": "2024-10-12T21:52:22Z",
      "source_timestamp": "2024-10-12T21:52:22.123456787Z",
      "object": "synth_object_07",
      "read_method": "synth_read_method_07",
      "stream_name": "synth_stream_name_07",
      "schema_key": "synth_schema_key_07",
      "sort_keys": "synth_sort_keys_07",
      "source_metadata": {
        "schema": "synth_schema_07",
        "table": "synth_table_07",
        "is_deleted": true,
        "change_type": "synth_change_type_07",
        "tx_id": "synth_tx_id_07",
        "lsn": "synth_lsn_07",
        "primary_keys": "synth_primary_keys_07"
      },
      "payload": {
        "id": "synth_id_07",
        "client_id": "synth_client_id_07",
        "error": "synth_error_07",
        "realm_id": "synth_realm_id_07",
        "session_id": "synth_session_id_07",
        "event_time": "2024-10-12T21:52:22Z",
        "user_id": "dummy_admin_02",
        "details_json": "{\"parameters\":{}}"
      },
      "username": "dummy_admin_02",
      "redirect_uri": "synth_redirect_uri_07",
      "ctx": {
        "actionId": "synth_actionId_07",
        "clientId": "synth_clientId_07",
        "executionId": "synth_executionId_07",
        "host": "gw-edge-02.dummy.net",
        "messageId": "dummy_admin_02@dummy.net",
        "process": "synth_process_07",
        "realmId": "synth_realmId_07",
        "referer": "synth_referer_07",
        "requestId": "synth_requestId_07",
        "sessionId": "synth_sessionId_07",
        "source": "synth_source_07",
        "trackerId": "synth_trackerId_07",
        "uri": "synth_uri_07",
        "userAgent": "dummy_admin_02",
        "userId": "dummy_admin_02"
      },
      "env": {
        "application": "synth_application_07",
        "instance": "synth_instance_07",
        "st": "synth_st_07"
      },
      "st": "synth_st_07",
      "refresh_token_id": "synth_refresh_token_id_07",
      "token_id": "synth_token_id_07",
      "environnement": "synth_environnement_07",
      "status_code": "200",
      "events": [
        {
          "message": "HTTP 302 Found",
          "typeEv": ""
        }
      ]
    }
    

טבלת מיפוי UDM

שדה ביומן מיפוי UDM היגיון
payload.client_id additional.fields מוזג עם שדות שנוצרו מ-payload.client_id, ‏ payload.realm_id
payload.realm_id additional.fields
source_timestamp metadata.event_timestamp מנותח באמצעות מסנן תאריכים עם התבניות ISO8601 ו-yyyy-MM-dd'T'HH:mm:ss.SSSZ
payload.ip_address metadata.event_type צריך להגדיר את הערך STATUS_UPDATE אם payload.ip_address לא ריק, אחרת צריך להגדיר את הערך USER_UNCATEGORIZED אם uuid לא ריק, אחרת צריך להגדיר את הערך GENERIC_EVENT
uuid metadata.event_type
payload.type metadata.product_event_type הערך הועתק ישירות
payload.session_id network.session_id הערך הועתק ישירות
payload.ip_address principal.ip הערך הועתק ישירות
source_metadata.schema principal.resource.attribute.labels מוזג עם תוויות שנוצרו מ-source_metadata.schema, ‏ source_metadata.table, ‏ source_metadata.is_deleted (הומר למחרוזת), source_metadata.change_type, ‏ source_metadata.tx_id, ‏ source_metadata.lsn
source_metadata.table principal.resource.attribute.labels
source_metadata.is_deleted principal.resource.attribute.labels
source_metadata.change_type principal.resource.attribute.labels
source_metadata.tx_id principal.resource.attribute.labels
source_metadata.lsn principal.resource.attribute.labels
uuid principal.user.userid הערך הועתק ישירות
אובייקט security_result.detection_fields מוזג עם תוויות שנוצרו מ-object, ‏ read_method, ‏ payload.id
read_method security_result.detection_fields
payload.id security_result.detection_fields
redirect_uri target.url הערך הועתק ישירות
שם משתמש target.user.userid הערך הועתק ישירות
metadata.product_name metadata.product_name מגדירים את הערך KEYCLOAK.
metadata.vendor_name metadata.vendor_name מגדירים את הערך KEYCLOAK.
username" from "details_json target.user.userid מופה מיומן השינויים
redirect_uri" from "details_json target.url מופה מיומן השינויים
realm_id" and "client_id additional.fields מופה מיומן השינויים

יומן שינויים

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

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