收集 Fortinet FortiManager 日志
解析器版本:4.0
本文档介绍了如何使用 Bindplane 将 Fortinet FortiManager 日志注入到 Google Security Operations。
Fortinet FortiManager 是一个集中式网络管理平台,可为 Fortinet 安全和网络设备提供统一的管理、最佳实践合规性和工作流自动化。借助 FortiManager,管理员可以集中管理安全网格中数千个 FortiGate 防火墙和其他 Fortinet 设备的配置、政策、固件更新和安全服务。
准备工作
请确保满足以下前提条件:
- Google SecOps 实例。
- Windows Server 2016 或更高版本,或者具有 systemd 的 Linux 主机。
- Bindplane 代理与 Fortinet FortiManager 之间的网络连接。
- 如果在代理后面运行,请确保防火墙端口已根据 Bindplane 代理要求打开。
- 对 Fortinet FortiManager 管理控制台的特权访问权限,并有权修改系统设置。
- FortiManager 5.0.7 版或更高版本。
获取 Google SecOps 注入身份验证文件
- 登录 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](https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi)" /quiet等待安装完成。
运行以下命令,验证安装是否成功:
sc query observiq-otel-collector该服务应显示为 正在运行。
Linux 安装
- 打开具有 root 或 sudo 权限的终端。
运行以下命令:
sudo sh -c "$(curl -fsSlL [https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh](https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh))" install_unix.sh等待安装完成。
运行以下命令,验证安装是否成功:
sudo systemctl status observiq-otel-collector该服务应显示为有效(正在运行)。
其他安装资源
如需了解其他安装选项和问题排查信息,请参阅 Bindplane 代理安装指南。
配置 Bindplane 代理以注入 syslog 并将其发送到 Google SecOps
找到配置文件
- Linux:
bash sudo nano /opt/observiq-otel-collector/config.yaml - Windows:
cmd notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
修改配置文件
将
config.yaml的全部内容替换为以下配置:receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/fortimanager: compression: gzip creds_file_path: '/etc/bindplane-agent/ingestion-auth.json' customer_id: 'your-customer-id-here' endpoint: malachiteingestion-pa.googleapis.com log_type: FORTINET_FORTIMANAGER raw_log_field: body ingestion_labels: env: production source: fortimanager service: pipelines: logs/fortimanager_to_chronicle: receivers: - udplog exporters: - chronicle/fortimanager
配置参数
替换以下占位符:
接收器配置:
listen_address:要监听的 IP 地址和端口。使用0.0.0.0:514在端口 514 上监听所有接口。如果端口 514 在 Linux 上需要 root 权限,请使用0.0.0.0:1514并将 FortiManager 配置为发送到端口 1514。
导出器配置:
creds_file_path:提取身份验证文件的完整路径。- Linux:
/etc/bindplane-agent/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
customer_id:您的客户 ID(例如a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6)。endpoint:区域端点网址:- 美国:
malachiteingestion-pa.googleapis.com - 欧洲:
europe-malachiteingestion-pa.googleapis.com - 亚洲:
asia-southeast1-malachiteingestion-pa.googleapis.com - 如需查看完整列表,请参阅区域级端点。
- 美国:
log_type:必须正好为FORTINET_FORTIMANAGER。ingestion_labels:用于过滤和组织的可选标签。
保存配置文件
修改后,保存文件:
- Linux:依次按
Ctrl+O、Enter和Ctrl+X。 - Windows:依次点击文件 > 保存。
如需在 Linux 中重启 Bindplane 代理,请执行以下操作:
运行以下命令:
sudo systemctl restart observiq-otel-collector验证服务是否正在运行:
sudo systemctl status observiq-otel-collector检查日志是否存在错误:
sudo journalctl -u observiq-otel-collector -f
如需在 Windows 中重启 Bindplane 代理,请执行以下操作:
请从下列选项中选择一项:
- 以管理员身份运行命令提示符或 PowerShell:
net stop observiq-otel-collector && net start observiq-otel-collector- 服务控制台:
- 按
Win+R,输入services.msc,然后按 Enter 键。 - 找到 observIQ OpenTelemetry 收集器。
- 右键点击并选择重新启动。
- 按
验证服务是否正在运行:
sc query observiq-otel-collector检查日志是否存在错误:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
配置 Fortinet FortiManager Syslog 转发
FortiManager syslog 配置分为两步:首先,在 GUI 中定义 syslog 服务器,然后通过 CLI 启用本地日志转发。
第 1 步:在 FortiManager GUI 中添加 syslog 服务器
- 登录 Fortinet FortiManager 网页界面。
- 依次前往系统设置 > 高级 > Syslog 服务器。
- 点击工具栏中的新建。
- 配置以下设置:
- 名称:输入一个描述性名称(例如
Chronicle-Bindplane)。 - IP 地址(或 FQDN):输入 Bindplane 代理主机(例如
192.168.1.100)的 IP 地址。 - Syslog 服务器端口:输入
514(如果使用非特权端口,则输入1514)。 - 可靠连接:对于 UDP,保持停用状态(默认);对于 TCP,启用此选项。
- 安全连接:除非您已配置 TLS 证书,否则请保持停用状态。
- 名称:输入一个描述性名称(例如
- 点击 OK 以保存 syslog 服务器配置。
第 2 步:通过 CLI 启用本地日志转发
- 通过 SSH 或控制台连接到 FortiManager CLI。
运行以下命令(适用于 FortiManager 5.0.7 及更高版本):
config system locallog syslogd setting set syslog-name Chronicle-Bindplane set severity information set status enable end
配置参数:
syslog-name:必须与您在界面中配置的名称一致。severity:设置为information可捕获所有本地日志。选项包括:emergency、alert、critical、error、warning、notification、information、debug。status:设置为enable以开始转发日志。
验证配置:
config system locallog syslogd setting show end验证日志是否正在发送:
- Linux:
sudo tcpdump -i any port 514 -A - Windows:使用 Wireshark 捕获端口 514 上的流量。
- Linux:
关于 FortiManager syslog 行为的说明
- FortiManager 会发送自己的本地事件日志(系统、配置更改、管理操作),而不是受管 FortiGate 设备的日志。
- 默认情况下,可靠连接处于停用状态(UDP 端口 514)。如果启用,日志将使用 TCP 端口 514。
- Syslog 消息使用 Fortinet 专用格式。Google SecOps
FORTINET_FORTIMANAGER解析器专为这种格式而设计。 - 确保系统时间与 NTP 同步,并配置为 UTC。(前往信息中心 > 系统信息 widget 进行修改)。
UDM 映射表
| 日志字段 | UDM 映射 | 逻辑 |
|---|---|---|
type、subtype、pri、operation、performed_on、lograte、msgrate、logratelimit、logratepeak、action、cpuusage、memusage、diskusage、disk2usage、userfrom |
about.resource.attribute.labels |
与资源关联的标签。 |
clearpass-spt、allow-routing、color、comment、fabric-object、name、node-ip-only、obj-type、sdn-addr-type、sub-type、adom、pkgname、_signal-lte-rsrq、_signal-lte-rssi、performed_on_dev、changetype |
additional.fields |
扩展数据的其他字段。 |
cache_ttl_label |
network.dns.answers |
DNS 回答映射。 |
changes |
metadata.description |
活动的详细说明。 |
event_type |
metadata.event_type |
活动的类别/类型。 |
log_id |
metadata.product_log_id |
商品专属标识符。 |
session_id |
network.session_id |
会话标识符。 |
adminprof |
principal.administrative_domain |
主账号的行政网域。 |
devname |
principal.hostname |
主账号的主机名。 |
src_ip |
principal.ip |
主账号的 IP 地址。 |
device_id |
principal.resource.product_object_id |
资源商品 ID。 |
uuid |
principal.user.userid |
主账号的用户 ID。 |
action_details |
security_result.action |
采取的安全措施。 |
wildcard、subnet、end-ip、start-ip |
security_result.detection_fields |
用于安全检测的字段。 |
msg |
security_result.summary |
安全事件的摘要。 |
target_ip、tar_ip、remote_ip |
target.ip |
目标实体的 IP 地址。 |
tar_port,remote_port |
target.port |
目标实体端口。 |
user |
target.user.userid |
目标的相应用户 ID。 |
| 不适用 | metadata.vendor_name |
设置为 Fortinet。 |
| 不适用 | metadata.product_name |
设置为 FortiManager。 |
vd |
event.idm.read_only_udm.additional.fields |
从变更日志映射 |
unauthuser |
event.idm.read_only_udm.additional.fields |
从变更日志映射 |
unauthusersource |
event.idm.read_only_udm.additional.fields |
从变更日志映射 |
level |
event.idm.read_only_udm.security_result.detection_fields |
从变更日志映射 |
trandisp |
event.idm.read_only_udm.security_result.detection_fields |
从变更日志映射 |
policyid |
event.idm.read_only_udm.security_result.detection_fields |
从变更日志映射 |
sentpkt |
event.idm.read_only_udm.security_result.detection_fields |
从变更日志映射 |
rcvdpkt |
event.idm.read_only_udm.security_result.detection_fields |
从变更日志映射 |
sentdelta |
event.idm.read_only_udm.security_result.detection_fields |
从变更日志映射 |
rcvddelta |
event.idm.read_only_udm.security_result.detection_fields |
从变更日志映射 |
durationdelta |
event.idm.read_only_udm.security_result.detection_fields |
从变更日志映射 |
sentpktdelta |
event.idm.read_only_udm.security_result.detection_fields |
从变更日志映射 |
rcvdpktdelta |
event.idm.read_only_udm.security_result.detection_fields |
从变更日志映射 |
crscore |
event.idm.read_only_udm.security_result.detection_fields |
从变更日志映射 |
poluuid |
event.idm.read_only_udm.security_result.detection_fields |
从变更日志映射 |
policytype |
event.idm.read_only_udm.security_result.detection_fields |
从变更日志映射 |
policyname |
event.idm.read_only_udm.security_result.detection_fields |
从变更日志映射 |
craction |
event.idm.read_only_udm.security_result.detection_fields |
从变更日志映射 |
crlevel |
event.idm.read_only_udm.security_result.detection_fields |
从变更日志映射 |
type |
event.idm.read_only_udm.metadata.product_event_type |
从变更日志映射 |
subtype |
event.idm.read_only_udm.target.resource.resource_subtype |
从变更日志映射 |
logid |
event.idm.read_only_udm.metadata.product_log_id |
从变更日志映射 |
devid |
event.idm.read_only_udm.principal.asset.asset_id |
从变更日志映射 |
srcip |
event.idm.read_only_udm.src.ip |
从变更日志映射 |
srcip |
event.idm.read_only_udm.src.asset.ip |
从变更日志映射 |
src |
event.idm.read_only_udm.src.ip |
从变更日志映射 |
src |
event.idm.read_only_udm.src.asset.ip |
从变更日志映射 |
srcname |
event.idm.read_only_udm.src.hostname |
从变更日志映射 |
srcname |
event.idm.read_only_udm.src.asset.hostname |
从变更日志映射 |
srcport |
event.idm.read_only_udm.src.port |
从变更日志映射 |
dst |
event.idm.read_only_udm.target.ip |
从变更日志映射 |
dst |
event.idm.read_only_udm.target.asset.ip |
从变更日志映射 |
dstport |
event.idm.read_only_udm.target.port |
从变更日志映射 |
dstintf |
event.idm.read_only_udm.target.resource.attribute.labels |
从变更日志映射 |
dstintfrole |
event.idm.read_only_udm.target.resource.attribute.labels |
从变更日志映射 |
srccountry |
event.idm.read_only_udm.principal.location.country_or_region |
从变更日志映射 |
dstcountry |
event.idm.read_only_udm.target.location.country_or_region |
从变更日志映射 |
sessionid |
event.idm.read_only_udm.network.session_id |
从变更日志映射 |
app_protocol_output |
event.idm.read_only_udm.network.application_protocol |
从变更日志映射 |
proto |
event.idm.read_only_udm.additional.fields |
从变更日志映射 |
view |
event.idm.read_only_udm.additional.fields |
从变更日志映射 |
CAT |
event.idm.read_only_udm.additional.fields |
从变更日志映射 |
product_id |
event.idm.read_only_udm.additional.fields |
从变更日志映射 |
product_name |
event.idm.read_only_udm.additional.fields |
从变更日志映射 |
vendor_name |
event.idm.read_only_udm.additional.fields |
从变更日志映射 |
qtype |
event.idm.read_only_udm.additional.fields |
从变更日志映射 |
action |
event.idm.read_only_udm.security_result.action |
从变更日志映射 |
action |
event.idm.read_only_udm.security_result.action_details |
从变更日志映射 |
duration |
event.idm.read_only_udm.network.session_duration.seconds |
从变更日志映射 |
appcat |
event.idm.read_only_udm.principal.resource.attribute.labels |
从变更日志映射 |
srchwversion |
event.idm.read_only_udm.src.platform_version |
从变更日志映射 |
mastersrcmac |
event.idm.read_only_udm.principal.mac |
从变更日志映射 |
mastersrcmac |
event.idm.read_only_udm.principal.asset.mac |
从变更日志映射 |
r_value |
event.idm.read_only_udm.intermediary.resource.id |
从变更日志映射 |
resource_name |
event.idm.read_only_udm.intermediary.resource.name |
从变更日志映射 |
hostname |
event.idm.read_only_udm.intermediary.hostname |
从变更日志映射 |
hostname |
event.idm.read_only_udm.intermediary.asset.hostname |
从变更日志映射 |
ip |
event.idm.read_only_udm.intermediary.ip |
从变更日志映射 |
ip |
event.idm.read_only_udm.intermediary.asset.ip |
从变更日志映射 |
process_id |
event.idm.read_only_udm.intermediary.resource.attribute.labels |
从变更日志映射 |
process |
event.idm.read_only_udm.intermediary.process.command_line |
从变更日志映射 |
app |
event.idm.read_only_udm.intermediary.application |
从变更日志映射 |
srcserver |
event.idm.read_only_udm.src.resource.attribute.labels |
从变更日志映射 |
srcintfrole |
event.idm.read_only_udm.src.resource.attribute.labels |
从变更日志映射 |
srcswversion |
event.idm.read_only_udm.src.resource.attribute.labels |
从变更日志映射 |
srchwvendor |
event.idm.read_only_udm.src.resource.attribute.labels |
从变更日志映射 |
srcfamily |
event.idm.read_only_udm.src.resource.attribute.labels |
从变更日志映射 |
spt |
event.idm.read_only_udm.src.resource.attribute.labels |
从变更日志映射 |
srcintf |
event.idm.read_only_udm.src.resource.attribute.labels |
从变更日志映射 |
srcmac |
event.idm.read_only_udm.src.mac |
从变更日志映射 |
srcmac |
event.idm.read_only_udm.src.asset.mac |
从变更日志映射 |
service |
event.idm.read_only_udm.principal.resource.name |
从变更日志映射 |
sentbyte |
event.idm.read_only_udm.network.sent_bytes |
从变更日志映射 |
rcvdbyte |
event.idm.read_only_udm.network.received_bytes |
从变更日志映射 |
devtype |
event.idm.read_only_udm.principal.resource.attribute.labels |
从变更日志映射 |
osname |
event.idm.read_only_udm.principal.platform_version |
从变更日志映射 |
adom |
event.idm.read_only_udm.additional.fields |
从变更日志映射 |
pkgname |
event.idm.read_only_udm.additional.fields |
从变更日志映射 |
_signal-lte-rsrq |
event.idm.read_only_udm.additional.fields |
从变更日志映射 |
_signal-lte-rssi |
event.idm.read_only_udm.additional.fields |
从变更日志映射 |
performed_on |
event.idm.read_only_udm.additional.fields |
从变更日志映射 |
changes |
event.idm.read_only_udm.additional.fields |
从变更日志映射 |
更新日志
需要更多帮助?获得社区成员和 Google SecOps 专业人士的解答。