איסוף יומני הקשר של משתמשי Duo
גרסת המנתח: 1.0
במאמר הזה מוסבר איך להטמיע ב-Google Security Operations יומני הקשר של משתמשי Duo באמצעות API. המנתח מעבד נתוני JSON, ממפה את פרטי המשתמשים (כולל כינויים של שמות משתמשים לכתובות אימייל, קבוצות, מספרי טלפון ופרטי מכשירים) ל-UDM ומתעד את סטטוס חשבון המשתמש. הוא גם מטפל במבני נתונים בתצוגת עץ ומבצע כמה טרנספורמציות ומיזוגים של נתונים כדי ליצור את אירוע ה-UDM הסופי.
לפני שמתחילים
חשוב לוודא שיש לכם את הדברים הבאים:
- מופע של Google SecOps
- גישה עם הרשאות לחלונית הניהול של Duo
הגדרת האפליקציה של Admin API וקבלת המפתחות
- נכנסים לחלונית הניהול של Duo כאדמינים.
- בסרגל הצד שמימין, לוחצים על Applications (אפליקציות) > Manage Applications (ניהול אפליקציות).
- לוחצים על הכפתור Add Application.
- בשדה החיפוש, מקלידים Admin API ולוחצים על הוספה לצד Duo Admin API.
- במסך הבא, מוצג המידע הבא:
- מפתח שילוב: (מחרוזת כמו
DIYYYYYYYYYYYYYY). - מפתח סודי: מחרוזת של 40 תווים.
- שם המארח של ה-API: לדוגמה,
api-abcd1234.duosecurity.com.
- מפתח שילוב: (מחרוזת כמו
- מעתיקים ושומרים את מפתח השילוב, המפתח הסודי ושם המארח של ה-API במיקום מאובטח.
- גוללים אל הגדרות ומגדירים את הרשאות להענקת הרשאת קריאה למשאב.
- לוחצים על שמירת השינויים.
הגדרת פידים
- עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פידים.
- לוחצים על + הוספת פיד חדש.
- בשדה שם הפיד, מזינים שם לפיד (לדוגמה,
Duo Users Logs). - בוחרים באפשרות API של צד שלישי בתור סוג המקור.
- בוחרים את סוג היומן Duo User Context.
- לוחצים על הבא.
- מציינים ערכים לפרמטרים הבאים של הקלט:
- שם משתמש: מזינים את מפתח השילוב שהעתקתם קודם.
- סוד: מזינים את המפתח הסודי שהעתקתם קודם.
- שם המארח של ה-API: מזינים את כתובת ה-URL של שרת Duo API (לדוגמה,
api-abcd1234.duosecurity.com). - מרחב השמות של הנכס: מרחב השמות של הנכס.
- תוויות הטמעה: התווית שנוספה לאירועים מהפיד הזה.
- לוחצים על הבא.
- בודקים את הגדרות הפיד במסך סיום ולוחצים על שליחה.
טבלת מיפוי UDM
| שדה ביומן | מיפוי UDM | Logic (פונקציה לוגית) |
|---|---|---|
access_device.browser |
event.idm.entity.entity.resource.attribute.labels.value |
הערך נלקח ישירות מהשדה access_device.browser או מהשדה surfaced_auth.access_device.browser אם השדה הראשון ריק. המפתח מוגדר כ-"access_device browser". |
access_device.browser_version |
event.idm.entity.entity.resource.attribute.labels.value |
הערך נלקח ישירות מהשדה access_device.browser_version או מהשדה surfaced_auth.access_device.browser_version אם השדה הראשון ריק. המפתח מוגדר בתור "access_device browser_version". |
access_device.ip.address |
event.idm.entity.entity.ip |
הערך נלקח ישירות מהשדה access_device.ip.address או מהשדה surfaced_auth.access_device.ip אם השדה הראשון ריק. |
access_device.location.city |
event.idm.entity.entity.location.city |
הערך נלקח ישירות מהשדה access_device.location.city או מהשדה surfaced_auth.access_device.location.city אם השדה הראשון ריק. |
access_device.location.country |
event.idm.entity.entity.location.country_or_region |
הערך נלקח ישירות מהשדה access_device.location.country או מהשדה surfaced_auth.access_device.location.country אם השדה הראשון ריק. |
access_device.location.state |
event.idm.entity.entity.location.state |
הערך נלקח ישירות מהשדה access_device.location.state או מהשדה surfaced_auth.access_device.location.state אם השדה הראשון ריק. |
access_device.os |
event.idm.entity.entity.asset.platform_software.platform |
הערך נגזר מהשדה access_device.os או מהשדה surfaced_auth.access_device.os אם השדה הראשון ריק. אם הערך תואם (לא תלוי-רישיות) ל-"ios" או ל-"mac", שדה ה-UDM מוגדר כ-"MAC". אם הוא תואם ל-"windows", השדה ב-UDM מוגדר ל-"WINDOWS". אם הוא תואם ל-"linux", השדה ב-UDM מוגדר כ-"LINUX". |
access_device.os_version |
event.idm.entity.entity.asset.platform_software.platform_version |
הערך נלקח ישירות מהשדה access_device.os_version או מהשדה surfaced_auth.access_device.os_version אם השדה הראשון ריק. |
action.details |
event.idm.entity.sec_result.action_details |
הערך נלקח מהשדה הזה אם השדה action ריק. |
action.name |
event.idm.entity.sec_result.detection_fields.value |
הערך נלקח ישירות מהשדה. המפתח מוגדר כ-"action_name". |
activity_id |
event.idm.entity.sec_result.detection_fields.value |
הערך נלקח ישירות מהשדה. המפתח מוגדר בתור activity_id. |
actor.details.created |
event.idm.entity.entity.user.attribute.labels.value |
הערך נלקח ישירות מהשדה. המפתח מוגדר כ-"created". |
actor.details.email |
event.idm.entity.entity.user.email_addresses |
הערך נלקח ישירות מהשדה. |
actor.details.groups.key |
event.idm.entity.entity.user.group_identifiers |
הערך נלקח ישירות מהשדה. |
actor.details.groups.name |
event.idm.entity.entity.user.group_identifiers |
הערך נלקח ישירות מהשדה. |
actor.details.last_login |
event.idm.entity.entity.user.attribute.labels.value |
הערך נלקח ישירות מהשדה. המפתח מוגדר בתור last_login. |
actor.details.status |
event.idm.entity.entity.user.attribute.labels.value |
הערך נלקח ישירות מהשדה. המפתח מוגדר כ-"status". |
actor.key |
event.idm.entity.entity.resource.product_object_id |
הערך נלקח ישירות מהשדה. |
actor.name |
event.idm.entity.entity.user.user_display_name |
הערך נלקח ישירות מהשדה או מ-surfaced_auth.user.name אם השדה ריק. |
actor.type |
event.idm.entity.entity.user.attribute.labels.value |
הערך נלקח ישירות מהשדה. המפתח מוגדר כ "סוג השחקן". |
akey |
event.idm.entity.metadata.product_entity_id |
הערך נלקח ישירות מהשדה, או מהשדה sekey אם השדה akey ריק. |
application |
event.idm.entity.entity.application |
הערך נלקח ישירות מהשדה. |
collection_time.seconds, create_time.seconds |
event.idm.entity.metadata.collected_timestamp.seconds, event.timestamp.seconds |
הערך הגבוה יותר מבין collection_time.seconds ו-create_time.seconds משמש גם ל-collected_timestamp.seconds וגם ל-timestamp.seconds ברמה העליונה. |
collection_time.nanos, create_time.nanos |
event.idm.entity.metadata.collected_timestamp.nanos, event.timestamp.nanos |
ערך הננו-שניות שתואם לערך הגבוה יותר מבין collection_time.seconds ו-create_time.seconds משמש גם ל-collected_timestamp.nanos וגם ל-timestamp.nanos ברמה העליונה. |
email |
event.idm.entity.entity.user.email_addresses |
הערך נלקח ישירות מהשדה. |
explanations |
event.idm.entity.entity.resource.attribute.labels |
צמדי המפתח/ערך בכל אובייקט במערך explanations מומרים לתוויות. המפתח של כל תווית מתחיל ב-"explanation ". |
firstname |
event.idm.entity.entity.user.first_name |
הערך נלקח ישירות מהשדה. |
from_common_netblock |
event.idm.entity.entity.resource.attribute.labels.value |
הערך נלקח ישירות מהשדה. המפתח מוגדר כ-"from_common_netblock". |
from_new_user |
event.idm.entity.entity.resource.attribute.labels.value |
הערך נלקח ישירות מהשדה. המפתח מוגדר בתור from_new_user. |
groups.N.name (N=0..10) |
event.idm.entity.entity.user.group_identifiers |
הערך נלקח ישירות מהשדה. |
lastname |
event.idm.entity.entity.user.last_name |
הערך נלקח ישירות מהשדה. |
low_risk_ip |
event.idm.entity.entity.resource.attribute.labels.value |
הערך נלקח ישירות מהשדה. המפתח מוגדר כ-"low_risk_ip". |
phones.0.model |
event.idm.entity.relations.entity.asset.hardware.model |
הערך נלקח ישירות מהשדה. |
phones.0.number |
event.idm.entity.entity.user.phone_numbers |
הערך נלקח ישירות מהשדה. |
phones.0.phone_id |
event.idm.entity.relations.entity.asset.product_object_id |
הערך נלקח ישירות מהשדה. |
phones.0.platform |
event.idm.entity.relations.entity.asset.hardware.manufacturer |
הערך נלקח ישירות מהשדה. |
priority_event |
event.idm.entity.entity.resource.attribute.labels.value |
הערך נלקח ישירות מהשדה. המפתח מוגדר כ-"priority_event". |
realname |
event.idm.entity.entity.user.user_display_name |
הערך נלקח ישירות מהשדה. |
sekey |
event.idm.entity.metadata.product_entity_id |
אם השדה akey ריק, הערך נלקח ישירות מהשדה. |
state |
event.idm.entity.entity.resource.attribute.labels.value |
הערך נלקח ישירות מהשדה. המפתח מוגדר בתור state. |
status |
event.idm.entity.entity.user.attribute.labels.value, event.idm.entity.entity.user.user_authentication_status |
הערך נלקח ישירות מהשדה. המפתח של התווית מוגדר כ "סטטוס". הערך משמש גם לקביעת user_authentication_status. הערכים "active" ו-"bypass" ממופים ל-"ACTIVE", הערכים "disabled" ו-"pending deletion" ממופים ל-"SUSPENDED", והערך "locked out" ממופה ל-"NO_ACTIVE_CREDENTIALS". |
surfaced_auth.access_device.browser |
event.idm.entity.entity.resource.attribute.labels.value |
הערך נלקח מהשדה הזה אם השדה access_device.browser ריק. המפתח מוגדר לערך "surfaced_auth access_device browser". |
surfaced_auth.access_device.browser_version |
event.idm.entity.entity.resource.attribute.labels.value |
הערך נלקח מהשדה הזה אם השדה access_device.browser_version ריק. המפתח מוגדר לערך "surfaced_auth access_device browser_version". |
surfaced_auth.access_device.ip |
event.idm.entity.entity.ip |
הערך נלקח מהשדה הזה אם השדה access_device.ip.address ריק. |
surfaced_auth.access_device.location.city |
event.idm.entity.entity.location.city |
הערך נלקח מהשדה הזה אם השדה access_device.location.city ריק. |
surfaced_auth.access_device.location.country |
event.idm.entity.entity.location.country_or_region |
הערך נלקח מהשדה הזה אם השדה access_device.location.country ריק. |
surfaced_auth.access_device.location.state |
event.idm.entity.entity.location.state |
הערך נלקח מהשדה הזה אם השדה access_device.location.state ריק. |
surfaced_auth.access_device.os |
event.idm.entity.entity.asset.platform_software.platform |
הערך נלקח מהשדה הזה אם השדה access_device.os ריק. הלוגיקה של המיפוי לשדה ה-UDM זהה לזו של access_device.os. |
surfaced_auth.access_device.os_version |
event.idm.entity.entity.asset.platform_software.platform_version |
הערך נלקח מהשדה הזה אם השדה access_device.os_version ריק. |
surfaced_auth.user.key |
event.idm.entity.entity.user.userid |
הערך נלקח מהשדה הזה אם השדה username ריק. |
surfaced_auth.user.name |
event.idm.entity.entity.user.user_display_name |
הערך נלקח מהשדה הזה אם השדה actor.name ריק. |
target.details.biometrics_status |
event.idm.entity.entity.asset.attribute.labels.value |
הערך נלקח ישירות מהשדה. המפתח מוגדר בתור biometrics_status. |
target.details.country_code |
event.idm.entity.entity.asset.attribute.labels.value |
הערך נלקח ישירות מהשדה. המפתח מוגדר בתור country_code. |
target.details.extension |
event.idm.entity.entity.asset.attribute.labels.value |
הערך נלקח ישירות מהשדה. המפתח מוגדר כ-"extension". |
target.details.manufacturer |
event.idm.entity.entity.asset.hardware.manufacturer |
הערך נלקח ישירות מהשדה. |
target.details.model |
event.idm.entity.entity.asset.hardware.model |
הערך נלקח ישירות מהשדה. |
target.details.number |
event.idm.entity.entity.user.phone_numbers |
הערך נלקח ישירות מהשדה. |
target.details.os |
event.idm.entity.entity.asset.software.name |
הערך נלקח ישירות מהשדה. |
target.details.os_version |
event.idm.entity.entity.asset.software.version |
הערך נלקח ישירות מהשדה. |
target.details.passcode_status |
event.idm.entity.entity.asset.attribute.labels.value |
הערך נלקח ישירות מהשדה. המפתח מוגדר בתור "passcode_status". |
target.details.tampered_status |
event.idm.entity.entity.asset.attribute.labels.value |
הערך נלקח ישירות מהשדה. המפתח מוגדר כ-"tampered_status". |
target.key |
event.idm.entity.entity.asset.asset_id |
הערך נלקח ישירות מהשדה. |
target.name |
event.idm.entity.entity.asset.attribute.labels.value |
הערך נלקח ישירות מהשדה. המפתח מוגדר כ-"name". |
target.type |
event.idm.entity.entity.asset.attribute.labels.value |
הערך נלקח ישירות מהשדה. המפתח מוגדר כ-"type". |
triage_event_uri |
event.idm.entity.entity.url |
הערך נלקח ישירות מהשדה. |
triaged_as_interesting |
event.idm.entity.entity.resource.attribute.labels.value |
הערך נלקח ישירות מהשדה. המפתח מוגדר כ-"triaged_as_interesting". |
ts |
event.timestamp.seconds, event.idm.entity.metadata.collected_timestamp.seconds |
אם השדה הזה קיים, חותמת הזמן מנותחת ממנו בפורמט ISO8601 או RFC 3339. השניות והננו-שניות שחולצו משמשות גם ל-timestamp ברמה העליונה וגם ל-collected_timestamp. |
type |
event.idm.entity.entity.resource.attribute.labels.value |
הערך נלקח ישירות מהשדה. המפתח מוגדר כ-"type". |
user_id |
event.idm.entity.metadata.product_entity_id |
הערך נלקח ישירות מהשדה. |
username |
event.idm.entity.entity.user.userid |
הערך נלקח ישירות מהשדה, או מהשדה surfaced_auth.user.key אם השדה username ריק. |
| (Parser Logic) | event.idm.entity.metadata.vendor_name |
מקודד בתוך הקוד כ-"Duo". |
| (Parser Logic) | event.idm.entity.metadata.product_name |
מקודד באופן קשיח ל-"Duo User Context". |
| (Parser Logic) | event.idm.entity.metadata.entity_type |
נקבע על סמך הנוכחות של שדות אחרים. אם המדיניות user_present מוגדרת כ-True, היא מוגדרת כ-USER. אם הערך של asset_mid_present הוא True, הוא מוגדר כ-"ASSET". אם המדיניות ip_present מוגדרת כ-True, הערך שלה הוא IP_ADDRESS. אם הערך של resource_present הוא True, הוא מוגדר כ-RESOURCE. אחרת, הוא מוגדר כ-"UNKNOWN_ENTITYTYPE". |
| (Parser Logic) | event.idm.entity.relations.entity_type |
צריך להגדיר את הערך "ASSET" אם השדה phones[0] לא ריק. |
| (Parser Logic) | event.idm.entity.relations.relationship |
צריך להגדיר את הערך "OWNS" אם השדה phones[0] לא ריק. |
| (Parser Logic) | event.idm.entity.relations.entity.asset.type |
צריך להגדיר את הערך "MOBILE" אם העמודה phones[0] לא ריקה. |
יומן שינויים
הצגת יומן השינויים של המנתח הזה
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.