收集 Netskope 提醒日志 v2

支持:

此解析器从 JSON 格式的消息中提取 Netskope 提醒日志,并将其转换为 Google Security Operations UDM。它会对字段进行标准化处理、解析时间戳、处理提醒和严重级别、提取网络信息(IP、端口、协议)、扩充用户和文件数据,并将字段映射到 UDM 结构。该解析器还会处理特定的 Netskope 活动(例如登录和 DLP 事件),并添加自定义标签以增强上下文。

准备工作

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

  • Google SecOps 实例。
  • 对 Netskope 的特权访问权限。

在 Netskope 中创建服务账号并生成 REST API 令牌

如需与 Google SecOps 集成,您需要在 Netskope 中创建专用服务帐号并生成 API 令牌。

  1. 使用管理员凭据登录 Netskope 租户。
  2. 依次前往设置 > 管理和角色。
  3. 点击管理员 标签页,然后选择服务账号 按钮。
  4. 在“New Service Account”(新建服务账号)对话框中,输入描述性服务账号名称 (例如“Google SecOps Ingestion”)。
  5. 在角色下,选择具有访问所需 API 端点权限的相应角色(例如,具有提醒读取权限的自定义角色)。

    • 角色权限和 API 端点透明度:
      • 选择角色(或创建自定义角色)时,Netskope 会提供有关关联 API 端点的透明度:
        • 创建自定义角色:在为自定义角色定义权限时,系统会立即显示与每个权限类别关联的 API 端点数据。
        • 检查预定义角色:您可以查看预定义角色,然后点击任意角色以查看其权限的详细细分。这包括关联的 API 端点和类别。
  6. 在 REST API Authentication Methods(REST API 身份验证方法)下,选择 API Key(API 密钥)。

  7. 选中 Generate token now with expiry (立即生成带有效期的令牌)对应的复选框,并设置所选的有效期(例如 365 天)。

  8. 点击创建 按钮。

    警告 :系统会显示一个对话框,其中显示新的 REST API 令牌。您必须 立即复制并安全地存储此令牌。系统不会再显示此令牌。

  9. 请妥善保管此令牌;您需要在 Google SecOps 中配置 Feed 时使用此令牌。

设置 Feed

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

  1. 依次前往 SIEM 设置 > Feed。
  2. 点击 Add New Feed (添加新 Feed)。
  3. 在下一页上,点击 Configure a single feed (配置单个 Feed)。
  4. 在 Feed name (Feed 名称)字段中,输入 Feed 的名称;例如 Netskope Alert Logs v2 。
  5. 选择 Third party API (第三方 API)作为来源类型 。
  6. 选择 Netskope V2 作为日志类型 。
  7. 点击下一步 。
  8. 为以下输入参数指定值:
    • Authentication HTTP Header :之前以 Netskope-Api-Token:<value> 格式生成的令牌(例如 Netskope-Api-Token:AAAABBBBCCCC111122223333 )。
    • API Hostname :Netskope REST API 端点的 FQDN(完全限定域名)(例如 myinstance.goskope.com)。
    • API Endpoint :输入 alerts 。
    • Content Type :alerts 允许使用的值有:uba 、securityassessment 、quarantine 、remediation 、policy 、malware 、malsite 、compromisedcredential 、ctep 、dlp 、watchlist 。
  9. 点击下一步 。
  10. 在 Finalize (最终确定)界面中查看 Feed 配置,然后点击提交 。

可选:添加 Feed 配置以注入 Netskope 事件日志 v2

  1. 依次前往 SIEM 设置 > Feed。
  2. 点击 Add new feed (添加新 Feed)。
  3. 在下一页上,点击 Configure a single feed (配置单个 Feed)。
  4. 在 Feed name (Feed 名称)字段中,输入 Feed 的名称(例如 Netskope 事件日志 v2 )。
  5. 选择 Third party API (第三方 API)作为来源类型 。
  6. 选择 Netskope V2 作为日志类型 。
  7. 点击下一步 。
  8. 为以下输入参数指定值:
    • Authentication HTTP Header:输入格式为 Netskope-Api-Token: <your-generated-token> 的 REST API 令牌,其中 <your-generated-token> 是您在上一个 部分中从 Netskope 平台复制的 API 令牌。此标头用于针对 Netskope API 进行身份验证。
    • API Hostname :Netskope REST API 端点的 FQDN(完全限定域名)(例如 myinstance.goskope.com)。
    • API Endpoint :输入 events 。
    • Content Type :events 允许使用的值有:application 、audit 、connection 、incident 、infrastructure 、network 、page 。
    • Asset namespace:资产命名空间。
    • Ingestion labels:应用于此 Feed 中事件的标签。
  9. 点击下一步 。
  10. 在 Finalize (最终确定)界面中查看 Feed 配置,然后点击提交 。

UDM 映射表

日志字段 UDM 映射 逻辑
_id metadata.product_log_id 直接从 _id 映射。
access_method extensions.auth.auth_details 直接从 access_method 映射。
action security_result.action 映射到 QUARANTINE,因为值为“alert”。还映射到 security_result.action_details,值为“alert”。
app target.application 直接从 app 映射。
appcategory security_result.category_details 直接从 appcategory 映射。
browser network.http.user_agent 直接从 browser 映射。
browser_session_id network.session_id 直接从 browser_session_id 映射。
browser_version network.http.parsed_user_agent.browser_version 直接从 browser_version 映射。
ccl security_result.confidence_details 直接从 ccl 映射。
device principal.resource.type、principal.resource.resource_subtype principal.resource.type 设置为“DEVICE”。principal.resource.resource_subtype 直接从 device 映射。
dst_country target.location.country_or_region 直接从 dst_country 映射。
dst_latitude target.location.region_coordinates.latitude 直接从 dst_latitude 映射。
dst_longitude target.location.region_coordinates.longitude 直接从 dst_longitude 映射。
dst_region target.location.name 直接从 dst_region 映射。
dstip target.ip、target.asset.ip 直接从 dstip 映射。
metadata.event_type metadata.event_type 设置为 NETWORK_CONNECTION,因为主体和目标 IP 地址都存在,且协议不是 HTTP。
metadata.product_event_type metadata.product_event_type 直接从 type 映射。
metadata.product_name metadata.product_name 由解析器设置为“NETSKOPE_ALERT_V2”。
metadata.vendor_name metadata.vendor_name 由解析器设置为“NETSKOPE_ALERT_V2”。
object_type additional.fields 作为键值对添加到 additional.fields,其中键为“object_type”,值为 object_type 的内容。
organization_unit principal.administrative_domain 直接从 organization_unit 映射。
os principal.platform 映射到 WINDOWS,因为该值与正则表达式“(?i)Windows.*”匹配。
policy security_result.summary 直接从 policy 映射。
site additional.fields 作为键值对添加到 additional.fields,其中键为“site”,值为 site 的内容。
src_country principal.location.country_or_region 直接从 src_country 映射。
src_latitude principal.location.region_coordinates.latitude 直接从 src_latitude 映射。
src_longitude principal.location.region_coordinates.longitude 直接从 src_longitude 映射。
src_region principal.location.name 直接从 src_region 映射。
srcip principal.ip、principal.asset.ip 直接从 srcip 映射。
timestamp metadata.event_timestamp.seconds 直接从 timestamp 映射。
type metadata.product_event_type 直接从 type 映射。
ur_normalized principal.user.email_addresses 直接从 ur_normalized 映射。
url target.url 直接从 url 映射。
user principal.user.email_addresses 直接从 user 映射。

更新日志

查看此解析器的更新日志

需要更多帮助?获得社区成员和 Google SecOps 专业人士的解答。