收集 Okta 用户上下文日志

支持的国家/地区:

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

准备工作

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

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

配置 IP 许可清单

如果贵组织按 IP 地址限制 Okta API 令牌,您可以在 Okta 中创建一个专用 IP 区域,以绑定到 Google SecOps API 令牌。如果贵组织不需要对 API 令牌设置 IP 限制,您可以跳过此部分,并在创建 API 令牌时选择任何 IP。

向 Okta IP 区域添加 IP 范围(可选)

  1. 登录 Okta 管理控制台。
  2. 依次前往安全性 > 网络。
  3. 依次点击添加区域 > IP 区域。
  4. 为区域输入描述性名称(例如 Google SecOps API Token Zone)。
  5. 在网关 IP 字段中,以 CIDR 表示法添加您从 IP 许可清单中获取的 IP 范围。
  6. 将可信代理 IP 字段留空。请勿在此处添加 Google IP 范围,因为 Okta 会将受信任的代理视为受 ThreatInsight 信任。
  7. 确保未选中禁止从与此区域中列出的条件匹配的 IP 地址进行访问。
  8. 点击保存。

保存 IP 区域后:

  • 验证 ThreatInsight 豁免:依次前往安全 > 常规 > Okta ThreatInsight 设置,然后验证新创建的区域未列在豁免区域下。
  • 检查政策:验证没有任何现有用户登录政策、全局会话政策或其他 API 令牌与宽泛条件(例如在区域内:所有区域或在 Okta 中定义的任何网络区域内)匹配,因为这些条件适用于贵组织中定义的每个区域。

配置 Okta User Context API 访问权限

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

创建 API 令牌

  1. 登录 Okta 管理控制台。
  2. 依次前往安全性 > API。
  3. 选择令牌标签页。
  4. 点击创建令牌。
  5. 提供以下配置详细信息:
    • 名称:输入一个描述性名称(例如 Google SecOps Integration)。
    • 使用此令牌发出的 API 调用必须来自:
      • 选择任何 IP(如果您未创建 IP 区域,建议选择此选项),或
      • 选择在以下任一可用区中,然后选择您为此 API 令牌创建的专用 IP 可用区。请勿选择 In any network zone defined in Okta(在 Okta 中定义的任何网络区域中)。
  6. 点击创建令牌。

记录 API 凭证

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

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

所需 API 权限

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

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

设置 Feed

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

  1. 依次前往设置 > 数据管理 > Feed。如果您使用的是 SIEM-only 平台,请依次前往设置 > 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 专业人士的解答。