dsh-blue-team-mode 1.3.2 → 1.4.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 +15 -0
- package/README.md +219 -542
- package/docs/development.md +143 -0
- package/lib/hunter.js +76 -0
- package/lib/store.js +7 -0
- package/package.json +7 -2
- package/scripts/decoy-server.mjs +28 -9
- package/scripts/test-decoy-server.mjs +7 -3
- package/scripts/test-hunter.mjs +21 -0
- package/skills/decoy-server.md +12 -2
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,20 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 1.4.0 — 2026-11-12
|
|
4
|
+
|
|
5
|
+
### Added
|
|
6
|
+
|
|
7
|
+
- 轻量行为窗口 `lib/hunter.js`:按来源 IP 统计 1 秒窗口内的请求数、路径数和工具指纹。
|
|
8
|
+
- 诱饵日志新增 `tags` / `risk`:`automation_burst`、`path_sweep`、`automation_tool`。
|
|
9
|
+
- 诱饵服务新增 `--theme generic/tomcat/thinkphp/wordpress` 静态主题。
|
|
10
|
+
- 报告新增一段“执行摘要”,用事实库数字概括关键资产、待审批任务和诱饵命中。
|
|
11
|
+
|
|
12
|
+
### Safety
|
|
13
|
+
|
|
14
|
+
- 行为标签只做展示和研判,不自动封禁。
|
|
15
|
+
- 不调用大模型实时生成假漏洞页面;诱饵主题仍是静态模板。
|
|
16
|
+
- 不新增绕过 `pending_approval` 的自动 root 封禁。
|
|
17
|
+
|
|
3
18
|
## 1.3.2 — 2026-11-11
|
|
4
19
|
|
|
5
20
|
### Security
|
package/README.md
CHANGED
|
@@ -1,542 +1,219 @@
|
|
|
1
|
-
#
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
>
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
---
|
|
16
|
-
|
|
17
|
-
##
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
dsh
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
```sh
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
## 独立控制台(右侧常驻面板)
|
|
221
|
-
|
|
222
|
-
这是一个挂在 `shell.overlay` 上的独立右侧面板,不再是右侧栏里的文件 tab:有自己的标题栏、页签、底部状态栏,可拖拽调宽,也可以全屏。原生右侧栏打开时面板会自动让位隐藏,关闭原生右侧栏后恢复。界面按红队控制台的设计语言重做:品牌头、状态胶囊、指标卡、防守阶段、双栏处置区、可滚动表格与任务结论弹窗,全部使用 DSH 主题 token。
|
|
223
|
-
|
|
224
|
-
- **入口**:会话头部右侧的 **「蓝队」** 按钮,一键打开/收起。
|
|
225
|
-
- 左下角的常驻入口已取消;全面浏览只从面板标题栏的全屏按钮进入。
|
|
226
|
-
|
|
227
|
-
面板默认打开;拖拽左边界可调宽,点标题栏的全屏按钮进入全面浏览,`Esc` 退出。控制台页签:
|
|
228
|
-
|
|
229
|
-
| 页签 | 内容 | 可执行操作 |
|
|
230
|
-
| --- | --- | --- |
|
|
231
|
-
| 态势 | 资产/告警/发现/IOC/任务统计、关键告警、任务队列 | 规划任务、刷新、调整并发、生成报告 |
|
|
232
|
-
| 告警 | 级别、来源、状态、时间 | 确认、标误报、转处置任务 |
|
|
233
|
-
| 资产 | 关键级别、地址、端口、服务、状态 | 新增/更新资产 |
|
|
234
|
-
| 发现 | 严重级别、类型、状态 | 标记已修复、接受风险 |
|
|
235
|
-
| 任务 | 优先级、角色、状态、任务书 | 领取(生成 subagent 任务书)、完成、阻塞 |
|
|
236
|
-
| IOC | 类型、值、置信度、来源 | 新增 IOC |
|
|
237
|
-
| 诱饵 | 诱饵类型、目标、状态、命中次数 | 查看(部署仍由人工执行) |
|
|
238
|
-
| 时间线 | 时间、主体、动作、对象、详情 | 查看 |
|
|
239
|
-
| 报告 | 从事实库生成的 Markdown | 生成/刷新 |
|
|
240
|
-
|
|
241
|
-
**领取任务**会把任务置为 `dispatched`,并弹出可直接复制的完整任务书(含 `agent_preset`)。控制台本身不能代替 Agent 调用 `subagent`,但把任务书交给指挥官即可继续自主循环。
|
|
242
|
-
|
|
243
|
-
Host 半侧通过 `POST /blue/api` 提供同源 JSON 桥接(Origin/Host 校验),读写的仍是 `ctx.blueTeam` 那一份 SQLite;浏览器侧不直接碰数据库。
|
|
244
|
-
|
|
245
|
-
会话与目标的绑定会镜像到 `$DSH_HOME/blue/session-bindings.json`,控制台据此显示当前会话对应的防守目标;没有绑定时回退到最近一个活跃目标。
|
|
246
|
-
|
|
247
|
-
### 全面浏览
|
|
248
|
-
|
|
249
|
-
和红队一致:
|
|
250
|
-
|
|
251
|
-
- 桌面客户端用同窗全屏 overlay;
|
|
252
|
-
- 普通 Web 优先打开新窗口,URL 带 `#blue-full`;
|
|
253
|
-
- 标题切为「蓝队全面浏览」,右上角显示「退出全面浏览」;
|
|
254
|
-
- `Esc` 退出;全屏时隐藏拖拽边界,内容铺满窗口。
|
|
255
|
-
|
|
256
|
-

|
|
257
|
-
|
|
258
|
-

|
|
259
|
-
|
|
260
|
-
---
|
|
261
|
-
|
|
262
|
-
## 六个执行角色
|
|
263
|
-
|
|
264
|
-
| agent_preset | 角色 | 主要职责 | 默认优先级 |
|
|
265
|
-
| --- | --- | --- | --- |
|
|
266
|
-
| `blue-worker-monitor` | 监控值守 | 告警研判、可用性、首轮止血 | P0/P1 |
|
|
267
|
-
| `blue-worker-intel` | 情报分析 | IOC、检测规则、误报评估 | P2 |
|
|
268
|
-
| `blue-worker-hunt` | 威胁狩猎 | WebShell、横向、持久化、外带 | P1/P2 |
|
|
269
|
-
| `blue-worker-ir` | 应急响应 | PICERL、隔离、清除、恢复 | P0/P1 |
|
|
270
|
-
| `blue-worker-forensics` | 取证分析 | 磁盘/内存/日志/样本、时间线 | P1/P2 |
|
|
271
|
-
| `blue-worker-hardening` | 加固修复 | 修入口、收敛暴露面、补检测 | P1/P3 |
|
|
272
|
-
| `blue-worker` | 全工具执行 | 不确定角色时的兜底 | 按任务 |
|
|
273
|
-
|
|
274
|
-
执行角色是**叶子节点**:预设里没有 `subagent` / `workflow` / `ralph`,需要别的角色时只能写 `needs:` 交给指挥官。
|
|
275
|
-
|
|
276
|
-
---
|
|
277
|
-
|
|
278
|
-
## 工具(36 个)
|
|
279
|
-
|
|
280
|
-
### 目标与预检
|
|
281
|
-
|
|
282
|
-
| 工具 | 作用 |
|
|
283
|
-
| --- | --- |
|
|
284
|
-
| `blue_engagement_open` | 建立/复用防守目标并绑定当前会话(子智能体继承) |
|
|
285
|
-
| `blue_session_info` | 查看当前绑定、父会话链、是否子智能体 |
|
|
286
|
-
| `blue_scope_check` | 检查 IP/域名/URL 是否在防守范围 |
|
|
287
|
-
| `blue_preflight` | 工具链与环境变量自检,缺什么给替代方案 |
|
|
288
|
-
| `blue_defense_selfcheck` | 开局门禁:用户明确说「防御自检」后调用,放行本会话 |
|
|
289
|
-
|
|
290
|
-
### 资产与告警
|
|
291
|
-
|
|
292
|
-
| 工具 | 作用 |
|
|
293
|
-
| --- | --- |
|
|
294
|
-
| `blue_asset_add` | 登记/更新资产(域名/IP/端口/服务/关键级别) |
|
|
295
|
-
| `blue_asset_query` | 查询资产清单 |
|
|
296
|
-
| `blue_alert_ingest` | 接入告警(字段或 JSON 数组,自动去重) |
|
|
297
|
-
| `blue_alert_list` | 按状态/级别/来源过滤 |
|
|
298
|
-
| `blue_alert_triage` | 研判告警,可一键转处置任务 |
|
|
299
|
-
|
|
300
|
-
### IOC 与发现
|
|
301
|
-
|
|
302
|
-
| 工具 | 作用 |
|
|
303
|
-
| --- | --- |
|
|
304
|
-
| `blue_ioc_add` | 登记 IOC(ip/domain/url/hash/ua…) |
|
|
305
|
-
| `blue_ioc_list` | 查询 IOC |
|
|
306
|
-
| `blue_ioc_check` | 用 IOC + 内置特征扫描文本/日志 |
|
|
307
|
-
| `blue_finding_add` | 登记漏洞/暴露面/失陷痕迹,带证据与建议 |
|
|
308
|
-
| `blue_finding_update` | 更新发现状态/级别/证据/建议(修复闭环) |
|
|
309
|
-
| `blue_finding_list` | 查询发现 |
|
|
310
|
-
|
|
311
|
-
### 任务与自主派发
|
|
312
|
-
|
|
313
|
-
| 工具 | 作用 |
|
|
314
|
-
| --- | --- |
|
|
315
|
-
| `blue_task_create` | 手动建任务(角色/优先级/简报/验收;high 自动进入待审批) |
|
|
316
|
-
| `blue_task_update` | 更新状态与结论(done/blocked/…;不能绕过审批直接派发 high) |
|
|
317
|
-
| `blue_task_list` | 查看队列(含 risk_level/approved_by) |
|
|
318
|
-
| `blue_task_approve` | **人工放行** high 待审批任务,写 approved_by/at 与 timeline |
|
|
319
|
-
| `blue_autopilot` | **核心编排器**:`status` / `plan` / `next` / `cycle` / `complete` / `set_slots` |
|
|
320
|
-
|
|
321
|
-
### 风险闸与审批
|
|
322
|
-
|
|
323
|
-
- `low`:只读排查、日志确认、IOC 提取、报告;
|
|
324
|
-
- `medium`:非破坏性核对、可回滚加固建议;
|
|
325
|
-
- `high`:隔离主机、删除/隔离文件、改防火墙、杀进程、禁用账号、重置凭据、改启动项/内核参数。
|
|
326
|
-
|
|
327
|
-
`high` 任务只能进入 `pending_approval`,不会出现在 `cycle` 的 `dispatch` 里。控制台点「批准」,或由指挥官调用 `blue_task_approve`,才会变成 `queued`;审批会写 `approved_by`、`approved_at`、`approval_note` 和 timeline 的 `approval` 事件。
|
|
328
|
-
|
|
329
|
-
自动派发还带轮次上限和冷却窗口,避免“任务 → 新告警 → 再派任务”自转。
|
|
330
|
-
|
|
331
|
-
`blue_autopilot action=cycle` 会返回:
|
|
332
|
-
|
|
333
|
-
```json
|
|
334
|
-
{
|
|
335
|
-
"dispatches": [
|
|
336
|
-
{
|
|
337
|
-
"task_id": "TSK-...",
|
|
338
|
-
"role": "ir",
|
|
339
|
-
"risk_level": "high",
|
|
340
|
-
"requires_approval": true,
|
|
341
|
-
"approved_by": "console",
|
|
342
|
-
"approved_at": "2026-...",
|
|
343
|
-
"agent_preset": "blue-worker-ir",
|
|
344
|
-
"dispatch": {
|
|
345
|
-
"tool": "subagent",
|
|
346
|
-
"arguments": {
|
|
347
|
-
"description": "应急响应:处置告警:...",
|
|
348
|
-
"prompt": "【角色职责】...【任务】...【验收标准】...",
|
|
349
|
-
"agent_preset": "blue-worker-ir"
|
|
350
|
-
},
|
|
351
|
-
"task_id": "TSK-...",
|
|
352
|
-
"risk_level": "high",
|
|
353
|
-
"requires_approval": true,
|
|
354
|
-
"approved_by": "console",
|
|
355
|
-
"approved_at": "2026-..."
|
|
356
|
-
}
|
|
357
|
-
}
|
|
358
|
-
],
|
|
359
|
-
"remaining_slots": 2
|
|
360
|
-
}
|
|
361
|
-
```
|
|
362
|
-
|
|
363
|
-
指挥官原样调用 `subagent` 即可;任务书已经自包含(目标、已知事实、证据要求、验收标准、`needs:` 格式)。
|
|
364
|
-
|
|
365
|
-
### 分析、处置与报告
|
|
366
|
-
|
|
367
|
-
| 工具 | 作用 |
|
|
368
|
-
| --- | --- |
|
|
369
|
-
| `blue_timeline` | 记录/查看事件时间线 |
|
|
370
|
-
| `blue_playbook_list` | 列出 19 个随包蓝队技能 |
|
|
371
|
-
| `blue_log_scan` | 日志/文本攻击特征 + IOC 扫描 |
|
|
372
|
-
| `blue_artifact_triage` | 样本只读初筛:哈希/类型/熵/字符串/可疑 API |
|
|
373
|
-
| `blue_hardening_check` | 本机加固基线快检(端口/防火墙/账号/SSH/审计) |
|
|
374
|
-
| `blue_containment_plan` | 按事件类型生成处置剧本 |
|
|
375
|
-
| `blue_deception_plan` | 授权范围内的诱饵方案与安全边界 |
|
|
376
|
-
| `blue_decoy_create` | 登记诱饵(不自动部署),必须 `authorized=true` 且目标在 scope 内 |
|
|
377
|
-
| `blue_decoy_hit` | 记录诱饵命中并生成 `deception` 告警 |
|
|
378
|
-
| `blue_decoy_list` | 查看诱饵状态、命中次数与最近命中时间 |
|
|
379
|
-
| `blue_tarpit_plan` | 生成 Endlessh/假路径/有界慢响应/fail2ban 7 天 jail 配置,不部署、不执行 |
|
|
380
|
-
| `blue_honeypot_ingest` | 接收蜜罐事件,生成告警和 high 风险待审批封禁任务,不自动调用防火墙 |
|
|
381
|
-
| `blue_report` | 从事实库生成 Markdown 报告;写文件时只允许 `$DSH_HOME/blue/reports/` 下的路径 |
|
|
382
|
-
| `blue_defense_status` | 一眼看态势与下一步建议 |
|
|
383
|
-
| `blue_tool_catalog` | 外部蓝队工具目录(用途/示例) |
|
|
384
|
-
|
|
385
|
-
---
|
|
386
|
-
|
|
387
|
-
## 自主派发机制
|
|
388
|
-
|
|
389
|
-
`blue_autopilot` 的任务来源:
|
|
390
|
-
|
|
391
|
-
1. **未闭环告警**:critical → `ir`,high → `hunt`,其余 → `monitor`;
|
|
392
|
-
2. **未闭环高危发现**:WebShell/RCE/上传类 → `ir`,其余 → `hardening`;
|
|
393
|
-
3. **重点资产覆盖**:critical/high 且没有发现的资产 → `hunt` 失陷痕迹核查;
|
|
394
|
-
4. **基线缺口**:没资产 → `monitor` 盘点;没 IOC → `intel`;没告警 → `monitor` 接日志;始终有 `hardening` 基线项。
|
|
395
|
-
|
|
396
|
-
去重规则:同标题任务未关闭前不重复创建,避免自主循环刷爆队列。
|
|
397
|
-
|
|
398
|
-
风险闸:
|
|
399
|
-
|
|
400
|
-
- `high` 任务由 `ir`/`hardening` 的隔离、删除、防火墙、杀进程、禁用账号、改启动项等动作触发;
|
|
401
|
-
- 高风险任务只进入 `pending_approval`,`cycle/next` 不会派发;
|
|
402
|
-
- 控制台「批准」或 `blue_task_approve` 才转 `queued`,并写入 `approved_by/approved_at/approval_note` 与 timeline `approval`;
|
|
403
|
-
- `cycle` 有 `max_rounds`(默认 12)与 `cooldown_sec`(默认 30)限制,防止任务→告警→再派任务自转。
|
|
404
|
-
|
|
405
|
-
并发规则:
|
|
406
|
-
|
|
407
|
-
- 默认 3(`blue_autopilot action=set_slots slots=3`,上限 8);
|
|
408
|
-
- `cycle` 会先读 `ctx.subagents.listChildren` 的真实运行数,再按剩余名额领取;
|
|
409
|
-
- 名额满时返回 `slots_full`,指挥官应等待而不是硬塞。
|
|
410
|
-
|
|
411
|
-
> **边界说明**:`blue_autopilot` 负责"计划 + 领取 + 生成可直接调用的 subagent 参数 + 回收";
|
|
412
|
-
> 真正的 `subagent` 调用由模型执行(DSH 的工具注册表不允许插件代替 Agent 发起委派)。
|
|
413
|
-
> 因此"自主"指的是循环与队列自动推进,而不是绕过模型直接开进程。
|
|
414
|
-
|
|
415
|
-
---
|
|
416
|
-
|
|
417
|
-
## 数据模型
|
|
418
|
-
|
|
419
|
-
数据库:`$DSH_HOME/blue/blue.db`(WAL)。
|
|
420
|
-
|
|
421
|
-
| 表 | 内容 |
|
|
422
|
-
| --- | --- |
|
|
423
|
-
| `engagements` | 防守目标、范围、状态 |
|
|
424
|
-
| `assets` | 资产(kind/address/port/service/criticality/owner/tags/evidence) |
|
|
425
|
-
| `alerts` | 告警(severity/source/confidence/task_id/status/assignee/note/raw,指纹去重) |
|
|
426
|
-
| `findings` | 发现(severity/category/confidence/source/task_id/cve/evidence/recommendation/status) |
|
|
427
|
-
| `iocs` | IOC(type/value/confidence/source/note/first_seen/last_seen,(engagement,type,value) 唯一) |
|
|
428
|
-
| `tasks` | 任务(role/priority/status/risk_level/requires_approval/approved_by/approved_at/scope/constraints/expected_output/brief/acceptance/result/时间戳) |
|
|
429
|
-
| `timeline` | 时间线(at/actor/action/target/detail) |
|
|
430
|
-
| `meta` | 并发上限等运行配置 |
|
|
431
|
-
|
|
432
|
-
所有写入都通过 `blue_*` 工具;智能体不直接写 SQL。
|
|
433
|
-
|
|
434
|
-
### 判定层
|
|
435
|
-
|
|
436
|
-
`lib/judge.js` 是唯一状态机与未闭环判定来源:
|
|
437
|
-
|
|
438
|
-
- 任务合法迁移表:`queued / pending_approval / dispatched / running / done / blocked / cancelled`;
|
|
439
|
-
- 告警未闭环:`open / investigating`;
|
|
440
|
-
- 发现未闭环:`open`;
|
|
441
|
-
- `postureOf()` 统一输出 `stable / warning / critical`;
|
|
442
|
-
- store、plan、控制台统计都读同一套枚举,不在各角色里散写 if。
|
|
443
|
-
|
|
444
|
-
### TaskSpec
|
|
445
|
-
|
|
446
|
-
`lib/taskspec.js` 定义 `TASK_SPEC_SCHEMA` 与统一渲染:
|
|
447
|
-
|
|
448
|
-
- `markdown`:控制台「领取」/ autopilot 的 `prompt`;
|
|
449
|
-
- `json`:dispatch 里的 `task_spec`,供子智能体/审计消费;
|
|
450
|
-
- 字段:`task_id/role/title/priority/risk_level/requires_approval/approved_by/scope/constraints/expected_output/acceptance/brief`;
|
|
451
|
-
- `TaskSpec` 的 `scope/constraints/expected_output` 同时写进 tasks 表,避免只存在于 prompt。
|
|
452
|
-
|
|
453
|
-
### 合规闸门
|
|
454
|
-
|
|
455
|
-
```sh
|
|
456
|
-
node scripts/install-hooks.mjs
|
|
457
|
-
node scripts/check-compliance.mjs --selftest
|
|
458
|
-
```
|
|
459
|
-
|
|
460
|
-
`pre-commit` 会扫描暂存区中的 GitHub token、AWS key、私钥等模式,并检查 `DISCLOSURE` 存在;`--selftest` 会同时确认 hook 文件与 `core.hooksPath` 确实接在提交路径上。
|
|
461
|
-
|
|
462
|
-
---
|
|
463
|
-
|
|
464
|
-
## 随包技能(19 个)
|
|
465
|
-
|
|
466
|
-
`blue-setup`、`incident-response`、`log-analysis`、`webshell-hunt`、`threat-hunting`、`host-forensics`、`memory-forensics`、`malware-triage`、`network-forensics`、`hardening`、`ioc-management`、`ctf-defense`、`reporting`、`containment`、`web-attack-triage`、`cloud-k8s-defense`、`deception-defense`、`honeypot-tarpit`、`decoy-server`。
|
|
467
|
-
|
|
468
|
-
技能同步到 `$DSH_HOME/blue/skills`,由预设的 `skill-filesystem` 发现;用户自己的 `$DSH_HOME/skills` 优先级更高,可覆盖同名技能。
|
|
469
|
-
|
|
470
|
-
---
|
|
471
|
-
|
|
472
|
-
## 控制台 E2E
|
|
473
|
-
|
|
474
|
-
`scripts/test-ui-e2e.mjs` 用本机 Chrome + CDP 真实点击控制台「批准」按钮,验证:
|
|
475
|
-
|
|
476
|
-
1. 点击确实发出 `approveTask` 请求;
|
|
477
|
-
2. Host API 把任务从 `pending_approval` 改成 `queued`;
|
|
478
|
-
3. `approved_by/approved_at` 落库;
|
|
479
|
-
4. UI 任务行不再显示批准按钮,并显示 queued/审批人。
|
|
480
|
-
|
|
481
|
-
前置:DSH Web 已加载最新插件并保持运行。
|
|
482
|
-
|
|
483
|
-
```sh
|
|
484
|
-
BLUE_E2E_URL='http://127.0.0.1:PORT/?token=...' npm run test:e2e
|
|
485
|
-
```
|
|
486
|
-
|
|
487
|
-
需要本机 Chrome/Chromium;可用 `CHROME_PATH` 指定路径。脚本不依赖 Playwright,不会下载浏览器,测试结束会关闭自己启动的 Chrome、清理临时 profile,并删除本次创建的 `E2E 审批 ...` engagement。
|
|
488
|
-
|
|
489
|
-
---
|
|
490
|
-
|
|
491
|
-
## 配置
|
|
492
|
-
|
|
493
|
-
`cordis.patch.yml` 中事实库默认根目录:
|
|
494
|
-
|
|
495
|
-
```yaml
|
|
496
|
-
- id: blue-mode-store
|
|
497
|
-
name: dsh-blue-team-mode/store
|
|
498
|
-
config:
|
|
499
|
-
root: !!js dshHomePath('blue')
|
|
500
|
-
```
|
|
501
|
-
|
|
502
|
-
可用环境变量覆盖:`BLUE_HOME`(数据根)、`DSH_HOME`(默认 `~/.dsh`)。
|
|
503
|
-
|
|
504
|
-
执行角色的工具裁剪在 `lib/tools.js` 里按 `profile` 实现;改 `presets/blue/worker.cordis.yml` 后跑:
|
|
505
|
-
|
|
506
|
-
```sh
|
|
507
|
-
node scripts/build.mjs
|
|
508
|
-
```
|
|
509
|
-
|
|
510
|
-
重新生成 `cordis.patch.yml`(不要手改生成区)。
|
|
511
|
-
|
|
512
|
-
---
|
|
513
|
-
|
|
514
|
-
## 验证与排障
|
|
515
|
-
|
|
516
|
-
CI 工作流:`.github/workflows/ci.yml`,在 Linux + Node 24 上跑工具测试、UI 注册测试、构建、校验与合规自测,并检查 `cordis.patch.yml` 没有未提交变化。
|
|
517
|
-
|
|
518
|
-
- 安装后 `Config.listConfigs name=@deepseek-ai/dsh-agent-preset` 应出现 `preset-blue` 与 `preset-blue-worker*`,状态为 `schema` 而不是 `broken`。
|
|
519
|
-
- 新模式列表里应出现「蓝队防御模式」;子预设显示名带「由主会话自动选用」。
|
|
520
|
-
- 会话内 `blue_defense_status` 应返回版本、数据目录、技能数量。
|
|
521
|
-
- 独立面板:会话头部出现「蓝队」;刷新后右侧常驻面板默认打开,可拖拽左边界调宽,标题栏可进入全面浏览。左下角不再有入口。
|
|
522
|
-
- 控制台接口:`POST /blue/api` 应返回 JSON;404/403 时检查 `blue-mode-ui` 行是否激活、页面是否同源。
|
|
523
|
-
- 控制台空白:先在会话里 `blue_engagement_open`,或在面板空态新建目标;`session-bindings.json` 应存在。
|
|
524
|
-
- 工具不出现:确认使用的是蓝队预设(工具行只挂在预设平面,不会污染其它会话)。
|
|
525
|
-
- 数据库 locked:确认没有多个 Host 同时写同一 `blue.db`;WAL + busy_timeout 已启用。
|
|
526
|
-
- 预设激活失败:看 `$DSH_HOME/logs` 或 `dsh --profile desktop --dump-config`;常见原因是 `dsh-blue-team-mode/tools` 包未装进 profile。
|
|
527
|
-
|
|
528
|
-
---
|
|
529
|
-
|
|
530
|
-
## 限制
|
|
531
|
-
|
|
532
|
-
- 不捆绑任何外部工具(nmap/tshark/yara/volatility 等),只检查与编排;需要用户自行准备。
|
|
533
|
-
- `blue_hardening_check` 只读执行少量系统命令,跨平台覆盖有限;结果需人工复核。
|
|
534
|
-
- 日志/样本扫描是特征匹配,不能替代深度取证;高熵/加壳样本需沙箱或内存分析。
|
|
535
|
-
- 任务"自主"推进依赖模型调用 `subagent`;插件不绕过 DSH 的委派与审批机制。控制台可以规划、领取、完成、阻塞任务,但不能代替 Agent 发起委派。
|
|
536
|
-
- SQLite 事实库是单机本地库,不做多机同步;多人协作请各自导出报告合并。
|
|
537
|
-
|
|
538
|
-
---
|
|
539
|
-
|
|
540
|
-
## License
|
|
541
|
-
|
|
542
|
-
MIT。见 `LICENSE`(如未随包提供,按 MIT 使用)。使用前请阅读 `DISCLOSURE`。
|
|
1
|
+
# DSH BlueTeam 模式
|
|
2
|
+
|
|
3
|
+
> 本插件由 **FGCGDroid** 和 **大肥鱼** 一起创作。
|
|
4
|
+
|
|
5
|
+
把 [DeepSeek Harness](https://github.com/deepseek-ai)(DSH)变成一张**蓝队防守指挥台**:
|
|
6
|
+
只给一个防守目标,主会话拉起监控值守、情报分析、威胁狩猎、应急响应、取证分析、加固修复六个执行角色;
|
|
7
|
+
资产、告警、发现、IOC、任务与时间线实时写进本机 SQLite,右侧常驻控制台同步可视化。
|
|
8
|
+
|
|
9
|
+
> ⚠️ **仅限已获授权的 CTF 靶场 / 攻防演练 / 自有资产防守使用。**
|
|
10
|
+
> 本仓库是蓝队编排、事实记录与辅助研判的工程实现,**不包含攻击、漏洞利用或未授权探测代码**。
|
|
11
|
+
> 使用者必须自行确保对目标拥有书面授权,并遵守比赛规则与当地法律。
|
|
12
|
+
|
|
13
|
+
**36 个 `blue_*` 工具 · 19 个随 npm 包技能 · 6 个执行角色 · 9 个控制台页签 · 10 张事实库表**
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 安装
|
|
18
|
+
|
|
19
|
+
```sh
|
|
20
|
+
dsh plugin --profile desktop add dsh-blue-team-mode
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
装完**重启一次 `dsh web`**,在助手栏选择预设 **蓝队防御模式**。
|
|
24
|
+
|
|
25
|
+
第一条消息必须是:
|
|
26
|
+
|
|
27
|
+
```text
|
|
28
|
+
防御自检
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
自检通过后,直接发防守目标即可开工:
|
|
32
|
+
|
|
33
|
+
```text
|
|
34
|
+
防守目标:example-ctf 靶场,范围 10.10.0.0/24 和 *.example.test。
|
|
35
|
+
先盘点资产、接入告警,然后自主派活。
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
**环境准备**:本插件不提供 nmap、tshark、suricata、zeek、yara、volatility、fail2ban 等外部工具的下载或安装;运行 `blue_preflight` 查看缺什么,工具由你自行准备。
|
|
39
|
+
|
|
40
|
+
> 前置:DSH 能正常 `dsh web` 启动;Node.js ≥ 22.13(依赖内置 `node:sqlite`)。
|
|
41
|
+
> 建议跑在专用的演练机、Docker 或虚拟机里,不要直接跑在存有生产密钥的宿主机账户下。
|
|
42
|
+
|
|
43
|
+
<details>
|
|
44
|
+
<summary>从 tarball 安装 / 从源码安装(开发者)</summary>
|
|
45
|
+
|
|
46
|
+
**从 GitHub Release 安装指定版本**:
|
|
47
|
+
|
|
48
|
+
```sh
|
|
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
|
|
51
|
+
# 装完重启一次 dsh web
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
**本地 tarball**:
|
|
55
|
+
|
|
56
|
+
```sh
|
|
57
|
+
npm pack --pack-destination dist
|
|
58
|
+
dsh plugin --profile desktop add ./dist/dsh-blue-team-mode-1.4.0.tgz
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
**从源码目录安装**:
|
|
62
|
+
|
|
63
|
+
```sh
|
|
64
|
+
dsh plugin --profile desktop add .
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
源码模式修改后需要重新 `add` 或重启,npm 安装的副本不会自动跟着源码变。
|
|
68
|
+
|
|
69
|
+
</details>
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
## 它解决什么问题
|
|
74
|
+
|
|
75
|
+
手工防守常见的三个问题:
|
|
76
|
+
|
|
77
|
+
1. **信息散**:告警在 WAF、日志在服务器、样本在桌面、结论在聊天里,复盘时对不上。
|
|
78
|
+
2. **派活乱**:指挥官一边盯告警一边自己扫日志,忘了还有哪些资产没看。
|
|
79
|
+
3. **没证据**:子智能体说“清掉了”,但库里没有记录,报告写不出来。
|
|
80
|
+
|
|
81
|
+
蓝队模式把这三件事压到一条流水线上:
|
|
82
|
+
|
|
83
|
+
```text
|
|
84
|
+
日志 / 告警 / 样本
|
|
85
|
+
→ blue_* 工具
|
|
86
|
+
→ SQLite 事实库
|
|
87
|
+
→ 控制台 / 报告 / 任务
|
|
88
|
+
→ subagent 执行
|
|
89
|
+
→ 结果回写事实库
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
**结论必须落库。** 子智能体说“处理完了”不算,任务、时间线、告警状态里要有记录。
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## 功能
|
|
97
|
+
|
|
98
|
+
- **一套角色分工**:主会话只做指挥(计划、派活、核对落库、汇报),动手的活交给监控值守 / 情报分析 / 威胁狩猎 / 应急响应 / 取证分析 / 加固修复六个执行角色,默认 3 个并发(可配置)。
|
|
99
|
+
- **开工前预检**:`blue_preflight` 检查本机工具链和 key,缺什么、能降级到什么方案,一次说清;不假装工具可用。
|
|
100
|
+
- **风险闸**:高风险动作(隔离、封禁、删除、改防火墙、杀进程、重置凭据)进入 `pending_approval`,必须人工批准后才能派发;不会自动执行。
|
|
101
|
+
- **自主派发**:`blue_autopilot` 生成候选任务、按并发名额领取、派给对应角色;子智能体回报后查库核对,再回收闭环。带轮次上限和冷却。
|
|
102
|
+
- **右侧常驻控制台**:态势 / 告警 / 资产 / 发现 / 任务 / IOC / 诱饵 / 时间线 / 报告 九个页签,支持拖拽调宽和全屏浏览。
|
|
103
|
+
- **面板跟着会话走**:多会话并行时,左侧切到哪个会话,右侧就显示该会话绑定的防守目标;没绑定的会话回落到最近一个活跃目标。
|
|
104
|
+
- **任务书**:每个任务带目标、已知事实、约束、验收标准和期望输出,统一由 TaskSpec 渲染,避免“让子智能体自己猜”。
|
|
105
|
+
- **报告**:从事实库生成 Markdown,包含态势、关键资产、告警研判、脆弱性、IOC、任务与时间线;只允许写到 `$DSH_HOME/blue/reports/`。
|
|
106
|
+
- **欺骗防御(可选)**:金丝雀文件/URL、假管理入口、假凭据、低交互 tarpit;登记诱饵、记录命中、生成 `deception` 告警。诱饵默认自动过期(24–168 小时),但真实部署仍需人工下线。
|
|
107
|
+
- **蜜罐 / 焦油坑(可选)**:`blue_tarpit_plan` 生成 Endlessh、Nginx 假路径、有界慢响应和 fail2ban 7 天 jail 配置;`blue_honeypot_ingest` 把命中转成告警和待审批封禁任务。插件不直接调用 `iptables` / `nft` / `fail2ban-client`。
|
|
108
|
+
- **可选诱饵程序**:包内自带手动启动的 HTTP 诱饵,默认只监听 `127.0.0.1`,公开监听必须显式 `--allow-public`;提供 `generic/tomcat/thinkphp/wordpress` 静态主题;不执行命令、不抓指纹、不做无限响应。
|
|
109
|
+
- **自动化流量标注**:诱饵服务按来源 IP 维护 1 秒行为窗口,命中高频请求、路径扫描或工具 UA 时打上 `automation_burst` / `path_sweep` / `automation_tool` 标签;只做研判,不自动封禁。
|
|
110
|
+
- **执行摘要**:报告开头用事实库数字概括关键资产、未闭环高危告警、待审批任务和诱饵命中,方便直接发给人看。
|
|
111
|
+
- **数据只在本机**:全部落在 `$DSH_HOME/blue/`,无遥测、无上报、无云端同步。
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
## 控制台
|
|
116
|
+
|
|
117
|
+
右侧是一个独立面板,不是塞在文件 tab 里的表单。
|
|
118
|
+
|
|
119
|
+
| 页签 | 内容 | 可执行操作 |
|
|
120
|
+
| --- | --- | --- |
|
|
121
|
+
| 态势 | 资产/告警/发现/IOC/任务统计、关键告警、任务队列 | 规划任务、刷新、调整并发、生成报告 |
|
|
122
|
+
| 告警 | 级别、来源、状态、时间 | 确认、标误报、转处置任务 |
|
|
123
|
+
| 资产 | 关键级别、地址、端口、服务、状态 | 新增/更新资产 |
|
|
124
|
+
| 发现 | 严重级别、类型、状态 | 标记已修复、接受风险 |
|
|
125
|
+
| 任务 | 优先级、角色、状态、任务书 | 领取(生成 subagent 任务书)、完成、阻塞 |
|
|
126
|
+
| IOC | 类型、值、置信度、来源 | 新增 IOC |
|
|
127
|
+
| 诱饵 | 类型、目标、状态、到期时间、命中次数 | 查看(部署仍由人工执行) |
|
|
128
|
+
| 时间线 | 时间、主体、动作、对象、详情 | 查看 |
|
|
129
|
+
| 报告 | 从事实库生成的 Markdown | 生成/刷新 |
|
|
130
|
+
|
|
131
|
+
面板默认打开;拖拽左边界可调宽,点标题栏的全屏按钮进入全面浏览,`Esc` 退出。
|
|
132
|
+
|
|
133
|
+
Host 侧通过 `POST /blue/api` 提供同源 JSON 桥接,浏览器不直接碰数据库;会话与目标的绑定镜像到 `$DSH_HOME/blue/session-bindings.json`。
|
|
134
|
+
|
|
135
|
+
---
|
|
136
|
+
|
|
137
|
+
## 六个执行角色
|
|
138
|
+
|
|
139
|
+
| 角色 | 定位 |
|
|
140
|
+
| --- | --- |
|
|
141
|
+
| monitor | 盯告警与可用性,先止血再深挖 |
|
|
142
|
+
| intel | 把外部情报转成可检测的 IOC / 规则 |
|
|
143
|
+
| hunt | 主动狩猎,验证可疑行为 |
|
|
144
|
+
| ir | 应急处置,隔离、封禁、恢复 |
|
|
145
|
+
| forensics | 取证与时间线还原 |
|
|
146
|
+
| hardening | 加固基线与修复建议 |
|
|
147
|
+
|
|
148
|
+
主会话只做指挥。动手的任务带 `role` 和 `agent_preset`,由主会话通过 `subagent` 派发;worker 没有审批、派发、报告和目标绑定权限。
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
## 安全边界
|
|
153
|
+
|
|
154
|
+
- 主会话和执行角色都不挂 `bash` / `pwsh` / `fs` / `fs-search` / `jobs` / `web`。
|
|
155
|
+
- 文件读取只走 `blue_*`,并有路径闸:拒绝插件源码、`$DSH_HOME` 配置、`.env`、私钥/凭据文件。
|
|
156
|
+
- 日志、样本、网页、文件名、User-Agent、URL 参数、worker 回报按不可信数据处理。
|
|
157
|
+
- `blue_log_scan` / `blue_artifact_triage` 返回 `untrusted: true` 并检测注入/外传信号。
|
|
158
|
+
- 任务书用 `<untrusted_task_data>` 包裹,禁止外传源码、环境变量、凭据和完整日志。
|
|
159
|
+
- 高风险动作必须人工审批;插件不直接调用 root 防火墙。
|
|
160
|
+
- 诱饵日志不记录 Cookie / Authorization;body、query、UA、Referer 中的 password/token/secret/cookie/session 会替换为 `[REDACTED]`。
|
|
161
|
+
- 不做 WebRTC 真实 IP、Canvas、硬件指纹;不做全屏锁定、无限弹窗、心理恐吓、无限响应。
|
|
162
|
+
|
|
163
|
+
它不是 EDR、IPS、WAF、防火墙或备份系统,不承诺拦截或恢复攻击。真实服务器使用前请自行完成授权、备份、回滚演练和独立安全评估。
|
|
164
|
+
|
|
165
|
+
---
|
|
166
|
+
|
|
167
|
+
## 数据与隐私
|
|
168
|
+
|
|
169
|
+
事实库和报告默认保存在:
|
|
170
|
+
|
|
171
|
+
```text
|
|
172
|
+
$DSH_HOME/blue/
|
|
173
|
+
├── blue.db
|
|
174
|
+
├── session-bindings.json
|
|
175
|
+
├── reports/
|
|
176
|
+
└── decoy-events.jsonl
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
这些内容**不要提交到公开仓库**:
|
|
180
|
+
|
|
181
|
+
| 不入库 | 说明 |
|
|
182
|
+
| --- | --- |
|
|
183
|
+
| 真实目标 / 资产清单 | 单位名、域名、真实 IP、内网段 |
|
|
184
|
+
| 真实凭据 | 口令、密钥、哈希、Cookie、token |
|
|
185
|
+
| 客户日志 / 样本 | 含个人信息、业务数据或未脱敏流量的文件 |
|
|
186
|
+
| 演练战绩 | 打了几家、多少资产、多少告警、封了多少 IP |
|
|
187
|
+
| 诱饵 token | 真实部署的 canary/诱饵凭据 |
|
|
188
|
+
|
|
189
|
+
插件默认不主动上传任何数据;外部情报查询由用户显式调用,并自行承担配额与合规责任。
|
|
190
|
+
|
|
191
|
+
---
|
|
192
|
+
|
|
193
|
+
## 限制
|
|
194
|
+
|
|
195
|
+
- 不捆绑任何外部工具,只做检测和编排;nmap、tshark、yara、volatility、fail2ban 等需要自行准备。
|
|
196
|
+
- 不是 OS 沙箱;`blue_*` 仍能读取“允许范围内的证据文件”,不要把 DSH 跑在能看到无关生产密钥的账户下。
|
|
197
|
+
- Prompt 注入仍可能影响模型判断和低风险工具调用;真实对抗建议再加 Docker/VM、只读证据挂载、无出站网络。
|
|
198
|
+
- 自动派发只覆盖 low/medium 任务;high 任务必须人工批准,这是设计约束,不是 bug。
|
|
199
|
+
- 诱饵自动过期只改事实库状态,不会物理删除已部署的诱饵。
|
|
200
|
+
|
|
201
|
+
---
|
|
202
|
+
|
|
203
|
+
## 更新与支持
|
|
204
|
+
|
|
205
|
+
- 更新记录:[CHANGELOG](CHANGELOG.md)
|
|
206
|
+
- 版本发布:[GitHub Releases](https://github.com/FGCGDroid/blue/releases)
|
|
207
|
+
- 安全问题:[SECURITY](SECURITY.md)
|
|
208
|
+
- 问题反馈:[Issues](https://github.com/FGCGDroid/blue/issues)
|
|
209
|
+
- 开发说明:[docs/development.md](docs/development.md)
|
|
210
|
+
|
|
211
|
+
发版流程、测试命令和目录结构见开发说明。
|
|
212
|
+
|
|
213
|
+
---
|
|
214
|
+
|
|
215
|
+
## 合规
|
|
216
|
+
|
|
217
|
+
面向**授权范围内**的防守:CTF 靶场、攻防演练、企业自检、教学研究。
|
|
218
|
+
|
|
219
|
+
未获授权的扫描、探测、入侵或数据获取均属违法,与本项目作者无关。MIT,见 [LICENSE](LICENSE)。
|
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
# 开发说明
|
|
2
|
+
|
|
3
|
+
这个插件不是从零写一个安全平台,而是把 DSH 已有的插件、工具、预设、客户端 UI 和 SQLite 拼成一个蓝队工作台。
|
|
4
|
+
|
|
5
|
+
## 基于什么开发
|
|
6
|
+
|
|
7
|
+
### 1. DSH 的 Cordis 插件体系
|
|
8
|
+
|
|
9
|
+
插件按 DSH 的 bundle / preset 方式挂载:
|
|
10
|
+
|
|
11
|
+
- `package.json` 里的 `dsh.bundle.patch` 指向 `cordis.patch.yml`
|
|
12
|
+
- `presets/blue/agent.cordis.yml` 是主指挥官预设
|
|
13
|
+
- `presets/blue/worker.cordis.yml` 是执行角色预设
|
|
14
|
+
- `scripts/build.mjs` 根据模板生成各角色变体
|
|
15
|
+
|
|
16
|
+
所以它不是独立应用,而是 DSH 的一个模式。安装后从预设里选择「蓝队防御模式」即可。
|
|
17
|
+
|
|
18
|
+
### 2. Node.js 22.13+
|
|
19
|
+
|
|
20
|
+
后端是普通 ESM 模块,没有 TypeScript 编译步骤,也没有打包器。
|
|
21
|
+
|
|
22
|
+
开发时用的是 Node 24,`package.json` 里要求 `>=22.13`。
|
|
23
|
+
|
|
24
|
+
### 3. Node 内置 `node:sqlite`
|
|
25
|
+
|
|
26
|
+
数据层直接用 `node:sqlite` 的 `DatabaseSync`,没有 better-sqlite3,也没有 SQLite 服务。
|
|
27
|
+
|
|
28
|
+
数据库在:
|
|
29
|
+
|
|
30
|
+
```text
|
|
31
|
+
$DSH_HOME/blue/blue.db
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
启用了 WAL、外键、busy_timeout,并用 `PRAGMA table_info` 做旧库补列迁移。
|
|
35
|
+
|
|
36
|
+
### 4. DSH 的工具 API
|
|
37
|
+
|
|
38
|
+
工具通过 `ctx.tools.register(defineTool(...))` 注册,模型看到的是普通工具调用,实际执行在 Host 进程。
|
|
39
|
+
|
|
40
|
+
主入口是 `lib/tools.js`,目前 36 个工具,覆盖:
|
|
41
|
+
|
|
42
|
+
- 目标与预检
|
|
43
|
+
- 资产、告警、发现、IOC
|
|
44
|
+
- 任务、审批、autopilot
|
|
45
|
+
- 日志扫描、样本初筛
|
|
46
|
+
- 加固检查、处置剧本、报告
|
|
47
|
+
- 欺骗诱饵、蜜罐/焦油坑
|
|
48
|
+
|
|
49
|
+
### 5. DSH 的客户端 UI
|
|
50
|
+
|
|
51
|
+
控制台是 DSH 的客户端插件,不是独立网页。
|
|
52
|
+
|
|
53
|
+
`lib/client.js` 通过 DSH 的模块加载器拿到 React,用 `React.createElement` 写界面,挂在右侧栏/浮层上。
|
|
54
|
+
|
|
55
|
+
Host 侧 `lib/ui.js` 提供同源 `POST /blue/api`,浏览器不直接打开 SQLite。
|
|
56
|
+
|
|
57
|
+
### 6. DSH 的 preset / subagent 机制
|
|
58
|
+
|
|
59
|
+
六个角色:
|
|
60
|
+
|
|
61
|
+
```text
|
|
62
|
+
monitor / intel / hunt / ir / forensics / hardening
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
每个角色有独立工具白名单和任务书。主会话通过 `subagent` 派发,worker 完成后回报,主会话核对数据库再回收。
|
|
66
|
+
|
|
67
|
+
### 7. 可选的系统工具
|
|
68
|
+
|
|
69
|
+
插件不捆绑 nmap、tshark、yara、volatility、fail2ban 等外部工具,只做检测和编排。
|
|
70
|
+
|
|
71
|
+
`blue_preflight` 会检查本机有没有这些命令;没有就返回替代方案,不假装可用。
|
|
72
|
+
|
|
73
|
+
## 目录结构
|
|
74
|
+
|
|
75
|
+
```text
|
|
76
|
+
lib/index.js Host 入口,挂载工具、UI、服务和技能
|
|
77
|
+
lib/store.js SQLite 事实库
|
|
78
|
+
lib/tools.js 36 个 blue_* 工具
|
|
79
|
+
lib/hunter.js 1 秒行为窗口(只标注,不封禁)
|
|
80
|
+
lib/ui.js /blue/api 和控制台数据
|
|
81
|
+
lib/client.js DSH 客户端控制台
|
|
82
|
+
lib/playbooks.js 角色、技能、处置剧本
|
|
83
|
+
lib/taskspec.js 任务书渲染
|
|
84
|
+
lib/plan.js 任务候选与风险分级
|
|
85
|
+
presets/blue/ 主会话与 worker 预设
|
|
86
|
+
skills/ 随包蓝队技能
|
|
87
|
+
scripts/ 构建、测试、校验、可选诱饵服务
|
|
88
|
+
docs/ 截图和说明
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
## 数据流
|
|
92
|
+
|
|
93
|
+
```text
|
|
94
|
+
日志 / 告警 / 样本
|
|
95
|
+
→ blue_* 工具
|
|
96
|
+
→ SQLite 事实库
|
|
97
|
+
→ 控制台 / 报告 / 任务
|
|
98
|
+
→ subagent 执行
|
|
99
|
+
→ 结果回写事实库
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
关键点是:**结论必须落库**。子智能体说“处理完了”不算,任务、时间线、告警状态里要有记录。
|
|
103
|
+
|
|
104
|
+
## 安全模型
|
|
105
|
+
|
|
106
|
+
- 主会话和 worker 都不挂 bash / pwsh / fs / fs-search / web
|
|
107
|
+
- 文件读取只走 `blue_*`,并有路径闸
|
|
108
|
+
- 外部日志、样本、网页按不可信数据处理
|
|
109
|
+
- 高风险动作进入 `pending_approval`
|
|
110
|
+
- 诱饵默认只登记,不自动部署
|
|
111
|
+
- 诱饵程序默认只监听本机
|
|
112
|
+
- 不做 Cookie/Authorization 收集,不做 WebRTC/Canvas/硬件指纹
|
|
113
|
+
|
|
114
|
+
它不能替代 Docker/VM、EDR、WAF 或备份,只是蓝队侧的编排和记录工具。
|
|
115
|
+
|
|
116
|
+
## 行为标注不是自动封禁
|
|
117
|
+
|
|
118
|
+
`lib/hunter.js` 是一个 1 秒滑动窗口,只按来源 IP 统计请求数、不同路径数和工具 UA,给诱饵日志打 `automation_burst` / `path_sweep` / `automation_tool` 标签。
|
|
119
|
+
|
|
120
|
+
它不判断“这是不是 AI”,也不自动封禁。封禁仍然由 fail2ban 或人工审批后的任务执行。
|
|
121
|
+
|
|
122
|
+
同样,诱饵页面是静态主题模板,不在请求时调用大模型生成“带假漏洞的页面”。那样会引入不可控代码、延迟和提示词注入,不适合直接部署在真实资产上。
|
|
123
|
+
|
|
124
|
+
## 不基于什么
|
|
125
|
+
|
|
126
|
+
- 不是 EDR/IPS/WAF
|
|
127
|
+
- 不依赖云端 SaaS 或向量数据库
|
|
128
|
+
- 不依赖大模型训练框架
|
|
129
|
+
- 不把外部工具打包进插件
|
|
130
|
+
- 不做自动攻击或漏洞利用
|
|
131
|
+
|
|
132
|
+
## 怎么跑测试
|
|
133
|
+
|
|
134
|
+
```powershell
|
|
135
|
+
node scripts/test-tools.mjs
|
|
136
|
+
node scripts/test-ui.mjs
|
|
137
|
+
node scripts/test-hunter.mjs
|
|
138
|
+
node scripts/test-decoy-server.mjs
|
|
139
|
+
node scripts/build.mjs
|
|
140
|
+
node scripts/validate.mjs
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
测试用临时 SQLite 和假数据,不碰真实主机。
|
package/lib/hunter.js
ADDED
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 轻量行为窗口:只做“自动化流量”标注,不宣称识别 AI,也不自动封禁。
|
|
3
|
+
*
|
|
4
|
+
* 设计目标:
|
|
5
|
+
* - 不依赖外部数据库;
|
|
6
|
+
* - 每个来源 IP 一个 1 秒滑动窗口;
|
|
7
|
+
* - 只返回 tags / risk / 统计,由调用方决定怎么展示。
|
|
8
|
+
*/
|
|
9
|
+
const TOOL_UA = /(curl|wget|python-requests|python-urllib|go-http-client|nuclei|sqlmap|masscan|nikto|zgrab|httpx)/i
|
|
10
|
+
|
|
11
|
+
export class BehaviorWindow {
|
|
12
|
+
constructor(options = {}) {
|
|
13
|
+
this.windowMs = options.windowMs ?? 1000
|
|
14
|
+
this.burst = options.burst ?? 20
|
|
15
|
+
this.pathSweep = options.pathSweep ?? 10
|
|
16
|
+
this.maxClients = options.maxClients ?? 5000
|
|
17
|
+
this.clients = new Map()
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
/**
|
|
21
|
+
* @param {string} ip
|
|
22
|
+
* @param {string} path
|
|
23
|
+
* @param {string} userAgent
|
|
24
|
+
* @returns {{ tags: string[], risk: 'high'|'medium'|'none', count: number, distinctPaths: number, reason: string }}
|
|
25
|
+
*/
|
|
26
|
+
observe(ip, path, userAgent = '') {
|
|
27
|
+
const now = Date.now()
|
|
28
|
+
const key = String(ip || '')
|
|
29
|
+
let state = this.clients.get(key)
|
|
30
|
+
if (state === undefined) {
|
|
31
|
+
state = { events: [], paths: [], lastSeen: now }
|
|
32
|
+
this.clients.set(key, state)
|
|
33
|
+
}
|
|
34
|
+
state.lastSeen = now
|
|
35
|
+
|
|
36
|
+
state.events = state.events.filter((item) => now - item < this.windowMs)
|
|
37
|
+
state.paths = state.paths.filter((item) => now - item.t < this.windowMs)
|
|
38
|
+
state.events.push(now)
|
|
39
|
+
state.paths.push({ t: now, path: String(path || '') })
|
|
40
|
+
|
|
41
|
+
const count = state.events.length
|
|
42
|
+
const distinctPaths = new Set(state.paths.map((item) => item.path)).size
|
|
43
|
+
const tags = []
|
|
44
|
+
if (count > this.burst) tags.push('automation_burst')
|
|
45
|
+
if (distinctPaths > this.pathSweep) tags.push('path_sweep')
|
|
46
|
+
if (TOOL_UA.test(String(userAgent)) && count >= 5) tags.push('automation_tool')
|
|
47
|
+
|
|
48
|
+
if (this.clients.size > this.maxClients) this.prune(now)
|
|
49
|
+
|
|
50
|
+
const risk = tags.includes('automation_burst') ? 'high' : tags.length > 0 ? 'medium' : 'none'
|
|
51
|
+
return {
|
|
52
|
+
tags,
|
|
53
|
+
risk,
|
|
54
|
+
count,
|
|
55
|
+
distinctPaths,
|
|
56
|
+
reason: tags.length === 0
|
|
57
|
+
? ''
|
|
58
|
+
: `window=${this.windowMs}ms requests=${count} distinct_paths=${distinctPaths} ua_tool=${TOOL_UA.test(String(userAgent))}`,
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
prune(now = Date.now()) {
|
|
63
|
+
for (const [key, state] of this.clients) {
|
|
64
|
+
if (now - state.lastSeen > this.windowMs * 60) this.clients.delete(key)
|
|
65
|
+
}
|
|
66
|
+
while (this.clients.size > this.maxClients) {
|
|
67
|
+
const oldest = this.clients.keys().next().value
|
|
68
|
+
if (oldest === undefined) break
|
|
69
|
+
this.clients.delete(oldest)
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
reset() {
|
|
74
|
+
this.clients.clear()
|
|
75
|
+
}
|
|
76
|
+
}
|
package/lib/store.js
CHANGED
|
@@ -1005,6 +1005,13 @@ export class BlueStore {
|
|
|
1005
1005
|
lines.push(`- 诱饵 ${stats.decoys} 个(启用 ${stats.decoys_active},命中 ${stats.decoy_hits})`)
|
|
1006
1006
|
lines.push(`- 任务:排队 ${stats.tasks_queued} / 待审批 ${stats.tasks_pending_approval} / 进行 ${stats.tasks_active} / 完成 ${stats.tasks_done} / 阻塞 ${stats.tasks_blocked}`)
|
|
1007
1007
|
lines.push('')
|
|
1008
|
+
lines.push('## 执行摘要')
|
|
1009
|
+
lines.push('')
|
|
1010
|
+
lines.push(`- 关键/高危资产 ${stats.assets_critical} 个;未闭环高危告警 ${stats.alerts_critical} 条;未闭环高危发现 ${stats.findings_critical} 条`)
|
|
1011
|
+
lines.push(`- 待审批 ${stats.tasks_pending_approval} 个;进行中 ${stats.tasks_active} 个;已完成 ${stats.tasks_done} 个`)
|
|
1012
|
+
lines.push(`- 诱饵启用 ${stats.decoys_active} 个;诱饵命中 ${stats.decoy_hits} 次`)
|
|
1013
|
+
lines.push('- 以上数字来自事实库;未落库的事件不计入报告。')
|
|
1014
|
+
lines.push('')
|
|
1008
1015
|
lines.push('## 关键资产')
|
|
1009
1016
|
if (assets.length === 0) lines.push('_暂无资产记录_')
|
|
1010
1017
|
for (const asset of assets) {
|
package/package.json
CHANGED
|
@@ -1,9 +1,13 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-blue-team-mode",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.4.0",
|
|
4
4
|
"description": "CTF 网络攻防蓝队防御模式:资产盘点、告警研判、威胁狩猎、应急响应、取证分析与加固修复,内置 SQLite 事实库、独立右侧栏控制台与自主任务派发队列。",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "FGCGDroid",
|
|
7
|
+
"contributors": [
|
|
8
|
+
"FGCGDroid",
|
|
9
|
+
"大肥鱼"
|
|
10
|
+
],
|
|
7
11
|
"repository": {
|
|
8
12
|
"type": "git",
|
|
9
13
|
"url": "git+https://github.com/FGCGDroid/blue.git"
|
|
@@ -44,8 +48,9 @@
|
|
|
44
48
|
"check": "node scripts/check-compliance.mjs --selftest",
|
|
45
49
|
"hooks": "node scripts/install-hooks.mjs",
|
|
46
50
|
"test:decoy": "node scripts/test-decoy-server.mjs",
|
|
51
|
+
"test:hunter": "node scripts/test-hunter.mjs",
|
|
47
52
|
"test:e2e": "node scripts/test-ui-e2e.mjs",
|
|
48
|
-
"test": "node scripts/test-tools.mjs && node scripts/test-ui.mjs && node scripts/test-decoy-server.mjs",
|
|
53
|
+
"test": "node scripts/test-tools.mjs && node scripts/test-ui.mjs && node scripts/test-hunter.mjs && node scripts/test-decoy-server.mjs",
|
|
49
54
|
"prepack": "node scripts/build.mjs"
|
|
50
55
|
},
|
|
51
56
|
"bin": {
|
package/scripts/decoy-server.mjs
CHANGED
|
@@ -11,6 +11,7 @@ import { appendFileSync, mkdirSync } from 'node:fs'
|
|
|
11
11
|
import { homedir } from 'node:os'
|
|
12
12
|
import { dirname, join } from 'node:path'
|
|
13
13
|
import { randomUUID } from 'node:crypto'
|
|
14
|
+
import { BehaviorWindow } from '../lib/hunter.js'
|
|
14
15
|
|
|
15
16
|
const VERSION = '1.0.0'
|
|
16
17
|
const MAX_BODY = 64 * 1024
|
|
@@ -24,6 +25,7 @@ function parseArgs(argv) {
|
|
|
24
25
|
log: join(process.env.DSH_HOME || join(homedir(), '.dsh'), 'blue', 'decoy-events.jsonl'),
|
|
25
26
|
allowPublic: false,
|
|
26
27
|
name: 'decoy-http',
|
|
28
|
+
theme: 'generic',
|
|
27
29
|
help: false,
|
|
28
30
|
}
|
|
29
31
|
for (let i = 0; i < argv.length; i += 1) {
|
|
@@ -34,6 +36,7 @@ function parseArgs(argv) {
|
|
|
34
36
|
else if (arg === '--port') options.port = Number(argv[++i] || options.port)
|
|
35
37
|
else if (arg === '--log') options.log = String(argv[++i] || options.log)
|
|
36
38
|
else if (arg === '--name') options.name = String(argv[++i] || options.name)
|
|
39
|
+
else if (arg === '--theme') options.theme = String(argv[++i] || options.theme)
|
|
37
40
|
else if (arg === '--version' || arg === '-v') {
|
|
38
41
|
console.log(VERSION)
|
|
39
42
|
process.exit(0)
|
|
@@ -59,9 +62,16 @@ function text(res, status, body, type = 'text/plain; charset=utf-8') {
|
|
|
59
62
|
res.end(data)
|
|
60
63
|
}
|
|
61
64
|
|
|
62
|
-
function fakeAdmin() {
|
|
63
|
-
|
|
64
|
-
|
|
65
|
+
function fakeAdmin(theme = 'generic') {
|
|
66
|
+
const titles = {
|
|
67
|
+
tomcat: 'Tomcat Manager',
|
|
68
|
+
thinkphp: 'ThinkPHP',
|
|
69
|
+
wordpress: 'WordPress',
|
|
70
|
+
generic: 'Internal Admin',
|
|
71
|
+
}
|
|
72
|
+
const title = titles[theme] || titles.generic
|
|
73
|
+
return `<!doctype html><html><head><title>${title}</title></head><body>`
|
|
74
|
+
+ `<h1>${title}</h1><form method="post" action="/admin/login">`
|
|
65
75
|
+ '<input name="username" placeholder="username"><input name="password" type="password" placeholder="password">'
|
|
66
76
|
+ '<button>Sign in</button></form><p>Build 2026.11</p></body></html>'
|
|
67
77
|
}
|
|
@@ -97,10 +107,13 @@ function redactBody(value) {
|
|
|
97
107
|
.replace(/((?:password|passwd|pwd|token|secret|authorization|cookie|session)[^=:&\s"']*\s*["']?\s*[:=]\s*["']?)([^&\s"']+)/gi, '$1[REDACTED]')
|
|
98
108
|
}
|
|
99
109
|
|
|
110
|
+
const hunter = new BehaviorWindow()
|
|
100
111
|
const server = createServer((req, res) => {
|
|
101
112
|
const started = Date.now()
|
|
102
113
|
const remote = req.socket.remoteAddress || ''
|
|
103
114
|
const now = Date.now()
|
|
115
|
+
const url = new URL(req.url || '/', 'http://decoy.invalid')
|
|
116
|
+
const behavior = hunter.observe(remote, url.pathname, String(req.headers['user-agent'] || ''))
|
|
104
117
|
if (rate.size > 5000) {
|
|
105
118
|
for (const [key, value] of rate) {
|
|
106
119
|
if (now - value.start > RATE_WINDOW_MS) rate.delete(key)
|
|
@@ -113,12 +126,11 @@ const server = createServer((req, res) => {
|
|
|
113
126
|
bucket.count += 1
|
|
114
127
|
if (bucket.count > RATE_LIMIT) {
|
|
115
128
|
text(res, 429, 'Too Many Requests')
|
|
116
|
-
record(req, remote, 429, '', started)
|
|
129
|
+
record(req, remote, 429, '', started, url, behavior)
|
|
117
130
|
return
|
|
118
131
|
}
|
|
119
132
|
}
|
|
120
133
|
|
|
121
|
-
const url = new URL(req.url || '/', 'http://decoy.invalid')
|
|
122
134
|
let body = ''
|
|
123
135
|
let tooLarge = false
|
|
124
136
|
req.on('data', (chunk) => {
|
|
@@ -132,12 +144,12 @@ const server = createServer((req, res) => {
|
|
|
132
144
|
req.on('end', () => {
|
|
133
145
|
if (tooLarge) {
|
|
134
146
|
text(res, 413, 'Payload Too Large')
|
|
135
|
-
record(req, remote, 413, body, started)
|
|
147
|
+
record(req, remote, 413, body, started, url, behavior)
|
|
136
148
|
return
|
|
137
149
|
}
|
|
138
150
|
const path = url.pathname
|
|
139
151
|
if (req.method === 'GET' && (path === '/admin' || path === '/admin/' || path === '/wp-login.php')) {
|
|
140
|
-
text(res, 200, fakeAdmin(), 'text/html; charset=utf-8')
|
|
152
|
+
text(res, 200, fakeAdmin(options.theme), 'text/html; charset=utf-8')
|
|
141
153
|
} else if (req.method === 'GET' && path === '/.git/config') {
|
|
142
154
|
text(res, 200, fakeGitConfig())
|
|
143
155
|
} else if (req.method === 'GET' && (path === '/phpmyadmin' || path === '/phpmyadmin/')) {
|
|
@@ -152,16 +164,17 @@ const server = createServer((req, res) => {
|
|
|
152
164
|
} else {
|
|
153
165
|
text(res, 404, notFound(), 'text/html; charset=utf-8')
|
|
154
166
|
}
|
|
155
|
-
record(req, remote, res.statusCode, body, started, url)
|
|
167
|
+
record(req, remote, res.statusCode, body, started, url, behavior)
|
|
156
168
|
})
|
|
157
169
|
})
|
|
158
170
|
|
|
159
171
|
const rate = new Map()
|
|
160
172
|
|
|
161
|
-
function record(req, remote, status, body, started, url = new URL(req.url || '/', 'http://decoy.invalid')) {
|
|
173
|
+
function record(req, remote, status, body, started, url = new URL(req.url || '/', 'http://decoy.invalid'), behavior = { tags: [], risk: 'none', count: 0, distinctPaths: 0, reason: '' }) {
|
|
162
174
|
const event = {
|
|
163
175
|
at: new Date().toISOString(),
|
|
164
176
|
decoy: options.name,
|
|
177
|
+
theme: options.theme,
|
|
165
178
|
remote,
|
|
166
179
|
method: req.method,
|
|
167
180
|
path: url.pathname,
|
|
@@ -171,6 +184,11 @@ function record(req, remote, status, body, started, url = new URL(req.url || '/'
|
|
|
171
184
|
body: redactBody(body),
|
|
172
185
|
status,
|
|
173
186
|
elapsed_ms: Date.now() - started,
|
|
187
|
+
tags: behavior.tags,
|
|
188
|
+
risk: behavior.risk,
|
|
189
|
+
behavior_reason: behavior.reason,
|
|
190
|
+
window_count: behavior.count,
|
|
191
|
+
distinct_paths: behavior.distinctPaths,
|
|
174
192
|
}
|
|
175
193
|
try {
|
|
176
194
|
mkdirSync(dirname(options.log), { recursive: true })
|
|
@@ -195,6 +213,7 @@ if (options.help) {
|
|
|
195
213
|
--port <port> 监听端口,默认 8080
|
|
196
214
|
--log <path> JSONL 日志路径,默认 $DSH_HOME/blue/decoy-events.jsonl
|
|
197
215
|
--name <name> 诱饵名称
|
|
216
|
+
--theme <theme> generic/tomcat/thinkphp/wordpress
|
|
198
217
|
--allow-public 允许非 loopback 监听(公开暴露前先评估)
|
|
199
218
|
--help 显示帮助`)
|
|
200
219
|
process.exit(0)
|
|
@@ -37,11 +37,11 @@ function waitForUrl(child) {
|
|
|
37
37
|
|
|
38
38
|
let child
|
|
39
39
|
try {
|
|
40
|
-
child = start(['--port', '0', '--log', log, '--name', 'test-decoy'])
|
|
40
|
+
child = start(['--port', '0', '--log', log, '--name', 'test-decoy', '--theme', 'tomcat'])
|
|
41
41
|
const base = await waitForUrl(child)
|
|
42
42
|
const admin = await fetch(base + '/admin')
|
|
43
43
|
const adminText = await admin.text()
|
|
44
|
-
if (admin.status !== 200 || !adminText.includes('
|
|
44
|
+
if (admin.status !== 200 || !adminText.includes('Tomcat Manager')) throw new Error('假管理页失败')
|
|
45
45
|
|
|
46
46
|
const git = await fetch(base + '/.git/config')
|
|
47
47
|
const gitText = await git.text()
|
|
@@ -70,6 +70,8 @@ try {
|
|
|
70
70
|
const missing = await fetch(base + '/random-path')
|
|
71
71
|
if (missing.status !== 404) throw new Error('未知路径应 404')
|
|
72
72
|
|
|
73
|
+
for (let i = 0; i < 25; i += 1) await fetch(base + `/p/${i}`)
|
|
74
|
+
|
|
73
75
|
await sleep(100)
|
|
74
76
|
const logText = readFileSync(log, 'utf8')
|
|
75
77
|
for (const secret of ['SuperSecret123', 'abc123', 'JsonSecret456', 'jsonToken789', 'QuerySecret321']) {
|
|
@@ -78,7 +80,9 @@ try {
|
|
|
78
80
|
if (!logText.includes('[REDACTED]')) throw new Error('日志未标记脱敏')
|
|
79
81
|
const lines = logText.trim().split(/\r?\n/).filter(Boolean)
|
|
80
82
|
if (lines.length < 4) throw new Error('事件日志不足:' + lines.length)
|
|
81
|
-
const
|
|
83
|
+
const events = lines.map((line) => JSON.parse(line))
|
|
84
|
+
if (!events.some((event) => (event.tags || []).includes('automation_burst'))) throw new Error('未记录自动化突发标签')
|
|
85
|
+
const event = events[0]
|
|
82
86
|
if (event.decoy !== 'test-decoy' || !event.remote || !event.path) throw new Error('事件字段不完整')
|
|
83
87
|
|
|
84
88
|
child.kill('SIGTERM')
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { BehaviorWindow } from '../lib/hunter.js'
|
|
2
|
+
|
|
3
|
+
const burst = new BehaviorWindow({ burst: 20, pathSweep: 10 })
|
|
4
|
+
let last
|
|
5
|
+
for (let i = 0; i < 25; i += 1) last = burst.observe('10.0.0.9', `/p/${i}`, 'Mozilla/5.0')
|
|
6
|
+
if (last.risk !== 'high' || !last.tags.includes('automation_burst') || !last.tags.includes('path_sweep')) {
|
|
7
|
+
throw new Error('并发/路径扫描未识别:' + JSON.stringify(last))
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
const tool = new BehaviorWindow({ burst: 20, pathSweep: 10 })
|
|
11
|
+
let toolLast
|
|
12
|
+
for (let i = 0; i < 6; i += 1) toolLast = tool.observe('10.0.0.10', '/admin', 'curl/8.0')
|
|
13
|
+
if (toolLast.risk !== 'medium' || !toolLast.tags.includes('automation_tool')) {
|
|
14
|
+
throw new Error('工具指纹未识别:' + JSON.stringify(toolLast))
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
const normal = new BehaviorWindow({ burst: 20, pathSweep: 10 })
|
|
18
|
+
const normalLast = normal.observe('10.0.0.11', '/', 'Mozilla/5.0')
|
|
19
|
+
if (normalLast.risk !== 'none' || normalLast.tags.length !== 0) throw new Error('正常请求被误报')
|
|
20
|
+
|
|
21
|
+
console.log('✓ 行为窗口测试通过:并发/路径扫描/工具指纹/正常请求')
|
package/skills/decoy-server.md
CHANGED
|
@@ -10,9 +10,11 @@ description: 可选的本地/授权资产 HTTP 诱饵程序:静态假管理页
|
|
|
10
10
|
在插件目录:
|
|
11
11
|
|
|
12
12
|
```bash
|
|
13
|
-
node scripts/decoy-server.mjs --host 127.0.0.1 --port 8080
|
|
13
|
+
node scripts/decoy-server.mjs --host 127.0.0.1 --port 8080 --theme tomcat
|
|
14
14
|
```
|
|
15
15
|
|
|
16
|
+
主题:`generic`、`tomcat`、`thinkphp`、`wordpress`,都是静态模板,不调用大模型生成。
|
|
17
|
+
|
|
16
18
|
安装为 npm 包后:
|
|
17
19
|
|
|
18
20
|
```bash
|
|
@@ -50,7 +52,15 @@ node scripts/decoy-server.mjs --host 0.0.0.0 --port 8080 --allow-public
|
|
|
50
52
|
$DSH_HOME/blue/decoy-events.jsonl
|
|
51
53
|
```
|
|
52
54
|
|
|
53
|
-
每条 JSON 包含时间、来源、方法、路径、UA、脱敏 body
|
|
55
|
+
每条 JSON 包含时间、来源、方法、路径、UA、脱敏 body、状态码、耗时,以及 `tags` / `risk`:
|
|
56
|
+
|
|
57
|
+
```text
|
|
58
|
+
automation_burst 1 秒内请求过多
|
|
59
|
+
path_sweep 1 秒内路径过多
|
|
60
|
+
automation_tool curl/python/nuclei 等工具 UA + 多次请求
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
这些标签只用于研判,不自动封禁。不会记录 Cookie/Authorization;body 中的 password/token/secret/cookie 等字段会替换为 `[REDACTED]`,不抓 WebRTC/Canvas/硬件指纹。
|
|
54
64
|
|
|
55
65
|
把事件交给 Agent:
|
|
56
66
|
|