收集 CyberArk Privileged Threat Analytics 日志
解析器版本:18.0
本文档介绍了如何使用 Bindplane 将 CyberArk Privileged Threat Analytics 日志注入到 Google Security Operations。CyberArk Privileged Threat Analytics (PTA) 是一种安全解决方案,可检测和响应涉及特权账号的恶意活动。它使用高级分析和机器学习技术来监控、分析和标记可能表明存在潜在内部威胁或凭证泄露的异常行为。
准备工作
请确保满足以下前提条件:
- Google SecOps 实例。
- Windows 2016 或更高版本,或者具有 systemd 的 Linux 主机。
- 如果在代理后面运行,请确保根据 Bindplane 代理要求打开防火墙端口。
- 对 CyberArk Privileged Threat Analytics 服务器的特权访问权限。
获取 Bindplane 代理的 Google SecOps 凭证
如需向 Google SecOps 验证 Bindplane 代理,请选择以下方法之一:
- 新部署:使用 Chronicle API(选项 1)。
- 旧版部署:继续使用数据注入身份验证文件(方法 2),直到 Ingestion API 于 2027 年 7 月 20 日停用。
方法 1:为 Chronicle API 创建服务账号(推荐)
- 登录 Google Cloud 控制台,然后选择与您的 Google SecOps 实例关联的 Google Cloud 项目。
- 依次前往 IAM 和管理 > 服务账号。
- 点击创建服务账号。
- 提供以下配置详细信息:
- 服务账号名称:输入账号的名称(例如
bindplane-ingest)。 - 服务账号说明:输入说明(例如
Bindplane agent log ingestion)。
- 服务账号名称:输入账号的名称(例如
- 点击创建并继续。
- 在向此服务账号授予对项目的访问权限部分,点击选择角色,然后选择 Chronicle Editor。
- 点击继续,然后点击完成。
- 点击您创建的服务账号,然后前往密钥标签页。
- 依次点击添加密钥 > 创建新密钥。
- 选择 JSON,然后点击创建。密钥文件会下载到您的计算机上。
- 将密钥文件另存为 Bindplane 收集器目录(Linux 上的
/opt/observiq-otel-collector/ingestion-auth.json或 Windows 上的C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json)中的ingestion-auth.json,或更新config.yaml中的creds_file_path以匹配您保存它的路径。 - 前往 IAM 和管理 > 设置,然后复制项目编号。您在配置导出器时需要用到该名称。
方法 2:下载数据注入身份验证文件(旧版)
- 登录 Google SecOps 控制台。
- 依次前往设置 > 数据管理 > 收集代理。如果您使用的是仅限 SIEM 的平台,请依次前往设置 > 收集代理。
- 下载数据注入身份验证文件。
- 将该文件安全地保存在将要安装 Bindplane 代理的系统上。
获取 Google SecOps 客户 ID
- 登录 Google SecOps 控制台。
- 依次前往设置 > 管理 > 个人资料。如果您使用的是仅限 SIEM 的平台,请依次前往设置 > 个人资料。
- 复制并保存组织详细信息部分中的客户 ID。
安装 Bindplane 代理
根据以下说明,在 Windows 或 Linux 操作系统上安装 Bindplane 代理。
Windows 安装
- 以管理员身份打开命令提示符或 PowerShell。
运行以下命令:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
Linux 安装
- 打开具有 root 或 sudo 权限的终端。
运行以下命令:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
其他安装资源
如需了解其他安装选项,请参阅此安装指南。
配置 Bindplane 代理以注入 syslog 并发送到 Google SecOps
访问配置文件:
- 找到
config.yaml文件。通常,它位于 Linux 上的/opt/observiq-otel-collector/目录中,或 Windows 上的安装目录中。 - 使用文本编辑器(例如
nano、vi或记事本)打开该文件。
- 找到
按如下方式修改
config.yaml文件:receivers: tcplog: listen_address: "0.0.0.0:514" exporters: chronicle/cyberark_pta: protocol: https # Region of your instance, for example us, europe, asia-southeast1 location: <LOCATION> # Project number of the Google Cloud project linked to the instance project: '<PROJECT_NUMBER>' compression: gzip creds_file_path: '/path/to/ingestion-authentication-file.json' customer_id: '<CUSTOMER_ID>' endpoint: chronicle.googleapis.com log_type: 'CYBERARK_PTA' raw_log_field: body ingestion_labels: service: pipelines: logs/cyberark_pta_to_chronicle: receivers: - tcplog exporters: - chronicle/cyberark_pta
- 根据基础架构的要求替换端口和 IP 地址。
- 将
<CUSTOMER_ID>替换为实际客户 ID。 - 将
<LOCATION>替换为您的 Google SecOps 实例所在的区域(例如us、europe或asia-southeast1)。导出工具会在此值前面加上chronicle.googleapis.com。如需查看完整列表,请参阅区域级端点。 将
<PROJECT_NUMBER>替换为 IAM 和管理 > 设置中的项目编号。将
/path/to/ingestion-authentication-file.json更新为服务账号密钥文件(选项 1)的保存路径。
旧版提取 API 导出工具
如果您使用选项 2 中的数据注入身份验证文件,请将
exporters代码块替换为以下内容。将creds_file_path设置为数据注入身份验证文件的路径,如果您的实例位于美国境外,请将malachiteingestion-pa.googleapis.com替换为您的区域端点(例如europe-malachiteingestion-pa.googleapis.com)。exporters: chronicle/cyberark_pta: compression: gzip creds_file_path: '/path/to/ingestion-authentication-file.json' customer_id: '<CUSTOMER_ID>' endpoint: malachiteingestion-pa.googleapis.com log_type: 'CYBERARK_PTA' raw_log_field: body ingestion_labels:
重启 Bindplane 代理以应用更改
如需在 Linux 中重启 Bindplane 代理,请运行以下命令:
sudo systemctl restart observiq-otel-collector如需在 Windows 中重启 Bindplane 代理,您可以使用服务控制台,也可以输入以下命令:
net stop observiq-otel-collector && net start observiq-otel-collector
配置 CyberArk Privileged Threat Analytics syslog 转发
- 登录到 Privileged Threat Analytics 服务器。
- 运行 DEFAULTPARM 命令以打开默认
systemparm.properties文件。 - 复制包含
syslog_outbound属性的行,然后退出systemparm.properties文件。 - 运行 LOCALPARM 命令以打开本地
systemparm.properties文件。 - 按键盘上的
i即可修改文件。 - 在
systemparm.properties文件中,取消注释syslog_outbound属性。 粘贴您复制的代码行,并根据以下示例修改参数:
syslog_outbound=[{"siem": "Chronicle", "format": "CEF", "host": "BINDPLANE_IP", "port": BINDPLANE_PORT, "protocol": "TCP"}]- 将
BINDPLANE_IP替换为 Bindplane 代理主机的 IP 地址。 - 将
BINDPLANE_PORT替换为在 Bindplane 代理中配置的端口号(例如514)。
- 将
保存并关闭配置文件。
重启 Privileged Threat Analytics 服务器以应用更改。
如需了解详情,请参阅 CyberArk Privileged Threat Analytics 文档。
UDM 映射表
| 日志字段 | UDM 映射 | 逻辑 |
|---|---|---|
src |
principal.ip |
直接从 src 字段映射。 |
dst |
target.ip |
直接从 dst 字段映射。 |
suser |
principal.user.userid |
直接从 suser 字段映射。 |
duser |
target.user.userid |
直接从 duser 字段映射。 |
cs1 |
security_result.description |
从 cs1 字段(原因)直接映射。 |
cs2 |
additional.fields |
直接从 cs2 字段(电台)映射。 |
act |
security_result.action_details |
从 act 字段直接映射(已采取措施)。 |
cat |
metadata.product_event_type |
直接从 cat 字段(事件类别)映射。 |
severity |
security_result.severity |
从 CEF 严重级别值映射。 |
deviceCustomDate1 |
metadata.event_timestamp |
从 deviceCustomDate1 字段解析。 |
metadata.vendor_name |
设置为 CyberArk。 |
|
metadata.product_name |
设置为 Privileged Threat Analytics。 |
|
metadata.log_type |
设置为 CYBERARK_PTA。 |