איסוף יומני הקשר של משתמשי Duo

גרסת המנתח: 1.0

נתמך ב:

במאמר הזה מוסבר איך להטמיע ב-Google Security Operations יומני הקשר של משתמשי Duo באמצעות API. המנתח מעבד נתוני JSON, ממפה את פרטי המשתמשים (כולל כינויים של שמות משתמשים לכתובות אימייל, קבוצות, מספרי טלפון ופרטי מכשירים) ל-UDM ומתעד את סטטוס חשבון המשתמש. הוא גם מטפל במבני נתונים בתצוגת עץ ומבצע כמה טרנספורמציות ומיזוגים של נתונים כדי ליצור את אירוע ה-UDM הסופי.

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

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

הגדרת האפליקציה של Admin API וקבלת המפתחות

  1. נכנסים לחלונית הניהול של Duo כאדמינים.
  2. בסרגל הצד שמימין, לוחצים על Applications (אפליקציות) > Manage Applications (ניהול אפליקציות).
  3. לוחצים על הכפתור Add Application.
  4. בשדה החיפוש, מקלידים Admin API ולוחצים על הוספה לצד Duo Admin API.
  5. במסך הבא, מוצג המידע הבא:
    • מפתח שילוב: (מחרוזת כמו DIYYYYYYYYYYYYYY).
    • מפתח סודי: מחרוזת של 40 תווים.
    • שם המארח של ה-API: לדוגמה, api-abcd1234.duosecurity.com.
  6. מעתיקים ושומרים את מפתח השילוב, המפתח הסודי ושם המארח של ה-API במיקום מאובטח.
  7. גוללים אל הגדרות ומגדירים את הרשאות להענקת הרשאת קריאה למשאב.
  8. לוחצים על שמירת השינויים.

הגדרת פידים

  1. עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פידים.
  2. לוחצים על + הוספת פיד חדש.
  3. בשדה שם הפיד, מזינים שם לפיד (לדוגמה, Duo Users Logs).
  4. בוחרים באפשרות API של צד שלישי בתור סוג המקור.
  5. בוחרים את סוג היומן Duo User Context.
  6. לוחצים על הבא.
  7. מציינים ערכים לפרמטרים הבאים של הקלט:
    • שם משתמש: מזינים את מפתח השילוב שהעתקתם קודם.
    • סוד: מזינים את המפתח הסודי שהעתקתם קודם.
    • שם המארח של ה-API: מזינים את כתובת ה-URL של שרת Duo API (לדוגמה, api-abcd1234.duosecurity.com).
    • מרחב השמות של הנכס: מרחב השמות של הנכס.
    • תוויות הטמעה: התווית שנוספה לאירועים מהפיד הזה.
  8. לוחצים על הבא.
  9. בודקים את הגדרות הפיד במסך סיום ולוחצים על שליחה.

טבלת מיפוי 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.