收集 Okta 用户上下文日志

支持范围:

本文档介绍了如何使用第三方 API 设置 Google Security Operations Feed,以收集 Okta 用户上下文日志。

准备工作

确保您满足以下前提条件:

  • Google SecOps 实例
  • 对 Okta 租户或管理控制台的特权访问权限
  • Okta 中的 API 令牌创建权限

配置 IP 许可清单

在创建 Feed 之前,您必须在 Okta 防火墙或网络设置中将 Google SecOps IP 范围列入许可清单。

获取 Google SecOps IP 范围

向 Okta 用户上下文添加 IP 范围

  1. 登录 Okta 管理控制台。
  2. 依次前往安全性 > 网络。
  3. 在 IP 地址限制下,点击修改。
  4. 以 CIDR 表示法将每个 Google SecOps IP 范围添加到受信任的 IP 地址。
  5. 点击保存。

配置 Okta User Context API 访问权限

如需让 Google SecOps 能够拉取用户情境数据,您需要创建一个具有读取权限的 API 令牌。

创建 API 令牌

  1. 登录 Okta 管理控制台。
  2. 依次点击安全性 > API。
  3. 选择令牌标签页。
  4. 点击创建令牌。
  5. 提供以下配置详细信息:
    • 名称:输入一个描述性名称(例如 Google SecOps Integration)。
    • 说明(可选):输入说明。
  6. 点击创建令牌。

记录 API 凭证

创建 API 令牌后,您将收到以下凭证:

  • API 令牌:您的 API 令牌值(例如 00QCGr-1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1)

所需 API 权限

API 令牌在 Okta 中需要以下权限:

权限/角色 访问权限级别 用途
只读管理员 读取 访问用户个人资料数据
超级用户 读取 对所有用户数据的完整访问权限

设置 Feed

如需配置 Feed,请按以下步骤操作:

  1. 依次前往设置 > 数据管理 > Feed。如果您使用的是仅 SIEM 平台,请依次前往设置 > Feed。
  2. 点击添加新新闻信息流。
  3. 在下一页上,点击配置单个 Feed。
  4. 在 Feed 名称字段中,输入 Feed 的名称(例如 Okta User Context)。
  5. 选择第三方 API 作为来源类型。
  6. 选择 Okta 用户上下文作为日志类型。
  7. 点击下一步。
  8. 为以下输入参数指定值:

    • 身份验证 HTTP 标头:按以下格式输入身份验证凭证:

      Authorization:SSWS your-api-token
      
      • 例如:Authorization:SSWS 00QCGr-1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1。
    • API 主机名:Okta 实例的完全限定域名(例如 example.okta.com,而不是可能配置的任何自定义域名)。

      • 例如:company.okta.com。
    • Manager ID Reference Field(主管 ID 引用字段):使用非 Okta ID 引用主管时所需的 ID(可选)。

    • 资产命名空间:资产命名空间。

    • 注入标签:要应用于此 Feed 中的事件的标签。

  9. 点击下一步。

  10. 在最终确定界面中查看新的新闻信息流配置,然后点击提交。

设置完成后,Feed 会开始按时间顺序从 Okta User Context 实例中检索日志。

区域端点

Okta 会根据贵组织所在的区域使用不同的 API 端点:

区域 基础网址/主机名
美国(默认) {org-name}.okta.com
欧盟(欧洲、中东和非洲地区) {org-name}.okta-emea.com
亚太地区 {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 填充了包含 profile.manager 中的 user_display_name、profile.managerEmail 中的 email_addresses 和 profile.managerId 中的 employee_id 的对象。
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 专业人士的解答。