docs: 研究整理——同步认证迁至 ca 后的过时描述、补 liblogc 与测试清单

- ARCHITECTURE/MODULES:ca 版本 v1.1.0、共享基础库补 liblogc、tests 描述与实际 9 个文件对齐、docs 篇数 57
- core README/报告/HttpTask 注释:管理员鉴权由"gateway 唯一权威"更正为 ca(v0.9.0 认证迁址后描述滞后)
- ca/gateway README 架构图 static:9200 → fsys:9200、db:8005 → db2:8005
- 主 README 与 blackbox README 补 test_core_confs.py,test_gateway 文档更新为 ca:8443 契约
This commit is contained in:
qing committed 2026-08-10 15:55:43 +00:00
1 parent 7467e7bd42
commit da8ebbf9e6
10 files changed
+27 -23

No files matched your search

+3 -2
View File
@@ -17,14 +17,15 @@ tests/blackbox/
├── config.py # 服务地址与端口映射
├── helpers.py # HTTP/TCP 请求封装 + 断言工具 + 计数器
├── test_runner.py # 统一入口,--url 自动识别目标服务
├── test_gateway.py # 输入校验/Token契约/代理路径安全/限流/CORS(v0.8.0 契约,认证链路待测试钩子)
├── test_gateway.py # 输入校验/Token契约/代理路径安全/限流/CORS(目标 ca:8443,认证 happy path 待测试钩子)
├── test_captcha.py # 获取验证码 → 校验 → 一次性消费
├── test_smtp.py # 发送邮箱验证码 → 校验
├── test_dnfs.py # 创建笔记 → 查询 → 更新 → 删除(含内容审核)
├── test_db.py # 日志写入 → 查询 → 统计 → 清理
├── test_ai_review.py # 内容审核 → 人工反馈纠正
├── test_static.py # 首页加载 → 文件浏览 → 视频流 → 路径遍历防护
└── test_waf.py # 正常请求通行 → SQLi/XSS/命令注入/路径遍历/扫描器拦截
├── test_waf.py # 正常请求通行 → SQLi/XSS/命令注入/路径遍历/扫描器拦截
└── test_core_confs.py # core 内嵌 confs(与 Python confs 基线行为对比)
```
## 覆盖的用户旅程
+4 -4
View File
@@ -1,5 +1,5 @@
"""
gateway 黑盒用户模拟测试(v2 — 对齐 gateway v0.8.0 契约)
认证/网关黑盒用户模拟测试(v2 — 目标 ca:8443,原 gateway 认证契约随 v0.9.0 迁至 ca)
覆盖范围(P0,无需测试钩子):
A. 输入校验与错误语义(v0.8.0 新契约:/login 强制 CAPTCHA、/register 强制 email_code)
@@ -9,7 +9,7 @@ gateway 黑盒用户模拟测试(v2 — 对齐 gateway v0.8.0 契约)
E. 速率限制(随机 XFF 隔离限流桶,避免用例互斥)
F. CORS 预检现状固化 + 错误响应脱敏回归(P0-2/P0-3)
已知待修复缺陷(断言目标行为,gateway 修复前会 FAIL):
已知待修复缺陷(断言目标行为,ca 修复前会 FAIL):
- A3: 缺失 JSON 字段 → 当前 500,应为 400(场景 A5/A8)
- A2: 白名单外 Target-Url → 当前 500,应为 403(需有效 Token 才能触达,待测试钩子)
@@ -17,9 +17,9 @@ gateway 黑盒用户模拟测试(v2 — 对齐 gateway v0.8.0 契约)
captcha2/smtp 测试模式(固定验证码答案钩子),落地前黑盒无法覆盖(P1 清单)。
依赖说明:
- gateway 必须运行,否则全部 SKIP
- ca (:8443) 必须运行,否则全部 SKIP
- captcha2 (pymsg:8009) 不在线时 C/E5 段 SKIP(其余用例不受影响)
- static (:9200) 不在线时 D3 段 SKIP
- fsys (:9200) 不在线时 D3 段 SKIP
- smtp 不在线不影响本文件(相关用例均为 fail-closed 400 路径)
"""