收集 VMware Tanzu 日志

支持的语言：

Google SecOps SIEM

注意： 此功能受《Google Security Operations 服务专用条款》的正式发布前产品条款的约束。我们对正式发布前功能的支持可能有限，并且对正式发布前功能的更改与其他正式发布前版本可能不兼容。如需了解详情，请参阅 Google SecOps 技术支持服务准则和 Google SecOps 服务专用条款。

本文档介绍了如何使用 Bindplane 将 VMware Tanzu 日志注入到 Google Security Operations。解析器从 JSON 或 SYSLOG+JSON 格式的消息中提取审核日志。它会解析日志数据，将字段标准化为 UDM 格式，并使用用户详细信息、资源信息、网络活动和安全结果等元数据来丰富事件，同时处理单个 JSON 对象和嵌入在 syslog 消息中的 JSON。

准备工作

请确保满足以下前提条件：

• Google SecOps 实例
• Windows 2016 或更高版本，或者具有 systemd 的 Linux 主机
• 如果通过代理运行，请确保防火墙端口处于开放状态
• 对 VMware Tanzu 的特权访问

获取 Google SecOps 注入身份验证文件

1. 登录 Google SecOps 控制台。
2. 依次前往 SIEM 设置 > 收集代理。
3. 下载注入身份验证文件。将该文件安全地保存在将要安装 Bindplane 的系统上。

获取 Google SecOps 客户 ID

1. 登录 Google SecOps 控制台。
2. 依次前往 SIEM 设置 > 配置文件。
3. 复制并保存组织详细信息部分中的客户 ID。

安装 Bindplane 代理

按照以下说明在 Windows 或 Linux 操作系统上安装 Bindplane 代理。

Windows 安装

1. 以管理员身份打开命令提示符或 PowerShell。

2. 运行以下命令：

   msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
   

Linux 安装

1. 打开具有 root 或 sudo 权限的终端。

2. 运行以下命令：

   sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
   

其他安装资源

如需了解其他安装选项，请参阅安装指南。

配置 Bindplane 代理以注入 Syslog 并将其发送到 Google SecOps

1. 访问配置文件：
   • 找到 config.yaml 文件。通常，它位于 Linux 上的 /etc/bindplane-agent/ 目录中或 Windows 上的安装目录中。
   • 使用文本编辑器（例如 nano、vi 或记事本）打开该文件。

2. 按如下方式修改 config.yaml 文件：

   receivers:
       udplog:
           # Replace the port and IP address as required
           listen_address: "0.0.0.0:514"
   
   exporters:
       chronicle/chronicle_w_labels:
           compression: gzip
           # Adjust the path to the credentials file you downloaded in Step 1
           creds_file_path: '/path/to/ingestion-authentication-file.json'
           # Replace with your actual customer ID from Step 2
           customer_id: <customer_id>
           endpoint: malachiteingestion-pa.googleapis.com
           # Add optional ingestion labels for better organization
           log_type: 'VMWARE_TANZU'
           raw_log_field: body
           ingestion_labels:
   
   service:
       pipelines:
           logs/source0__chronicle_w_labels-0:
               receivers:
                   - udplog
               exporters:
                   - chronicle/chronicle_w_labels
   

   • 根据基础架构的需要替换端口和 IP 地址。
   • 将 <customer_id> 替换为实际的客户 ID。
   • 将 /path/to/ingestion-authentication-file.json 更新为获取 Google SecOps 提取身份验证文件部分中保存身份验证文件的路径。

重启 Bindplane 代理以应用更改

• 如需在 Linux 中重启 Bindplane 代理，请运行以下命令：

  sudo systemctl restart bindplane-agent
  

• 如需在 Windows 中重启 Bindplane 代理，您可以使用服务控制台，也可以输入以下命令：

  net stop BindPlaneAgent && net start BindPlaneAgent
  

为 VMware Tanzu 配置 Syslog

1. 登录 Tanzu Operations Manager 网页界面。
2. 选择您的用户名，然后点击设置。
3. 选择 Syslog。
4. 点击是以将系统日志发送到远程服务器。
5. 提供以下配置详细信息：
   • 地址：输入 Bindplane 代理 IP 地址。
   • 端口：输入 Bindplane 代理端口号。
   • 传输协议：根据实际的 Bindplane 代理配置，选择 UDP 或 TCP。
6. 点击保存。

UDM 映射表

日志字段	UDM 映射	逻辑
annotations.authorization.k8s.io/decision	security_result.action	如果注解 authorization.k8s.io/decision 存在，则将其值转换为大写。如果大写值为“ALLOW”，则 UDM 字段设置为 ALLOW。否则，该值会设置为 BLOCK。
annotations.authorization.k8s.io/reason	security_result.description	如果存在注解 authorization.k8s.io/reason，则使用其值（不含英文双引号）。
apiVersion	metadata.product_version	直接映射。
auditID	metadata.product_log_id	直接映射。
kind	metadata.product_event_type	直接映射。
objectRef.name	target.resource.name	直接映射。
objectRef.namespace	target.resource.attribute.labels.key，target.resource.attribute.labels.value	key 设置为“命名空间”，value 取自 objectRef.namespace。
objectRef.resource	target.resource.resource_subtype	直接映射。
objectRef.resourceVersion	target.resource.attribute.labels.key，target.resource.attribute.labels.value	key 设置为“resourceVersion”，value 取自 objectRef.resourceVersion。
objectRef.uid	target.resource.product_object_id	直接映射。
requestReceivedTimestamp/timestamp	metadata.event_timestamp	解析器会先尝试解析 requestReceivedTimestamp。如果不存在，则使用从 syslog 前缀中提取的 timestamp 字段。
requestURI	target.url	直接映射。
responseStatus.code	network.http.response_code	在转换为整数后直接映射。
sourceIPs	principal.ip	sourceIPs 数组中的所有 IP 地址都会添加到 principal.ip 数组中。
stage	metadata.description	直接映射。
stageTimestamp	metadata.collected_timestamp	直接映射。
user.groups	principal.user.group_identifiers	user.groups 数组中的所有群组都会添加到 principal.user.group_identifiers 数组中。
user.uid	principal.user.userid	直接映射。
user.username	principal.user.user_display_name	直接映射。
verb	network.http.method	在转换为大写后直接映射。由 verb 字段确定。如果 verb 为“CREATE”，则事件类型为 USER_RESOURCE_CREATION。如果 verb 为“PATCH”或“UPDATE”，则事件类型为 USER_RESOURCE_UPDATE_CONTENT。如果 verb 为“DELETE”，则事件类型为 USER_RESOURCE_DELETION。否则，如果 verb 不为空，则事件类型为 USER_RESOURCE_ACCESS。如果上述条件均不满足，则将事件类型设置为 GENERIC_EVENT。硬编码为“VMWARE_TANZU”。硬编码为“VMWARE”。硬编码为“VMWARE_TANZU”。硬编码为“CLUSTER”。

需要更多帮助？从社区成员和 Google SecOps 专业人士那里获得解答。