1 parent
18b6dfbdf7
commit
dd04bdb49e
83 files changed
+4547
-583
No files matched your search
@@ -186,7 +186,7 @@
|
||||
|
||||
### AD-005 建立需求追踪和测试矩阵
|
||||
|
||||
- **状态**:未开始
|
||||
- **状态**:`[x] 已完成,等待复审`
|
||||
- **优先级**:P0
|
||||
- **依赖**:AD-001、AD-002、AD-003
|
||||
- **需求映射**:第 21、22、24 章
|
||||
@@ -196,7 +196,7 @@
|
||||
- **测试要求**:检查每条验收项和 17 条阻塞条件至少映射一个测试或人工审计步骤。
|
||||
- **验收标准**:测试矩阵完整、可追踪、无孤立需求和无来源测试。
|
||||
- **回退方式**:缺少覆盖的能力保持关闭。
|
||||
- **验收证据**:待补充。
|
||||
- **验收证据**:已新增 `docs/超级管理员重置与邮箱验证码测试矩阵.md`,把 AD-001~AD-066 映射到单元、并发、协议、数据库、浏览器、安装升级和跨平台检查;明确 SQLite 自动化结果以及 MySQL、PostgreSQL、Ubuntu 22.04/24.04、Windows 生产服务、真实 SMTP 和真实浏览器的未验证边界。关键负向场景覆盖 nonce 重放、密码参数、验证码降级、并发双花、超级管理员 Web 恢复和敏感数据泄露;发布前仍需补齐真实环境证据。
|
||||
|
||||
### 第一阶段验收
|
||||
|
||||
|
||||
@@ -0,0 +1,77 @@
|
||||
# 超级管理员重置与邮箱验证码测试矩阵
|
||||
|
||||
> 文档编号:AD-005
|
||||
>
|
||||
> 编写日期:2026-08-27
|
||||
>
|
||||
> 适用范围:`smail-admin` 本机超级管理员重置、普通用户和管理员密码恢复、登录二次验证、外部安全邮箱验证码、离线恢复码、WebAuthn、审计和限流。
|
||||
>
|
||||
> 本矩阵区分“本机自动化通过”和“真实环境待验证”。没有真实 Ubuntu、Windows 服务、SMTP Relay、MySQL 或 PostgreSQL 证据时,不把对应项目标记为最终验收通过。
|
||||
|
||||
## 1. 状态定义
|
||||
|
||||
| 标记 | 含义 |
|
||||
|---|---|
|
||||
| 自动化通过 | 当前 Windows 开发环境可以重复执行并通过 |
|
||||
| 待真实环境 | 需要真实平台、服务、网络或外部依赖,不能用单元测试替代 |
|
||||
| 阻塞 | 关键安全边界尚未得到完整证据,发布前必须关闭 |
|
||||
|
||||
## 2. 需求到测试映射
|
||||
|
||||
| 需求范围 | 测试或审计入口 | 当前结果 | 仍需补充 |
|
||||
|---|---|---|---|
|
||||
| AD-001~AD-004 | `server/cmd/smail-admin/main_test.go`、`services/adminreset/*_test.go`、安全威胁模型 | 自动化通过 | Ubuntu、Windows 交互实机审计 |
|
||||
| AD-005 | 本文件、配置系统测试基线、CI 安全工作流 | 自动化通过 | 将本矩阵接入发布检查 |
|
||||
| AD-006~AD-008 | 管理程序命令、危险参数、受信进程和密码代理测试 | 自动化通过 | 真实 systemd 和 Windows 令牌 |
|
||||
| AD-009、AD-010 | `deploy/systemd/*`、安装脚本和平台适配测试 | 部分通过 | Ubuntu 22.04/24.04、Windows Service 和 ACL |
|
||||
| AD-011、AD-015 | 版本、原子升级、配置权限和文件权限测试 | 部分通过 | 两个 Ubuntu 版本和 Windows 安装升级 |
|
||||
| AD-012~AD-021 | `services/adminreset` 协议、Unix Socket、Named Pipe 和重置事务测试 | 自动化通过 | 跨平台实机 IPC 抢占、权限篡改和端口扫描 |
|
||||
| AD-022~AD-031 | `services/recovery`、`credentials`、`webauthn` 和安全凭据测试 | 自动化通过 | 真实浏览器 WebAuthn 和故障注入 |
|
||||
| AD-032~AD-038 | `services/verification`、外部邮箱和投递测试 | 自动化通过 | 真实 SMTP Relay、退信和证书校验 |
|
||||
| AD-039~AD-047 | 登录二次验证、恢复状态机、重发和失效测试 | 自动化通过 | 真实浏览器端到端和多实例 |
|
||||
| AD-048~AD-052 | Controller、CSRF、V1 API、Session 和统一认证测试 | 自动化通过 | 浏览器网络面板与生产代理行为 |
|
||||
| AD-053~AD-059 | 外部邮箱生命周期、管理权限和恢复码提示测试 | 部分通过 | 前端页面真实操作和首次登录场景 |
|
||||
| AD-060 | `go test ./... -race` 及安全回归 | 自动化通过 | 持续集成环境重复执行 |
|
||||
| AD-061 | 三数据库迁移和集成测试 | SQLite 自动化通过 | 配置 MySQL/PostgreSQL DSN 后真实执行 |
|
||||
| AD-062 | Unix Socket、systemd 安装和 Linux 安全测试 | 未验证 | Ubuntu 22.04 与 24.04 实机 |
|
||||
| AD-063 | Named Pipe、Windows Service、ACL 和令牌测试 | 部分通过 | Windows 提权/非提权/服务账户实机 |
|
||||
| AD-064 | 浏览器视口、恢复页面、登录二次验证和敏感信息检查 | 未完成 | 1440×900、低高度、移动视口和主流 Chromium |
|
||||
| AD-065~AD-066 | 负向测试、泄露扫描、发布评审 | 未完成 | 依赖 AD-061~AD-064 的真实环境证据 |
|
||||
|
||||
## 3. 必须覆盖的安全负向矩阵
|
||||
|
||||
| 场景 | 预期结果 | 自动化入口 |
|
||||
|---|---|---|
|
||||
| 普通用户调用超级管理员重置 | 拒绝,不建立网络重置路径 | `services/adminreset` 授权测试 |
|
||||
| HTTP 或 localhost TCP 触发超级管理员重置 | 不存在或拒绝 | HTTP 路由安全测试、部署审计 |
|
||||
| 重放已消费 nonce | 拒绝 | `protocol_test.go`、传输测试 |
|
||||
| 过期 nonce 或超时会话 | 拒绝 | SessionGuard 测试 |
|
||||
| `--password`、密码环境变量或密码文件 | 拒绝 | 管理程序参数和密码代理测试 |
|
||||
| 普通标准输入重定向 | 拒绝,不降级读取 | 密码代理平台测试 |
|
||||
| 外部邮箱验证码关闭 | 不显示或不允许降级恢复 | 恢复 Controller 测试 |
|
||||
| 错误验证码重复尝试 | 计数并限流 | verification service/store 测试 |
|
||||
| 并发消费同一验证码或恢复码 | 只允许一次成功 | 并发测试和数据库事务测试 |
|
||||
| 验证码跨账号、用途、资源或浏览器上下文复用 | 拒绝 | verification 绑定测试 |
|
||||
| 超级管理员通过普通 Web 忘记密码 | 拒绝并引导本机通道 | reset entry 测试 |
|
||||
| 重置后旧 Session、WebAuthn、恢复码和票据 | 全部失效 | credentials/recovery/webauthn 测试 |
|
||||
| 审计、日志、响应、备份和浏览器存储出现敏感值 | 不得出现 | 敏感字段和泄露扫描 |
|
||||
|
||||
## 4. 数据库和平台执行记录
|
||||
|
||||
| 环境 | 命令或检查 | 当前状态 |
|
||||
|---|---|---|
|
||||
| Windows 开发环境 | `cd server; go test ./... -count=1` | 通过 |
|
||||
| Windows 开发环境 | `cd server; go vet ./...` | 通过 |
|
||||
| Windows 开发环境 | `cd fe; yarn.cmd build` | 通过 |
|
||||
| SQLite | 迁移、事务、并发和恢复测试 | 通过 |
|
||||
| MySQL | `SMAIL_TEST_MYSQL_DSN` 集成测试 | 未配置,未验证 |
|
||||
| PostgreSQL | `SMAIL_TEST_POSTGRES_DSN` 集成测试 | 未配置,未验证 |
|
||||
| Ubuntu 22.04 | systemd、Unix Socket、安装升级和端口扫描 | 未验证 |
|
||||
| Ubuntu 24.04 | systemd、Unix Socket、安装升级和端口扫描 | 未验证 |
|
||||
| Windows 生产服务 | Named Pipe、ACL、令牌和 Service 生命周期 | 未验证 |
|
||||
| 真实 SMTP Relay | 投递、证书、失败降级和敏感信息检查 | 未验证 |
|
||||
| 真实浏览器 | 恢复、登录二次验证和移动视口 | 未完成 |
|
||||
|
||||
## 5. 发布判定
|
||||
|
||||
在 MySQL、PostgreSQL、Ubuntu 22.04、Ubuntu 24.04、Windows 生产服务、真实 SMTP 和真实浏览器证据补齐前,AD-065、AD-066 以及配置系统的最终验收不得标记为复审通过。自动化测试通过只说明当前代码在隔离测试环境下满足已覆盖的行为,不代表跨平台和生产边界已经闭合。
|
||||
+14
-10
@@ -196,7 +196,7 @@
|
||||
|
||||
### CG-006 实现严格 JSON 解析器
|
||||
|
||||
- **状态**:未开始
|
||||
- **状态**:`[x] 已完成,等待复审`
|
||||
- **优先级**:P0
|
||||
- **依赖**:CG-005
|
||||
- **设计映射**:第 8.2 章
|
||||
@@ -206,11 +206,11 @@
|
||||
- **测试要求**:覆盖嵌套重复键、大小写相近字段、超大数值、多个 JSON 值和畸形输入。
|
||||
- **验收标准**:全部恶意配置夹具被稳定拒绝,正常配置无兼容性回退。
|
||||
- **回退方式**:保留旧解析器但不在生产开关中启用新路径。
|
||||
- **验收证据**:待补充。
|
||||
- **验收证据**:`server/config/parser.go` 已实现配置大小限制、最大嵌套深度、Token 级重复键检测、`DisallowUnknownFields`、BOM 拒绝、无效 UTF-8 拒绝、尾随 JSON 内容拒绝、`UseNumber` 数值解析和精确字段形状校验;超大数值、大小写相近字段、嵌套未知字段、控制字符、畸形输入均使用固定错误,不回显 Secret 或绝对路径。`server/config/parser_test.go`、`server/config/parser_security_test.go` 覆盖重复键、嵌套重复键、未知字段、数值溢出、多个 JSON 值、深度和大小限制,以及错误信息脱敏;`go test ./config -count=1` 已通过。
|
||||
|
||||
### CG-007 实现配置验证器
|
||||
|
||||
- **状态**:未开始
|
||||
- **状态**:已完成,等待复审
|
||||
- **优先级**:P0
|
||||
- **依赖**:CG-005、CG-006
|
||||
- **设计映射**:第 8.3、8.4 章
|
||||
@@ -220,25 +220,25 @@
|
||||
- **测试要求**:端口冲突、路径逃逸、域名冲突、插件能力越权和状态机条件测试。
|
||||
- **验收标准**:无效候选配置不能进入磁盘事务或运行时快照。
|
||||
- **回退方式**:关闭新配置更新入口,不绕过验证器保存。
|
||||
- **验收证据**:待补充。
|
||||
- **验收证据**:`server/config/validator.go` 已实现日志级别、HTTP/HTTPS 端口、SMTP Relay 主机/端口/发件域/加密模式、邮箱端口和登录验证策略、SSL 受控相对路径及证书私钥成对引用、插件逻辑 ID/文件名/网络白名单/凭据格式校验;远程 SMTP 明文 Relay、路径逃逸、绝对路径、非法域名、重复插件网络目标和不安全插件网络目标均被拒绝。`server/config/runtime_validator.go` 已实现分区元数据、代次、域名唯一性、端口冲突、插件能力与网络目标、ready 状态和生产降级状态校验。`server/config/validator_security_test.go` 覆盖非法日志级别、HTTP/HTTPS 端口、ready 缺少 Web 域名、域名重复、SMTP 非法主机及远程明文、SSL 路径逃逸和证书私钥不成对、邮箱策略、插件重复/危险网络目标;`SnapshotStore` 和 `ConfigManager` 测试证明无效候选不会改变活动快照、活动代次、待重启状态或磁盘分区文件。已通过 `go test ./config ./controllers ./listen/http_server -count=1`、`go test ./... -count=1` 和 `go vet ./...`。本证据未覆盖真实数据库、真实 SMTP 投递、证书链/私钥匹配、插件进程沙箱和生产部署环境,相关验收保持开放。
|
||||
|
||||
### CG-008 实现统一 SecretChange 和 CredentialVault 适配
|
||||
|
||||
- **状态**:未开始
|
||||
- **状态**:`[✓] 复审通过`
|
||||
- **优先级**:P0
|
||||
- **依赖**:CG-002、CG-005
|
||||
- **设计映射**:第 3.3、10.3 章
|
||||
- **修改范围**:`server/config/secret.go`、`server/utils/credential`、相关 DTO 和测试
|
||||
- **实施步骤**:实现 `keep`、`replace`、`clear`;统一数据库、SMTP、微信、Telegram 等凭据的加密、解密、脱敏和版本字段。
|
||||
- **修改范围**:`server/config/secret.go`、`server/config/sections.go`、`server/config/manager_v2.go`、`server/config/runtime_validator.go`、`server/controllers/config.go`、`server/utils/credential` 和相关测试
|
||||
- **实施步骤**:实现 `keep`、`replace`、`clear`;统一数据库、SMTP、插件等凭据的加密、解密、脱敏和版本字段;插件 Secret 使用 `plugins.<逻辑ID>.secret` 变更路径,并在分区载荷中保留已有密文。
|
||||
- **安全要求**:不支持旧弱算法回退;密钥文件权限不合格时拒绝启动;Secret 不进入日志。
|
||||
- **测试要求**:密文篡改、错误密钥、版本不支持、三种更新语义和 JSON 脱敏测试。
|
||||
- **验收标准**:所有第三方配置使用同一输入和存储边界,查询接口不返回原文。
|
||||
- **回退方式**:不迁移已有凭据,只关闭 V2 写接口;不得回退成明文。
|
||||
- **验收证据**:待补充。
|
||||
- **验收证据**:`StoredSecret`、`SecretChange`、`SecretPolicy` 和 `CredentialVault` 已统一接入数据库密码、SMTP Relay 密码和插件 Secret;插件支持 `replace`、`keep`、`clear`,未知插件、非法路径、直接提交密文均被拒绝;插件 Secret 经过同一套版本与密文格式校验,公共配置响应仅返回 `secretStatus`,不返回明文、密文或 Secret 输入值。`server/config/secret_test.go` 覆盖三种语义、密文篡改、错误密钥、版本不支持和 JSON 脱敏;`server/config/manager_v2_test.go` 覆盖插件 Secret 全流程及非法请求;`server/controllers/config_public_response_test.go` 覆盖插件公共响应脱敏。测试结束清理仅匹配 `server/.codex-smail-*` 的临时文件。已通过 `go test ./... -count=1`、`go vet ./...`、`git diff --check`,并验证 `mingw32-make clean_codex_test_artifacts` 只清理目标临时文件。真实数据库、SMTP 投递、插件进程沙箱、Ubuntu/Windows 部署和生产环境仍未完成集成验收。
|
||||
|
||||
### CG-009 实现不可变运行时快照
|
||||
|
||||
- **状态**:未开始
|
||||
- **状态**:`[✓] 复审通过`
|
||||
- **优先级**:P0
|
||||
- **依赖**:CG-005、CG-007、CG-008
|
||||
- **设计映射**:第 9 章
|
||||
@@ -248,7 +248,7 @@
|
||||
- **测试要求**:并发读取、连续更新、竞态检测、深复制和旧快照生命周期测试。
|
||||
- **验收标准**:业务请求不再从磁盘读取配置,竞态测试无数据竞争。
|
||||
- **回退方式**:切回旧读取适配层,不删除新快照代码。
|
||||
- **验收证据**:待补充。
|
||||
- **验收证据**:`server/config/snapshot.go` 使用 `atomic.Pointer[RuntimeConfig]` 和 CAS 发布;发布前对根配置、分区 map、插件 map、插件权限切片、网络目标切片和 `json.RawMessage` 深复制;拒绝低于当前活动代次的候选快照;`server/config/runtime_access.go` 为旧 `config.Instance` 提供只读深拷贝适配;覆盖旧配置的切片和 map 字段;`server/config/snapshot_test.go` 覆盖无效候选拒绝、输入和读取结果深拷贝、并发读取与连续更新、旧快照生命周期、旧代次并发发布;`server/config/manager_v2_test.go` 覆盖 `Snapshot`、`UpdateResult.Candidate` 和 `ApplyResult.Snapshot` 返回值隔离;已通过 `go test ./config -count=1` 和 `go test -race ./config -count=1`;本证据未覆盖真实生产进程切换、Ubuntu/Windows 部署和真实运行时长期观测,相关验收保持开放。
|
||||
|
||||
### CG-010 实现 ConfigManager 核心接口
|
||||
|
||||
@@ -1140,6 +1140,10 @@ CG-053~CG-056 → AD-066 → CG-057
|
||||
|
||||
| 日期 | 任务 | 原状态 | 新状态 | 说明 |
|
||||
|---|---|---|---|---|
|
||||
| 2026-08-28 | CG-009 | 未开始 | 已完成,等待复审 | 使用 `atomic.Pointer` 和 CAS 发布不可变运行时快照;补齐深拷贝、旧代次拒绝、并发读取/发布和 ConfigManager 返回值隔离测试;配置包竞态测试通过;真实生产进程切换和跨平台部署仍待验收 |
|
||||
| 2026-08-28 | CG-009 | 已完成,等待复审 | 复审通过 | 独立复审确认 `atomic.Pointer` CAS 发布、深复制边界、旧代次冲突保护、返回值隔离和配置包竞态测试;`go test ./... -count=1`、`go vet ./...`、`git diff --check` 通过;仅本机自动化复审通过,真实生产进程切换、Ubuntu/Windows 部署及长期观测仍未覆盖 |
|
||||
| 2026-08-28 | CG-008 | 已完成,等待复审 | 复审通过 | 复核插件 Secret 的 keep 保留、replace 加密、clear 确认、非法路径和直接密文拒绝逻辑;配置、控制器全量测试和 `go vet` 均通过,临时文件定向清理验证通过;真实数据库、SMTP、插件沙箱、Ubuntu/Windows 和生产环境边界继续保留为未验收项 |
|
||||
| 2026-08-28 | CG-008 | 未开始 | 已完成,等待复审 | 完成统一 SecretChange 与 CredentialVault 适配;数据库、SMTP Relay 和插件 Secret 使用统一加密、版本、脱敏和更新语义;补齐插件 Secret 的 keep/replace/clear、非法路径与公共响应脱敏测试;Makefile 增加仅清理 `server/.codex-smail-*` 的测试收尾逻辑;真实数据库、SMTP、插件沙箱、Ubuntu/Windows 和生产环境仍待集成验收 |
|
||||
| 2026-08-27 | CG-005 | 未开始 | 已完成,等待复审 | 完成配置模型、三数据库条件字段、默认端口、SQLite `localRef` 约束和固定分区映射测试;自动化验证通过,真实数据库集成、跨平台部署和启动流程仍待验收 |
|
||||
| 2026-08-27 | CG-002 | 未开始 | 已完成,等待复审 | 完成敏感字段目录、持久化策略、管理 API 能力映射、配置 PUT 路由和授权负向测试;自动化检查通过,真实平台和生产观测仍待验收 |
|
||||
| 2026-08-27 | CG-003 | 未开始 | 已完成,等待复审 | 完成显式迁移框架、版本和校验和校验、三数据库方言定义、数据库锁、事务回滚和生产 `Sync2` 兼容边界;SQLite 自动化测试通过,MySQL/PostgreSQL 因未配置 DSN 未执行真实集成验收 |
|
||||
|
||||
Reference in new issue
Block a user