dsh-blue-team-mode 1.4.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,17 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.5.0 — 2026-11-13
4
+
5
+ ### Added
6
+
7
+ - 新增 `blue_attack_coverage`:把内置 13 条日志规则映射到 MITRE ATT&CK 技术和战术。
8
+ - 新增 `docs/blue-team-repos.md`:抽样调研 AiSOC、Security Onion、Sigma、APT-Hunter、UAC、VanGuard 等蓝队项目,记录借鉴与不借鉴的边界。
9
+
10
+ ### Notes
11
+
12
+ - 覆盖映射只代表内置日志规则,不代表 ATT&CK 全量覆盖。
13
+ - 没有引入 Sigma 规则库、外部工具、SIEM/EDR 或自动封禁。
14
+
3
15
  ## 1.4.0 — 2026-11-12
4
16
 
5
17
  ### Added
package/README.md CHANGED
@@ -10,7 +10,7 @@
10
10
  > 本仓库是蓝队编排、事实记录与辅助研判的工程实现,**不包含攻击、漏洞利用或未授权探测代码**。
11
11
  > 使用者必须自行确保对目标拥有书面授权,并遵守比赛规则与当地法律。
12
12
 
13
- **36 个 `blue_*` 工具 · 19 个随 npm 包技能 · 6 个执行角色 · 9 个控制台页签 · 10 张事实库表**
13
+ **37 个 `blue_*` 工具 · 19 个随 npm 包技能 · 6 个执行角色 · 9 个控制台页签 · 10 张事实库表**
14
14
 
15
15
  ---
16
16
 
@@ -47,7 +47,7 @@ dsh plugin --profile desktop add dsh-blue-team-mode
47
47
 
48
48
  ```sh
49
49
  dsh plugin --profile desktop add \
50
- https://github.com/FGCGDroid/blue/releases/download/v1.4.0/dsh-blue-team-mode-1.4.0.tgz
50
+ https://github.com/FGCGDroid/blue/releases/download/v1.5.0/dsh-blue-team-mode-1.5.0.tgz
51
51
  # 装完重启一次 dsh web
52
52
  ```
53
53
 
@@ -55,7 +55,7 @@ dsh plugin --profile desktop add \
55
55
 
56
56
  ```sh
57
57
  npm pack --pack-destination dist
58
- dsh plugin --profile desktop add ./dist/dsh-blue-team-mode-1.4.0.tgz
58
+ dsh plugin --profile desktop add ./dist/dsh-blue-team-mode-1.5.0.tgz
59
59
  ```
60
60
 
61
61
  **从源码目录安装**:
@@ -108,6 +108,7 @@ dsh plugin --profile desktop add .
108
108
  - **可选诱饵程序**:包内自带手动启动的 HTTP 诱饵,默认只监听 `127.0.0.1`,公开监听必须显式 `--allow-public`;提供 `generic/tomcat/thinkphp/wordpress` 静态主题;不执行命令、不抓指纹、不做无限响应。
109
109
  - **自动化流量标注**:诱饵服务按来源 IP 维护 1 秒行为窗口,命中高频请求、路径扫描或工具 UA 时打上 `automation_burst` / `path_sweep` / `automation_tool` 标签;只做研判,不自动封禁。
110
110
  - **执行摘要**:报告开头用事实库数字概括关键资产、未闭环高危告警、待审批任务和诱饵命中,方便直接发给人看。
111
+ - **ATT&CK 覆盖映射**:`blue_attack_coverage` 把内置 13 条日志规则映射到技术和战术,标出未映射规则;明确说明这不是全量覆盖。
111
112
  - **数据只在本机**:全部落在 `$DSH_HOME/blue/`,无遥测、无上报、无云端同步。
112
113
 
113
114
  ---
@@ -207,6 +208,7 @@ $DSH_HOME/blue/
207
208
  - 安全问题:[SECURITY](SECURITY.md)
208
209
  - 问题反馈:[Issues](https://github.com/FGCGDroid/blue/issues)
209
210
  - 开发说明:[docs/development.md](docs/development.md)
211
+ - 蓝队开源项目调研:[docs/blue-team-repos.md](docs/blue-team-repos.md)
210
212
 
211
213
  发版流程、测试命令和目录结构见开发说明。
212
214
 
@@ -0,0 +1,98 @@
1
+ # 蓝队开源项目调研
2
+
3
+ 这不是“GitHub 上所有蓝队仓库”的穷举,而是按 stars、主题和代表性做的抽样。
4
+
5
+ 抽样方向:
6
+
7
+ - `topic:blue-team`
8
+ - blue team tools / incident response toolkit
9
+ - DFIR / threat hunting
10
+ - detection engineering / Sigma
11
+ - MITRE ATT&CK
12
+
13
+ ## 看到的几类项目
14
+
15
+ | 项目 | 类型 | 值得借鉴 | 不照搬 |
16
+ | --- | --- | --- | --- |
17
+ | [AiSOC](https://github.com/beenuar/AiSOC) | AI SOC / 告警融合 | 告警归并、可审计的 agent 决策记录、人工批准后再响应 | 完整 SIEM、向量库、内置大模型栈 |
18
+ | [A-poc/BlueTeam-Tools](https://github.com/A-poc/BlueTeam-Tools) | 工具与技巧合集 | 按场景组织工具、先预检再使用 | 把几十个工具打包进插件 |
19
+ | [awesome-cybersecurity-blueteam](https://github.com/fabacab/awesome-cybersecurity-blueteam) | Awesome 列表 | 分类方式、覆盖范围 | 只做链接目录 |
20
+ | [fibratus](https://github.com/rabbitstack/fibratus) | Windows 传感器 | 行为检测、YARA、采集文件 | 内核传感器/EDR,不适合塞进 DSH 插件 |
21
+ | [Security Onion](https://github.com/Security-Onion-Solutions/securityonion) | 完整蓝队发行版 | 网络/主机/PCAP 一体化思路 | 整套 SIEM/IDS 发行版 |
22
+ | [SigmaHQ/sigma](https://github.com/SigmaHQ/sigma) | 检测规则标准 | 规则可移植、按 ATT&CK 组织 | 直接灌入几千条规则 |
23
+ | [APT-Hunter](https://github.com/ahmedkhlief/APT-Hunter) | Windows 日志狩猎 | 时间线输出、规则统计、Sigma 支持 | Python 引擎和 Windows 日志专用实现 |
24
+ | [RedEye](https://github.com/cisagov/RedEye) | C2 日志可视化 | 演示模式、把复杂数据讲给非技术人听 | 红队 C2 日志分析 |
25
+ | [UAC](https://github.com/tclahr/uac) | Unix 取证采集 | 证据清单、跨平台采集 | 采集器本身 |
26
+ | [VanGuard](https://github.com/ridgelinecyberdefence/vanguard) | DFIR 工具箱 | 证据哈希、chain of custody、ATT&CK 映射、按案件组织 | 单二进制、Velociraptor/KAPE 集成 |
27
+ | [DetectionLab](https://github.com/clong/DetectionLab) | 检测实验室 | 日志配置和检测验证思路 | 整套 VM 实验室 |
28
+ | [BlueTeamTools](https://github.com/abc123info/BlueTeamTools) | 中文蓝队分析工具箱 | 分析人员工作流、常用解码/流量分析入口 | 具体解密/漏洞利用功能 |
29
+
30
+ ## 真正值得吸收的
31
+
32
+ ### 1. 事实库 + 任务,而不是聊天记录
33
+
34
+ AiSOC、TheHive 类项目都把“发生了什么、谁在处理、证据是什么”分开存。
35
+ 我们的 `assets / alerts / findings / iocs / tasks / timeline` 已经是这个方向。
36
+
37
+ ### 2. 人工批准的响应
38
+
39
+ AiSOC 的“AI 提议、人批准、再交给执行器”和我们的 `pending_approval` 一致。
40
+ 自动 root 封禁不是精华,是风险。
41
+
42
+ ### 3. 可审计的决策记录
43
+
44
+ 不是只记“任务完成”,还要记:为什么这么做、依据哪条告警、谁批的、结果如何。
45
+ 当前时间线 + 审批字段已经覆盖一部分,后续可以再加独立的 decision ledger。
46
+
47
+ ### 4. ATT&CK 映射
48
+
49
+ APT-Hunter、VanGuard、Sigma 都把规则/事件映射到 ATT&CK。
50
+ 这次先做了**内置日志规则 → ATT&CK 技术**的静态覆盖表,见 `blue_attack_coverage`。
51
+
52
+ ### 5. 证据完整性
53
+
54
+ VanGuard 的双哈希、chain of custody 值得借鉴。
55
+ 当前 `blue_artifact_triage` 已有 SHA-256/MD5,但还缺“多文件证据清单 + 导出”。
56
+
57
+ ### 6. 报告说人话
58
+
59
+ RedEye 的演示模式、VanGuard 的 HTML 报告都强调“给非技术人看”。
60
+ 我们的报告已经加了执行摘要,但还可以继续压缩成 5 行老板版。
61
+
62
+ ## 明确不吸收的
63
+
64
+ - 完整 SIEM/EDR/传感器:Security Onion、Fibratus 是另一个产品层级,不是 DSH 插件该做的事。
65
+ - 捆绑几十个外部工具:维护、许可、供应链都不可控;继续只做 preflight 和编排。
66
+ - 自动封禁/隔离:误封代价太高,继续人工审批。
67
+ - 批量导入几千条 Sigma:误报和规则维护会拖垮插件;先做映射,不搬运规则库。
68
+ - 真实凭据、Cookie、WebRTC/Canvas 指纹:不做。
69
+ - 实时 LLM 生成假漏洞页面:不可控,不做。
70
+ - 采集器/内核驱动/内核 eBPF:不进入 DSH 进程。
71
+ - 红队 C2、反弹 Shell、漏洞利用:不属于蓝队插件。
72
+
73
+ ## 这次实际落地的
74
+
75
+ 新增:
76
+
77
+ ```text
78
+ blue_attack_coverage
79
+ ```
80
+
81
+ 它把内置 13 条日志规则映射到 ATT&CK 技术,输出:
82
+
83
+ - 覆盖了哪些技术
84
+ - 每个战术下有多少技术
85
+ - 哪些规则没映射
86
+ - 明确声明“不是全量覆盖”
87
+
88
+ 没有新增任何外部依赖,也没有把 Sigma 规则库塞进包。
89
+
90
+ ## 后续优先级
91
+
92
+ 1. 证据清单 + SHA-256 清单导出
93
+ 2. Sigma 规则导出(不是导入全库)
94
+ 3. 告警归并成 incident
95
+ 4. 决策 ledger
96
+ 5. 老板版 5 行摘要
97
+
98
+ 这些都比“再加一个自动封禁按钮”更有价值。
@@ -37,7 +37,7 @@ $DSH_HOME/blue/blue.db
37
37
 
38
38
  工具通过 `ctx.tools.register(defineTool(...))` 注册,模型看到的是普通工具调用,实际执行在 Host 进程。
39
39
 
40
- 主入口是 `lib/tools.js`,目前 36 个工具,覆盖:
40
+ 主入口是 `lib/tools.js`,目前 37 个工具,覆盖:
41
41
 
42
42
  - 目标与预检
43
43
  - 资产、告警、发现、IOC
@@ -75,7 +75,7 @@ monitor / intel / hunt / ir / forensics / hardening
75
75
  ```text
76
76
  lib/index.js Host 入口,挂载工具、UI、服务和技能
77
77
  lib/store.js SQLite 事实库
78
- lib/tools.js 36 个 blue_* 工具
78
+ lib/tools.js 37 个 blue_* 工具
79
79
  lib/hunter.js 1 秒行为窗口(只标注,不封禁)
80
80
  lib/ui.js /blue/api 和控制台数据
81
81
  lib/client.js DSH 客户端控制台
package/lib/attack.js ADDED
@@ -0,0 +1,74 @@
1
+ /**
2
+ * 内置日志规则到 MITRE ATT&CK 的静态映射。
3
+ *
4
+ * 这不是“ATT&CK 全覆盖”,只是让我们知道:
5
+ * 现有 13 条日志特征大致覆盖哪些战术/技术,哪些还没规则。
6
+ */
7
+ import { LOG_PATTERNS } from './playbooks.js'
8
+
9
+ export const TECHNIQUES = {
10
+ 'T1505.003': { tactic: 'persistence', name: 'Web Shell' },
11
+ 'T1059.001': { tactic: 'execution', name: 'PowerShell' },
12
+ 'T1059.004': { tactic: 'execution', name: 'Unix Shell' },
13
+ 'T1059.007': { tactic: 'execution', name: 'JavaScript' },
14
+ 'T1105': { tactic: 'command-and-control', name: 'Ingress Tool Transfer' },
15
+ 'T1190': { tactic: 'initial-access', name: 'Exploit Public-Facing Application' },
16
+ 'T1595': { tactic: 'reconnaissance', name: 'Active Scanning' },
17
+ 'T1110': { tactic: 'credential-access', name: 'Brute Force' },
18
+ 'T1053.005': { tactic: 'persistence', name: 'Scheduled Task' },
19
+ 'T1041': { tactic: 'exfiltration', name: 'Exfiltration Over C2 Channel' },
20
+ 'T1070': { tactic: 'defense-evasion', name: 'Indicator Removal' },
21
+ }
22
+
23
+ export const PATTERN_TECHNIQUES = {
24
+ 'php-webshell': ['T1505.003'],
25
+ 'jsp-webshell': ['T1505.003'],
26
+ 'aspx-webshell': ['T1505.003'],
27
+ 'powershell-cradle': ['T1059.001', 'T1105'],
28
+ 'linux-reverse-shell': ['T1059.004'],
29
+ 'sql-injection': ['T1190'],
30
+ 'path-traversal': ['T1190'],
31
+ xss: ['T1059.007'],
32
+ scanner: ['T1595'],
33
+ 'brute-force': ['T1110'],
34
+ persistence: ['T1053.005'],
35
+ exfil: ['T1041'],
36
+ 'log-tamper': ['T1070'],
37
+ }
38
+
39
+ /**
40
+ * @param {Array<{id:string,label:string}>} patterns
41
+ * @returns {{ total:number, mapped:number, unmapped:string[], techniques:Array, tactics:Array, note:string }}
42
+ */
43
+ export function attackCoverage(patterns = LOG_PATTERNS) {
44
+ const techniqueMap = new Map()
45
+ const unmapped = []
46
+ for (const pattern of patterns) {
47
+ const ids = PATTERN_TECHNIQUES[pattern.id]
48
+ if (!Array.isArray(ids) || ids.length === 0) {
49
+ unmapped.push(pattern.id)
50
+ continue
51
+ }
52
+ for (const id of ids) {
53
+ const meta = TECHNIQUES[id]
54
+ if (meta === undefined) {
55
+ unmapped.push(pattern.id)
56
+ continue
57
+ }
58
+ const item = techniqueMap.get(id) ?? { id, tactic: meta.tactic, name: meta.name, patterns: [] }
59
+ item.patterns.push(pattern.id)
60
+ techniqueMap.set(id, item)
61
+ }
62
+ }
63
+ const techniques = Array.from(techniqueMap.values()).sort((a, b) => a.id.localeCompare(b.id))
64
+ const tacticCount = new Map()
65
+ for (const item of techniques) tacticCount.set(item.tactic, (tacticCount.get(item.tactic) || 0) + 1)
66
+ return {
67
+ total: patterns.length,
68
+ mapped: patterns.length - new Set(unmapped).size,
69
+ unmapped: Array.from(new Set(unmapped)),
70
+ techniques,
71
+ tactics: Array.from(tacticCount, ([tactic, count]) => ({ tactic, count })).sort((a, b) => a.tactic.localeCompare(b.tactic)),
72
+ note: '这是内置日志规则到 ATT&CK 的映射,不代表 ATT&CK 全覆盖,也不代表已部署对应检测。',
73
+ }
74
+ }
package/lib/playbooks.js CHANGED
@@ -52,6 +52,7 @@ const ALL_TOOLS = [
52
52
  'blue_hardening_check', 'blue_containment_plan', 'blue_report', 'blue_defense_status',
53
53
  'blue_deception_plan', 'blue_decoy_create', 'blue_decoy_hit', 'blue_decoy_list',
54
54
  'blue_tarpit_plan', 'blue_honeypot_ingest',
55
+ 'blue_attack_coverage',
55
56
  'blue_tool_catalog',
56
57
  ]
57
58
  export const ALL_TOOL_NAMES = ALL_TOOLS
package/lib/tools.js CHANGED
@@ -14,6 +14,7 @@ import { dirname, isAbsolute, join, relative, resolve, basename, sep } from 'nod
14
14
  import { fileURLToPath } from 'node:url'
15
15
  import { spawnSync } from 'node:child_process'
16
16
  import { inferRisk, initialStatusForRisk, planCandidates } from './plan.js'
17
+ import { attackCoverage } from './attack.js'
17
18
  import { buildTaskSpec } from './taskspec.js'
18
19
  import { readBindings, writeBindings } from './bindings.js'
19
20
  import {
@@ -1683,6 +1684,14 @@ export function apply(ctx, config = {}) {
1683
1684
  }),
1684
1685
  }))
1685
1686
 
1687
+ register(defineTool({
1688
+ name: 'blue_attack_coverage',
1689
+ description: '查看内置日志规则对 MITRE ATT&CK 的覆盖映射:哪些技术有规则、哪些战术缺口、哪些规则未映射。不是全量覆盖率,也不代表已部署检测。',
1690
+ parameters: {},
1691
+ output: STRING_OUTPUT,
1692
+ execute: safe(async () => json({ ok: true, ...attackCoverage() })),
1693
+ }))
1694
+
1686
1695
  register(defineTool({
1687
1696
  name: 'blue_artifact_triage',
1688
1697
  description: '对本地样本/文件做只读取证初筛:SHA-256/MD5、类型、熵、字符串、URL/IP、可疑 API/命令特征。不会运行样本。',
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-blue-team-mode",
3
- "version": "1.4.0",
3
+ "version": "1.5.0",
4
4
  "description": "CTF 网络攻防蓝队防御模式:资产盘点、告警研判、威胁狩猎、应急响应、取证分析与加固修复,内置 SQLite 事实库、独立右侧栏控制台与自主任务派发队列。",
5
5
  "license": "MIT",
6
6
  "author": "FGCGDroid",
@@ -29,8 +29,8 @@ const ctx = {
29
29
  }
30
30
  apply(ctx, { profile: 'all' })
31
31
 
32
- if (tools.size !== 36) {
33
- throw new Error('工具数量不是 36:' + tools.size)
32
+ if (tools.size !== 37) {
33
+ throw new Error('工具数量不是 37:' + tools.size)
34
34
  }
35
35
  for (const [name, definition] of tools) {
36
36
  if (definition.parameters.type !== 'object' || typeof definition.parameters.properties !== 'object') {
@@ -51,6 +51,9 @@ const inScope = await call('blue_scope_check', { target: 'http://a.example.test/
51
51
  const outScope = await call('blue_scope_check', { target: '203.0.113.9' })
52
52
  if (!inScope.ok || inScope.status !== 'in') throw new Error('scope_check 未识别域名范围')
53
53
  if (outScope.ok || outScope.status !== 'out') throw new Error('scope_check 未识别范围外目标')
54
+ const coverage = await call('blue_attack_coverage', {})
55
+ if (!coverage.ok || coverage.total < 10 || coverage.mapped !== coverage.total) throw new Error('ATT&CK 覆盖映射不完整')
56
+ if (!coverage.techniques.some((item) => item.id === 'T1505.003')) throw new Error('ATT&CK 映射缺少 WebShell')
54
57
  const asset = await call('blue_asset_add', {
55
58
  name: 'web01', address: '10.10.0.5', kind: 'web', port: 80, criticality: 'critical', tags: ['flag'],
56
59
  })
@@ -355,7 +358,7 @@ for (const profile of ['monitor', 'intel', 'hunt', 'ir', 'forensics', 'hardening
355
358
  get() { return undefined },
356
359
  logger: { info() {}, warn() {}, error() {} },
357
360
  }, { profile })
358
- if (scoped.size === 0 || scoped.size >= 36) throw new Error(profile + ' 工具裁剪异常:' + scoped.size)
361
+ if (scoped.size === 0 || scoped.size >= 37) throw new Error(profile + ' 工具裁剪异常:' + scoped.size)
359
362
  if (!scoped.has('blue_task_update')) throw new Error(profile + ' 缺少任务回收工具')
360
363
  if (scoped.has('blue_autopilot')) throw new Error(profile + ' 不应拥有派发器')
361
364
  if (scoped.has('blue_task_approve')) throw new Error(profile + ' 不应拥有审批权')