docs: aggregate project documentation under docs/ with unified index
- 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
This commit is contained in:
1 parent
9dbe395484
commit
a7a78d1424
22 files changed
+151
No files matched your search
@@ -1,50 +0,0 @@
|
||||
# BotOps 模块安全审计报告
|
||||
|
||||
**审计日期**: 2026-08-01
|
||||
**审计范围**: `app.py`、`ws_client.py`、`commands.py`、`widgets/`
|
||||
**代码版本**: dev_qing 分支
|
||||
|
||||
---
|
||||
|
||||
## 修复进度
|
||||
|
||||
| 优先级 | 总数 | 已修复 | 待修复 |
|
||||
|--------|------|--------|--------|
|
||||
| P0 | 1 | 0 | 1 |
|
||||
| P1 | 1 | 0 | 1 |
|
||||
|
||||
---
|
||||
|
||||
## 🔴 P0 — 严重问题
|
||||
|
||||
### P0-1: WebSocket 客户端连接无证书验证/无认证
|
||||
- **位置**: `ws_client.py`
|
||||
- **问题**: BotOps 作为运维管理客户端,连接后端 WebSocket 时:
|
||||
- 若连接 aibox/core 的 WebSocket 管理接口,需要确认 TLS 证书验证是否启用
|
||||
- Token/认证凭据存储方式需审计
|
||||
- **修复建议**:
|
||||
1. 启用 TLS 证书验证,不使用 `verify=False`
|
||||
2. 认证 Token 安全存储(系统钥匙串而非明文配置文件)
|
||||
|
||||
---
|
||||
|
||||
## 🟠 P1 — 高危问题
|
||||
|
||||
| # | 问题 | 说明 |
|
||||
|---|------|------|
|
||||
| P1-1 | 命令执行权限 | BotOps 作为运维工具,可执行系统命令,需确认是否限制了可执行命令范围 |
|
||||
|
||||
---
|
||||
|
||||
## ✅ 已有安全机制
|
||||
|
||||
1. ✅ **桌面客户端架构**: 本地运行应用,天然隔离
|
||||
2. ✅ **WebSocket 通信**: 与后端实时通信
|
||||
|
||||
---
|
||||
|
||||
## 修复路线图
|
||||
|
||||
### 短期
|
||||
- [ ] 审计 ws_client.py 的 TLS 配置
|
||||
- [ ] 确认命令执行白名单
|
||||
Reference in new issue
Block a user