收集 Duo 使用者情境記錄

剖析器版本:1.0

支援的服務:

本文說明如何使用 API,將 Duo 使用者情境記錄擷取至 Google Security Operations。剖析器會處理 JSON 資料,將使用者資訊 (包括將使用者名稱別名對應至電子郵件地址、群組、電話號碼和裝置詳細資料) 對應至 UDM,並擷取使用者帳戶狀態。此外,這個剖析器也會處理巢狀資料結構,並執行多項資料轉換和合併作業,建立最終的 UDM 事件。

事前準備

請確認您符合下列必要條件:

設定 Admin API 應用程式並取得金鑰

  1. 以管理員身分登入 Duo 管理面板。
  2. 在左側欄中,依序點選「Applications」>「Manage Applications」。
  3. 按下「Add Application」按鈕。
  4. 在搜尋欄位中輸入 Admin API,然後按一下「Duo Admin API」旁邊的「Add」(新增)。
  5. 下一個畫面會顯示下列資訊:
    • 整合金鑰:(字串,例如 DIYYYYYYYYYYYYYY)。
    • Secret Key:40 個字元的字串。
    • API 主機名稱:例如 api-abcd1234.duosecurity.com。
  6. 複製「Integration Key」、「Secret Key」和「API hostname」,並儲存到安全的位置。
  7. 捲動至「設定」,然後將「權限」設為「授予讀取資源」。
  8. 按一下 [儲存變更]。

設定動態饋給

  1. 依序前往「設定」>「資料管理」>「動態饋給」。如果使用的是 SIEM 專用平台,請依序前往「設定」>「動態饋給」。
  2. 按一下「+ 新增動態饋給」。
  3. 在「Feed name」(動態饋給名稱) 欄位中,輸入動態饋給名稱 (例如 Duo Users Logs)。
  4. 在「Source type」(來源類型) 中選取「Third Party API」(第三方 API)。
  5. 選取「Duo User Context」記錄類型。
  6. 點選「下一步」。
  7. 指定下列輸入參數的值:
    • Username (使用者名稱):輸入先前複製的整合金鑰。
    • Secret:輸入先前複製的密鑰。
    • API 主機名稱:提供 Duo API 伺服器網址 (例如 api-abcd1234.duosecurity.com)。
    • Asset namespace:資產命名空間。
    • 擷取標籤:套用至這個動態饋給事件的標籤。
  8. 點選「下一步」。
  9. 在「完成」畫面中檢查動態饋給設定,然後按一下「提交」。

UDM 對應表

記錄欄位 UDM 對應 邏輯
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 值會直接從欄位中擷取。鍵設為「actor type」。
akey event.idm.entity.metadata.product_entity_id 系統會直接從欄位擷取值,如果 akey 為空白,則會擷取 sekey。
application event.idm.entity.entity.application 值會直接從欄位中擷取。
collection_time.seconds、create_time.seconds event.idm.entity.metadata.collected_timestamp.seconds、event.timestamp.seconds collected_timestamp.seconds 和頂層 timestamp.seconds 會使用 collection_time.seconds 和 create_time.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 值會直接從欄位中擷取。標籤的鍵設為「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 系統會直接從欄位擷取值,如果 username 為空白,則會擷取 surfaced_auth.user.key。
(剖析器邏輯) event.idm.entity.metadata.vendor_name 硬式編碼為「Duo」。
(剖析器邏輯) event.idm.entity.metadata.product_name 硬式編碼為「Duo User Context」。
(剖析器邏輯) 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」。
(剖析器邏輯) event.idm.entity.relations.entity_type 如果 phones[0] 不是空白,請設為「ASSET」。
(剖析器邏輯) event.idm.entity.relations.relationship 如果 phones[0] 不是空白,請設為「OWNS」。
(剖析器邏輯) event.idm.entity.relations.entity.asset.type 如果 phones[0] 不為空白,請設為「MOBILE」。

變更記錄

查看這個剖析器的變更記錄

還有其他問題嗎?向社群成員和 Google SecOps 專業人員尋求解答。