qing
a7a78d1424
- Move all per-module security audit reports to docs/security/ - Move code review logs to docs/reviews/, analysis reports to docs/reports/ - Add docs/INDEX.md as single entry point for all project documentation - Add documentation management conventions section to README.md - Clean up empty per-module docs/ directories
69 lines
2.2 KiB
Markdown
69 lines
2.2 KiB
Markdown
# C++ 共享库安全审计报告
|
||
|
||
**审计日期**: 2026-08-01
|
||
**审计范围**: `libth/`（线程库）、`libhttp/`（HTTP/WebSocket）、`libcrypt/`（加密）、`libsqlite3/`（SQLite封装）
|
||
**代码版本**: dev_qing 分支
|
||
|
||
---
|
||
|
||
## 修复进度
|
||
|
||
| 优先级 | 总数 | 已修复 | 待修复 |
|
||
|--------|------|--------|--------|
|
||
| P0 | 1 | 0 | 1 |
|
||
| P1 | 2 | 0 | 2 |
|
||
| P2 | 2 | 0 | 2 |
|
||
|
||
---
|
||
|
||
## 🔴 P0 — 严重问题
|
||
|
||
### P0-1: libhttp HTTP 解析器需 fuzz 测试，潜在缓冲区溢出
|
||
- **位置**: `libhttp/src/HttpServer.cpp`
|
||
- **问题**: 自研 C++ HTTP 解析器未经过大规模 fuzz 测试：
|
||
- 异常 HTTP 方法、超长 header、畸形 chunked 编码可能触发缓冲区溢出
|
||
- 边界条件处理不当可导致拒绝服务或远程代码执行
|
||
- **修复建议**:
|
||
1. 使用 AFL++ 或 libFuzzer 对 HTTP 解析器进行 fuzz 测试
|
||
2. 重点测试：header 解析、URL 解析、chunked 编码、Content-Length 处理
|
||
3. 考虑替换为成熟库（如 llhttp、picohttpparser）
|
||
|
||
---
|
||
|
||
## 🟠 P1 — 高危问题
|
||
|
||
| # | 问题 | 位置 | 说明 |
|
||
|---|------|------|------|
|
||
| P1-1 | libcrypt RSA 实现需审计 | `libcrypt/src/Crypto_Basic.cpp`、`inc/us/MyRSA.hpp` | 自研 RSA 实现需验证侧信道攻击防护、填充方案（PKCS#1 v1.5/OAEP）正确性 |
|
||
| P1-2 | WebSocket 帧解析需 fuzz | `libhttp/src/WebSocketServer.cpp` | 畸形帧、超大帧、分片帧处理需验证 |
|
||
|
||
---
|
||
|
||
## 🟡 P2 — 中危问题
|
||
|
||
| # | 问题 |
|
||
|---|------|
|
||
| P2-1 | libsqlite3 封装需验证 SQL 注入防护（确认使用参数化查询） |
|
||
| P2-2 | libth 线程库同步原语需验证死锁/竞态条件 |
|
||
|
||
---
|
||
|
||
## ✅ 已有安全机制
|
||
|
||
1. ✅ **RAII 智能指针**: 减少内存泄漏和 use-after-free
|
||
2. ✅ **C++ 类型安全**: 相比纯 C 减少类型混淆漏洞
|
||
3. ✅ **项目内统一库**: 代码可控，可快速修复
|
||
4. ✅ **libcrypt 已实现**: PBKDF2、SHA256、AES-CBC、RSA、Base64
|
||
|
||
---
|
||
|
||
## 修复路线图
|
||
|
||
### 短期（72小时）
|
||
- [ ] 对 libhttp HTTP/WebSocket 解析器进行 fuzz 测试
|
||
- [ ] 验证 libsqlite3 封装的参数化查询正确使用
|
||
|
||
### 中期
|
||
- [ ] libcrypt RSA 实现安全审计
|
||
- [ ] 考虑替换 HTTP 解析器为成熟第三方库
|