收集 Okta 使用者情境記錄

支援的服務:

本文說明如何使用第三方 API 設定 Google Security Operations 動態饋給,藉此收集 Okta 使用者情境記錄。

事前準備

請確認您已完成下列事前準備:

  • Google SecOps 執行個體
  • Okta 租戶或管理控制台的特殊權限存取權
  • Okta 的 API 權杖建立權限

設定 IP 許可清單

如果貴組織依 IP 位址限制 Okta API 權杖,您可以在 Okta 建立專屬 IP 區域,繫結至 Google SecOps API 權杖。如果貴組織不需要對 API 權杖設定 IP 限制,可以略過本節,並在建立 API 權杖時選取「Any IP」。

將 IP 範圍新增至 Okta IP 區域 (選用)

  1. 登入 Okta 管理控制台。
  2. 依序前往「Security」(安全性) >「Networks」(網路)。
  3. 依序點選「新增區域」>「IP 區域」。
  4. 輸入區域的描述性名稱 (例如 Google SecOps API Token Zone)。
  5. 在「Gateway IPs」欄位中,以 CIDR 標記法新增從「IP 許可清單」取得的 IP 範圍。
  6. 將「Trusted Proxy IPs」欄位留空。請勿在此新增 Google IP 範圍,因為 Okta 會將信任的 Proxy 視為 ThreatInsight 信任的 Proxy。
  7. 確認未勾選「封鎖來自符合此區域所列條件的 IP 的存取要求」。
  8. 按一下「儲存」。

儲存 IP 區域後:

  • 驗證 ThreatInsight 豁免項目:依序前往「Security」>「General」>「Okta ThreatInsight settings」,確認「Exempt Zones」下方未列出新建立的區域。
  • 檢查政策:確認現有的使用者登入政策、全域工作階段政策或其他 API 權杖,都不符合「In zone: All Zones」或「In any network zone defined in Okta」等廣泛條件,因為這些條件適用於貴組織定義的所有區域。

設定 Okta User Context API 存取權

如要讓 Google SecOps 提取使用者比對內容資料,您必須建立具備讀取的權限的 API 權杖。

建立 API 權杖

  1. 登入 Okta 管理控制台。
  2. 依序前往「安全性」>「API」。
  3. 選取「權杖」分頁標籤。
  4. 按一下「Create Token」。
  5. 提供下列設定詳細資料:
    • 名稱:輸入描述性名稱 (例如 Google SecOps Integration)。
    • 使用這個權杖發出的 API 呼叫必須來自:
      • 選取「Any IP」(如果未建立 IP 區域,建議選取這個選項),或
      • 選取「在下列任一區域」,然後選擇您為這個 API 權杖建立的專屬 IP 區域。請勿選取「In any network zone defined in Okta」。
  6. 按一下「Create Token」。

記錄 API 憑證

建立 API 權杖後,您會收到下列憑證:

  • API 權杖:API 權杖值 (例如 00QCGr-1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1)

必要的 API 權限

API 權杖在 Okta 中需要下列權限:

權限/角色 存取層級 目的
唯讀管理員 讀取 存取使用者個人資料
超級管理員 讀取 完整存取所有使用者資料

設定動態饋給

如要設定動態饋給,請按照下列步驟操作:

  1. 依序前往「設定」>「資料管理」>「動態饋給」。如果使用的是 SIEM 專用平台,請依序前往「設定」>「動態饋給」。
  2. 按一下「新增動態饋給」。
  3. 在下一頁,點按「設定單一動態饋給」。
  4. 在「Feed name」(動態饋給名稱) 欄位中,輸入動態饋給名稱 (例如 Okta User Context)。
  5. 在「Source type」(來源類型) 中選取「Third party API」(第三方 API)。
  6. 選取「Okta User Context」做為「Log type」。
  7. 點選「下一步」。
  8. 指定下列輸入參數的值:

    • 驗證 HTTP 標頭:請按照下列格式輸入驗證憑證:

      Authorization:SSWS your-api-token
      
      • 例如:Authorization:SSWS 00QCGr-1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1
    • API 主機名稱:Okta 執行個體的完整網域名稱 (例如 example.okta.com,而非任何可能設定的自訂網域)。

      • 例如:company.okta.com
    • Manager ID Reference Field:使用非 Okta ID 參照主管時,必須提供這個 ID (選填)。

    • Asset namespace:資產命名空間。

    • 擷取標籤:要套用至這個動態饋給事件的標籤。

  9. 點選「下一步」。

  10. 在「完成」畫面中檢查新的新聞動態消息設定,然後按一下「提交」。

設定完成後,動態饋給就會開始從 Okta User Context 執行個體擷取記錄,並依時間順序排列。

地區端點

Okta 會根據貴組織所在區域,使用不同的 API 端點:

區域 基準網址/主機名稱
美國 (預設) {org-name}.okta.com
歐盟 (歐洲、中東和非洲地區) {org-name}.okta-emea.com
APAC {org-name}.okta.com.au
預先發布版 (測試) {org-name}.oktapreview.com

請使用與 Okta 執行個體區域對應的主機名稱。

API 頻率限制

Okta API 的頻率限制如下:

  • 預設頻率限制:大多數端點每分鐘 600 個要求
  • System Log API:每分鐘 60 項要求
  • 使用者端點:每分鐘 600 項要求

Google SecOps 會自動以指數輪詢方式處理頻率限制。如有任何問題,請與 Okta 支援團隊聯絡,提高 API 限制。

UDM 對應表

記錄欄位 UDM 對應 邏輯
activated event.idm.entity.entity.labels 如果 activated 存在,系統會將其值新增為鍵/值組合,並將鍵設為「activated」。
created event.idm.entity.entity.labels 如果 created 存在,系統會將其值新增為鍵/值組合,並將鍵設為「created」。
profile.costCenter event.idm.entity.entity.labels 如果 profile.costCenter 存在,系統會將其值新增為鍵/值組合,並以「costCenter」做為鍵。
profile.Function event.idm.entity.entity.labels 如果 profile.Function 存在,其值會新增為鍵/值組合,鍵為「Function」。
statusChanged event.idm.entity.entity.labels 如果 statusChanged 存在,系統會將其值新增為鍵/值組合,並將鍵設為「statusChanged」。
type.id event.idm.entity.entity.labels 如果 type.id 存在,系統會將其值新增為鍵/值組合,鍵為「type_id」。
profile.location event.idm.entity.entity.location.name 值取自 profile.location。
profile.AD_ObjectGUID event.idm.entity.entity.user.attribute.labels 如果 profile.AD_ObjectGUID 存在,系統會將其值新增為鍵/值組合,並將鍵設為「AD_ObjectGUID」。
profile.ADpwdLastSet event.idm.entity.entity.user.attribute.labels 如果 profile.ADpwdLastSet 存在,其值會新增為鍵/值組合,鍵為「ADpwdLastSet」。
profile.AFF_Code event.idm.entity.entity.user.attribute.labels 如果 profile.AFF_Code 存在,系統會將其值新增為鍵/值組合,並以「AFF_Code」做為鍵。
profile.Desk_Location_WD event.idm.entity.entity.user.attribute.labels 如果 profile.Desk_Location_WD 存在,其值會新增為鍵/值組合,鍵為「Desk_Location_WD」。
profile.Mailing_Address_WD event.idm.entity.entity.user.attribute.labels 如果 profile.Mailing_Address_WD 存在,系統會將其值新增為鍵/值組合,鍵為「Mailing_Address_WD」。
profile.Manager_UPN event.idm.entity.entity.user.attribute.labels 如果 profile.Manager_UPN 存在,系統會將其值新增為鍵/值組合,並將鍵設為「Manager_UPN」。
profile.PRIVATE_CONF_Profile event.idm.entity.entity.user.attribute.labels 如果 profile.PRIVATE_CONF_Profile 存在,系統會將其值新增為鍵/值組合,並將鍵設為「PRIVATE_CONF_Profile」。
profile.Region_WD event.idm.entity.entity.user.attribute.labels 如果 profile.Region_WD 存在,系統會將其值新增為鍵/值組合,鍵為「Region_WD」。
profile.Subsidiary_Company event.idm.entity.entity.user.attribute.labels 如果 profile.Subsidiary_Company 存在,系統會將其值新增為鍵/值組合,並將鍵設為「Subsidiary_Company」。
profile.Telephone_Work event.idm.entity.entity.user.attribute.labels 如果 profile.Telephone_Work 存在,系統會將其值新增為鍵/值組合,鍵為「Telephone_Work」。
profile.Temp_WD_Primary_Email event.idm.entity.entity.user.attribute.labels 如果 profile.Temp_WD_Primary_Email 存在,系統會將其值新增為鍵/值組合,並使用「Temp_WD_Primary_Email」做為鍵。
profile.VMware_WS1_Username event.idm.entity.entity.user.attribute.labels 如果 profile.VMware_WS1_Username 存在,系統會將其值新增為鍵/值組合,並將鍵設為「VMware_WS1_Username」。
profile.Work_Street_Address_WD event.idm.entity.entity.user.attribute.labels 如果 profile.Work_Street_Address_WD 存在,系統會將其值新增為鍵/值組合,鍵為「Work_Street_Address_WD」。
profile.Workato_WD_Primary_Email event.idm.entity.entity.user.attribute.labels 如果 profile.Workato_WD_Primary_Email 存在,系統會將其值新增為鍵/值組合,鍵為「Workato_WD_Primary_Email」。
profile.Workday_ID event.idm.entity.entity.user.attribute.labels 如果 profile.Workday_ID 存在,系統會將其值新增為鍵/值組合,並以「Workday_ID」做為鍵。
profile.Worker_Type_WD event.idm.entity.entity.user.attribute.labels 如果 profile.Worker_Type_WD 存在,系統會將其值新增為鍵/值組合,鍵為「Worker_Type_WD」。
profile.businessUnit event.idm.entity.entity.user.attribute.labels 如果 profile.businessUnit 存在,其值會新增為鍵/值組合,鍵為「businessUnit」。
profile.companyName event.idm.entity.entity.user.attribute.labels 如果 profile.companyName 存在,系統會將其值新增為鍵/值組合,並將鍵設為「companyName」。
profile.contingentSupplierName event.idm.entity.entity.user.attribute.labels 如果 profile.contingentSupplierName 存在,其值會新增為鍵/值組合,鍵為「contingentSupplierName」。
profile.conversationId event.idm.entity.entity.user.attribute.labels 如果 profile.conversationId 存在,系統會將其值新增為鍵/值組合,鍵為「conversationId」。
profile.distinguishedName event.idm.entity.entity.user.attribute.labels 如果 profile.distinguishedName 存在,系統會將其值新增為鍵/值組合,並將鍵設為「distinguishedName」。
profile.division event.idm.entity.entity.user.attribute.labels 如果 profile.division 存在,系統會將其值新增為鍵/值組合,並將鍵設為「division」。
profile.emailPrefix event.idm.entity.entity.user.attribute.labels 如果 profile.emailPrefix 存在,系統會將其值新增為鍵/值組合,並以「emailPrefix」做為鍵。
profile.employeeType event.idm.entity.entity.user.attribute.labels 如果 profile.employeeType 存在,系統會將其值新增為鍵/值組合,鍵為「employeeType」。
profile.homePostalAddress event.idm.entity.entity.user.attribute.labels 如果 profile.homePostalAddress 存在,系統會將其值新增為鍵/值組合,並將鍵設為「homePostalAddress」。
profile.isManager event.idm.entity.entity.user.attribute.labels 如果 profile.isManager 存在,系統會將其值新增為鍵/值組合,並將鍵設為「isManager」。
lastLogin event.idm.entity.entity.user.attribute.labels 如果 lastLogin 存在,系統會將其值新增為鍵/值組合,並將鍵設為「lastLogin」。
profile.leaveOfAbsence event.idm.entity.entity.user.attribute.labels 如果 profile.leaveOfAbsence 存在,系統會將其值新增為鍵/值組合,鍵為「leaveOfAbsence」。
profile.managerDn event.idm.entity.entity.user.attribute.labels 如果 profile.managerDn 存在,系統會將其值新增為鍵/值組合,並將鍵設為「managerDn」。
profile.payGroup event.idm.entity.entity.user.attribute.labels 如果 profile.payGroup 存在,系統會將其值新增為鍵/值組合,並將鍵設為「payGroup」。
profile.wdemployeeID event.idm.entity.entity.user.attribute.labels 如果 profile.wdemployeeID 存在,系統會將其值新增為鍵/值組合,鍵為「wdemployeeID」。
profile.zipCode event.idm.entity.entity.user.attribute.labels 如果 profile.zipCode 存在,系統會將其值新增為鍵/值組合,並將鍵設為「zipCode」。
profile.userType event.idm.entity.entity.user.attribute.roles 如果 profile.userType 存在,其值會新增至角色陣列。
profile.organization、profile.company event.idm.entity.entity.user.company_name 值取自 profile.organization,如果前者不存在,則取自 profile.company。
profile.department event.idm.entity.entity.user.department 值取自 profile.department。
profile.email、profile.secondEmail、profile.login event.idm.entity.entity.user.email_addresses profile.email、profile.secondEmail 和 profile.login (如果值是電子郵件地址且不重複) 的值會合併到這個欄位。
profile.employeeNumber event.idm.entity.entity.user.employee_id 值取自 profile.employeeNumber。
profile.firstName、profile.Preferred_First_Name event.idm.entity.entity.user.first_name 值取自 profile.firstName,如果前者不存在,則取自 profile.Preferred_First_Name。
profile.EmployeeWorkGroup event.idm.entity.entity.user.group_identifiers 值取自 profile.EmployeeWorkGroup。
profile.HireDate、profile.hiredate event.idm.entity.entity.user.hire_date 系統會從 profile.HireDate 剖析值,如果沒有,則從 profile.hiredate 剖析。
profile.lastName、profile.preferred_Last_Name event.idm.entity.entity.user.last_name 如果 profile.lastName 或 profile.preferred_Last_Name 存在,則從 profile.lastName 擷取值。
lastLogin event.idm.entity.entity.user.last_login_time 值是從 lastLogin 剖析而來。
passwordChanged event.idm.entity.entity.user.last_password_change_time 值是從 passwordChanged 剖析而來。
profile.manager、profile.managerEmail、profile.managerId event.idm.entity.entity.user.managers 填入包含 user_display_name (來自 profile.manager)、email_addresses (來自 profile.managerEmail) 和 employee_id (來自 profile.managerId) 的物件。
profile.city、profile.firstBaseCity event.idm.entity.entity.user.office_address.city 值取自 profile.city,如果前者不存在,則取自 profile.firstBaseCity。
profile.countryCode、profile.country event.idm.entity.entity.user.office_address.country_or_region 值取自 profile.countryCode,如果前者不存在,則取自 profile.country。
profile.streetAddress event.idm.entity.entity.user.personal_address.name 值取自 profile.streetAddress。
profile.state event.idm.entity.entity.user.personal_address.state 值取自 profile.state。
profile.primaryPhone、profile.mobilePhone、profile.mobile event.idm.entity.entity.user.phone_numbers profile.primaryPhone、profile.mobilePhone 和 profile.mobile 的值會合併到這個欄位。
profile.terminationDate、profile.terminationdate event.idm.entity.entity.user.termination_date 系統會從 profile.terminationDate 剖析值,如果沒有,則從 profile.terminationdate 剖析。
profile.title event.idm.entity.entity.user.title 值取自 profile.title。
status event.idm.entity.entity.user.user_authentication_status 從 status 對應:ACTIVE/RECOVERY/LOCKED_OUT/PASSWORD_EXPIRED -> ACTIVE;SUSPENDED -> SUSPENDED;DEPROVISIONED -> DELETED;否則為 UNKNOWN_AUTHENTICATION_STATUS。
profile.displayName event.idm.entity.entity.user.user_display_name 值取自 profile.displayName。
profile.samAccountName、profile.samaccountname、profile.login、profile.ldapUid event.idm.entity.entity.user.userid 填入順序:profile.samAccountName、profile.samaccountname、profile.login (如果不是電子郵件)、profile.ldapUid (如果 profile.login 不是電子郵件)。
event.idm.entity.metadata.entity_type 設為 USER。
id event.idm.entity.metadata.product_entity_id 值取自 id。
event.idm.entity.metadata.product_name 設為 Identity Cloud。
event.idm.entity.metadata.vendor_name 設為 Okta。
activated", "created", "statusChanged", and "type.id entity.entity.labels 從變更記錄對應
profile.AD_ObjectGUID", "profile.ADpwdLastSet", "profile.AFF_Code", "profile.Desk_Location_WD", "profile.Mailing_Address_WD", "profile.Manager_UPN", "profile.PRIVATE_CONF_Profile", "profile.Region_WD", "profile.Subsidiary_Company", "profile.Telephone_Work", "profile.Temp_WD_Primary_Email", "profile.VMware_WS1_Username", "profile.Work_Street_Address_WD", "profile.Workato_WD_Primary_Email", "profile.Workday_ID", "profile.Worker_Type_WD", "profile.businessUnit", "profile.companyName", "profile.contingentSupplierName", "profile.conversationId", "profile.distinguishedName", "profile.division", "profile.emailPrefix", "profile.employeeType", "profile.homePostalAddress", "profile.isManager", "profile.leaveOfAbsence", "profile.managerDn", "profile.payGroup", "profile.wdemployeeID", and "profile.zipCode entity.entity.user.attribute.labels 從變更記錄對應
profile.country entity.user.country 從變更記錄對應
profile.firstBaseCity entity.user.firstBaseCity 從變更記錄對應
profile.preferred_Last_Name entity.user.preferred_Last_Name 從變更記錄對應
profile.EmployeeWorkGroup entity.user.EmployeeWorkGroup 從變更記錄對應
profile.manager entity.user.managers.user_display_name 從變更記錄對應
profile.organization entity.user.organization 從變更記錄對應
profile.state entity.user.state 從變更記錄對應
profile.streetAddress entity.user.streetAddress 從變更記錄對應
profile.mobile entity.user.mobile 從變更記錄對應
profile.managerEmail entity.user.managers.email_addresses 從變更記錄對應
profile.managerId entity.user.managers.employee_id 從變更記錄對應
profile.spotify_username entity.entity.labels 從變更記錄對應

變更記錄

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

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