dsh-ocsf-forwarder: DeepSeek Harness 的 OCSF 1.9.0 会话活动转发器

前言¶

DeepSeek Harness (DSH) 的核心能力体现在其事件流中，但这些原始数据需要经过标准化才能对接安全运营中心 (SOC)。dsh-ocsf-forwarder 插件的作用是将 DSH 的会话活动数据规范化为 OCSF 1.9.0 格式，并将其发送至目标接收端。它作为 read-side SIEM 转发器，运行在 DSH 代理进程中，负责数据的解析、分类与投递。

核心功能¶

该插件主要处理 DSH 的会话生命周期与工具调用行为：

事件订阅与关联：订阅 session/event、session/created 和 session/disposed 事件，并在挂载时扫描现有会话。它能关联 tool/call 与 tool/result，以及 approval/asked 与 approval/decided，从而计算批准决策延迟，作为“批准疲劳”的信号。
活动分类与命名：将工具调用分类为 Process Activity (1007)、File System Activity (1001)、HTTP Activity (4002)、Authorize Session (3003) 和 API Activity (6003)。对于 MCP 调用，它会解析并命名背后的 MCP 服务器。
外部委托与日志上传：当工具将任务委托给外部 Harness 时，发出高严重级别记录。同时记录会话日志上传行为，包括目的地服务和事件计数。
团队与共享任务：读取团队事件（如成员加入、消息唤醒）以及共享任务的写入范围。
完整性链与重放：将每个记录与 OCSF record_integrity 配置文件链接，支持通过 dsh-ocsf-verify 检查链完整性。支持重放恢复或分叉会话的构造函数种子。
隐私保护：在发送到 SOC 的数据中移除原始值，仅保留键值摘要、值分类和长度，避免敏感信息泄露。

安装与启用¶

安装前必须确保配置文件已包含可运行的代理（例如 @deepseek-ai/dsh-headless），否则插件将无法观察到任何事件。

1、安装核心依赖和插件：

dsh plugin --profile <name> add @deepseek-ai/dsh-headless@0.1.1-rc.2
dsh plugin --profile <name> add dsh-ocsf-forwarder

2、验证配置是否挂载成功：

dsh --profile <name> --dump-config

注意事项：
* 必须显式固定 @deepseek-ai/dsh-headless 版本（例如 0.1.1-rc.2），因为 latest 标签仍指向 0.0.1-rc.1。
* 需要的 DSH 版本范围为 0.1.0-rc.6 至 0.1.2。

配置与发送¶

插件通过 YAML 配置文件定义输出路径、接收端和隐私策略。

1、配置本地 Spool 和发送端（以 Splunk 为例）：

- id: dsh-ocsf-forwarder
  config:
    spoolPath: /var/log/dsh/ocsf.jsonl      # 绝对路径，权限建议 0640
    splunk:
      endpoint: https://splunk.example:8088
      token: { source: env, variable: SPLUNK_HEC_TOKEN }
    privacy:
      hmacKey: { source: env, variable: DSH_OCSF_KEY }

2、配置 OTLP/HTTP 收集器：
配置示例与 Splunk 类似，只需将 splunk 段替换为相应的 OTLP/HTTP 配置项。

完整性与验证¶

每个记录都包含 OCSF 1.9.0 的 record_integrity 认证，包含当前记录和上一条记录的 SHA-256 指纹。如果中间记录被篡改或删除，链式验证将失败。

1、检查 Spool 文件完整性：

dsh-ocsf-verify /var/log/dsh/ocsf.jsonl

返回 0 表示完整。
返回 1 表示链中断。
返回 2 表示文件不可读。

2、使用 SIEM 中的锚点文件进行验证：

dsh-ocsf-verify --anchor shipped.jsonl /var/log/dsh/ocsf.jsonl

在 Linux 系统上，可以使用 chattr +a 对 Spool 文件进行加固，使其拒绝截断和重写，从而防止数据被破坏。

适用场景与注意¶

适用场景：需要将 DSH 会话活动结构化导入 SOC，关注批准疲劳分析、外部委托检测以及会话日志审计的组织。
运行边界：插件以代理进程的 UID 运行，不是遏制边界。如果代理具有运行 bash 的权限，理论上可以删除或重写 Spool 文件，并重新计算哈希链。
能力边界：插件从不写入会话日志，也不注册瀑布流监听器，因此无法修改工具调用、批准决策或模型请求。它也不提供任何检测内容、告警或密钥检测器。

总结¶

dsh-ocsf-forwarder 提供了一种将 DeepSeek Harness 事件流标准化并安全投递到 SOC 的机制。通过 OCSF 1.9.0 规范化和完整性链验证，它确保了审计数据的可追溯性与防篡改能力。

目录页: dsh-ocsf-forwarder
源码: GitHub Repository