איסוף יומנים של 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
יצירת הפיד
- עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמת SIEM בלבד, עוברים אל הגדרות > פידים.
- לוחצים על הוספת פיד חדש.
- בדף הבא, לוחצים על הגדרת פיד יחיד.
- בשדה שם הפיד, מזינים שם לפיד (לדוגמה,
Keycloak Events). - בקטע Source type, בוחרים באפשרות Webhook.
- בוחרים באפשרות Keycloak בתור סוג היומן.
- לוחצים על הבא.
- מציינים ערכים לפרמטרים הבאים של הקלט:
- תו מפריד לפיצול (אופציונלי): מזינים
\nכדי לפצל אירועים עם כמה שורות (כל בקשת POST של תגובה לפעולה מאתר אחר מכילה אירוע אחד, אז אפשר להשאיר את השדה הזה ריק). - מרחב השמות של הנכס: מרחב השמות של הנכס
- תוויות הטמעה: התווית שתתווסף לאירועים מהפיד הזה
- תו מפריד לפיצול (אופציונלי): מזינים
- לוחצים על הבא.
- בודקים את הגדרות הפיד החדש במסך סיום ולוחצים על שליחה.
יצירה ושמירה של מפתח סודי
אחרי שיוצרים את הפיד, צריך ליצור מפתח סודי לאימות:
- בדף הפרטים של הפיד, לוחצים על יצירת מפתח סודי.
- תיפתח תיבת דו-שיח עם המפתח הסודי.
- מעתיקים ושומרים את המפתח הסודי באופן מאובטח.
חשוב: המפתח הסודי מוצג רק פעם אחת ואי אפשר לאחזר אותו מאוחר יותר. אם מאבדים אותו, צריך ליצור מפתח סודי חדש.
איך מקבלים את כתובת ה-URL של נקודת הקצה של הפיד
- עוברים לכרטיסייה פרטים של הפיד.
- בקטע Endpoint Information, מעתיקים את Feed endpoint URL.
הפורמט של כתובת ה-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>.שומרים את כתובת ה-URL הזו לשלבים הבאים.
לוחצים על סיום.
יצירת מפתח API של Google Cloud
כדי לבצע אימות ב-Chronicle, צריך מפתח API. יוצרים מפתח API מוגבל במסוף Google Cloud.
יצירת מפתח ה-API
- נכנסים לדף Credentials במסוף Google Cloud.
- בוחרים את הפרויקט (הפרויקט שמשויך למכונה שלכם ב-Chronicle).
- לוחצים על Create credentials > מפתח API.
- מפתח ה-API נוצר ומוצג בתיבת דו-שיח.
- לוחצים על Edit API key כדי להגביל את מפתח ה-API.
הגבלת מפתח ה-API
- בדף ההגדרות של מפתח ה-API:
- שם: מזינים שם תיאורי (לדוגמה,
Chronicle Webhook API Key)
- שם: מזינים שם תיאורי (לדוגמה,
- בקטע API restrictions:
- לוחצים על הגבלת המפתח.
- בתפריט הנפתח Select APIs, מחפשים ובוחרים את Google SecOps API (או Chronicle API).
- לוחצים על Save.
- מעתיקים את הערך של מפתח ה-API מהשדה API key שבחלק העליון של הדף.
- שומרים את מפתח ה-API בצורה מאובטחת.
הפעלת אחסון אירועים ב-Keycloak
לפני שמגדירים את תוסף ה-webhook, צריך להפעיל את אחסון האירועים ב-Keycloak כדי שהאירועים ייווצרו ויהיו זמינים להעברה.
הפעלת אירועי משתמשים
- נכנסים למסוף Admin של Keycloak.
- בתפריט הנפתח של התחום בפינה הימנית העליונה, בוחרים את התחום שרוצים לעקוב אחריו.
- עוברים אל Realm Settings > Events.
- בוחרים בכרטיסיית המשנה User events settings.
- מפעילים את המתג שמירת אירועים.
- מגדירים את תקופת התפוגה (המינימום המומלץ: 7 ימים).
- לוחצים על Save.
הפעלת אירועי אדמין
- באותה כרטיסייה, אירועים, בוחרים בכרטיסיית המשנה הגדרות של אירועי אדמין.
- מפעילים את המתג שמירת אירועים.
- מפעילים את המתג Include representation כדי לתעד את הפרטים המלאים של האובייקטים שהשתנו.
- מגדירים את תקופת התפוגה (המינימום המומלץ: 7 ימים).
- לוחצים על Save.
התקנת התוסף webhook רכיב event listener
Keycloak לא כולל רכיב event listener מקורי של webhook. מתקינים את התוסף keycloak-events מ-Phase Two (p2-inc) כדי להפעיל את העברת התגובות לפעולה מאתר אחר (webhook).
הורדה ופריסה של התוסף
מורידים את קובץ ה-JAR של הגרסה האחרונה מדף הגרסאות של keycloak-events ב-Maven Central או יוצרים מקובץ המקור:
git clone https://github.com/p2-inc/keycloak-events.git cd keycloak-events mvn clean installמעתיקים את קובץ ה-JAR שנוצר לספרייה
providersשל Keycloak:cp target/keycloak-events-*.jar /opt/keycloak/providers/בונים מחדש ומפעילים מחדש את Keycloak:
/opt/keycloak/bin/kc.sh build /opt/keycloak/bin/kc.sh start
הפעלת רכיב ה-event listener של ה-webhook
- נכנסים למסוף Admin של Keycloak.
- בוחרים את התחום הרצוי מהתפריט הנפתח של התחומים.
- עוברים אל Realm Settings > Events.
- בתפריט הנפתח Event listeners (רכיבי event listener), בוחרים באפשרות ext-event-webhook.
- לוחצים על 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 תומכים בכמה שיטות אימות. בוחרים את השיטה שבה הספק תומך.
שיטה 1: כותרות בהתאמה אישית (מומלץ)
אם הספק תומך בכותרות 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.