Files
moyi-model-intelligence-hub/docs/25-auth-and-bounded-transport.md
T

45 lines
7.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 认证安全与有界 HTTP 增量
日期:2026-10-21。范围是补齐用户清单中的可独立验证安全底座,不代表完整 Codex 兼容或全部 CPR 能力已完成;总任务状态见 `24-security-and-cpr-task-tracker.md`。
## 认证边界
- `LoginAttemptLimiter` 在昂贵密码校验前,使用 PostgreSQL 共享固定窗口:同一规范化账号每 60 秒最多 10 次,同一来源每 60 秒最多 50 次,包括未知账号、成功与失败尝试。超过返回 429 / `AUTH_RATE_LIMITED` 和 `Retry-After`。
- `V49` 仅存 scope+身份摘要、计数和期限,不保存原始账号、IP 或密码。摘要是伪名化,不等于抵抗字典反推的匿名化。过期数据在后续尝试中分批清理;这是应用防爆破,不替代 WAF/网关整体流量防护。
- 限速计数独立事务提交,失败登录/外层回滚不能抹去次数;稳定的桶锁顺序防死锁。先完成限速再进入登录事务,不让所有请求各占一条连接后再争抢 REQUIRES_NEW 连接。
- 已知和未知账号均执行有界 PBKDF2 验证;未知账号使用非用户凭据的固定摘要形状,降低明显的是否存在计时差异,不承诺严格恒定响应时长。
- 登录、改密、密码重置通过用户行锁协调。先登录的会话会被随后改密撤销;先改密后,旧密码不能继续创建有效会话。MFA 失败计数、动态码重放标记和恢复码消费与会话签发保持事务语义。
- 改密撤销所有浏览器会话,包括当前会话;Controller 清理 Cookie,界面回到登录入口。仅改显示名称不撤销会话。API Key 不自动撤销,泄露时仍需单独停用或轮换。
- `PasswordPolicy` 统一注册、管理端创建、所有角色改密/重置以及新建初始管理员的新密码规则:8–256 个 UTF-16 code unit、不能仅为空白,不静默裁切/修剪。超级管理员不再豁免长度策略。8 位是兼容当前产品规则,不是声称达到所有部署的最佳口令强度;更强策略、泄露口令检测、强制 MFA 仍需按部署要求补齐。
- 兼容既有哈希和有界旧密码登录,不自动重置已有管理员。匹配端拒绝超大输入、异常盐/密钥尺寸和不合理迭代数,防止损坏哈希控制无界 KDF 工作。新建管理员必须显式配置密码,默认 `admin123` 及示例环境文件中的占位密码被拒绝;已有管理员启动不因缺少新的初始密码配置被重置。
注册/验证码整体流程、重置发送的账号枚举侧信道、管理敏感动作二次验证、会话管理面板等仍在剩余审查中;不能把本增量描述为“认证系统已无漏洞”。
## 有界 HTTP 模块
`provider.transport.BoundedHttpTransport` 只执行一次非流式 HTTP 传输,不选择账号/渠道、不读写钱包、不决定重试、也不携带业务风险策略:
1. 强制调用方提供总期限,期限覆盖响应头和整个响应体;超时或线程中断时取消 future 和 body subscription,恢复中断标志。
2. 使用限量 BodySubscriber,在继续累计之前检查 chunk 总量;声明 Content-Length 已超限时提前拒绝。错误体最多 64 KiB,不是“先读完整体再判断大小”。
3. 禁止自动跟随重定向;返回已观察 HTTP 状态及字节,诊断对象不输出 URL、头、密钥或原始响应体。
4. 异步 JSON、multipart、音频接入 8 MiB 上限;媒体输入也使用同一读取上限和 15 秒期限。媒体获取在生成发送前失败时不应被视为已发送生成请求。
5. `AsyncProviderClient` 继续负责协议和受理语义:已观察到明确拒绝状态时保留该事实;成功响应超限、读取超时或接收结果未知时仍按 UNKNOWN 处理,不自动重发、不自动退款。原有 404/405 视频路径兼容边界不放宽。
这还不是全项目统一 Transport:同步/SSE 的现有有界读取和整体 deadline 仍在原 Provider 生命周期内;长请求续租、逐 attempt 交付状态、统一取消与跨路由共享预算未完成。
**该提交时的媒体 SSRF 尚未闭环。** 本阶段约束了响应体、总期限和重定向,但当时旧 DNS 预检与 JDK HTTP 实际解析之间的重绑定窗口仍存在。2026-10-21 的后续增量已用固定地址直连替换该路径,并补特殊地址范围回归,详见 `26-media-dns-binding-and-acceptance.md`;生产网络策略仍未验收。不能将本地下载修复扩大为全项目出站安全保证,也没有擅自更改业务网络或把任意用户 URL 加入可信名单。
## 工程验证与限制
- 新增 3 项模块依赖方向测试:请求应用边界不直接持有 HTTP/JDBC/凭据;transport 不依赖风险/路由/钱包;结算模块不调用上游。它们是轻量源码门禁,不替代代码审查或沙箱。
- 新增跨用户任务查询回归,其他用户不能读取任务结果或列出其任务。
- `.github/workflows/verification.yml` 配置 Java 21、Node 22、锁文件安装、前后端构建与独立 PostgreSQL/Redis 测试;Actions 固定完整 commit SHA(2026-10-21 通过各上游 GitHub API 核对 v4 引用,pnpm 的 annotated tag 另行解引用),避免仅依赖可移动主版本标签。此项不等于审计了 Actions 全部源码。`.github/dependabot.yml` 配置 Maven/npm/Actions 更新检查。仅本地保存配置,未 push、未在 GitHub 运行,不能声称远端 CI 或依赖漏洞扫描已通过。
- 本机 pnpm 包装器提示 esbuild 构建脚本待审批。没有全局关闭审批,也没有批准未知脚本;移除了本次自动生成的待审批占位配置。使用现有安装依赖执行 `npm run build` / `npm test`,前端构建与 25 项测试通过;CI 的锁文件安装仍需首次远端实际验证。
- 使用 Browser 技能在全部 fetch 被拦截的隔离 fixture 中验证改密事件使设置页退回登录入口;密码是测试字符串,没有操作真实账号或浏览器会话。截图 `.tools/auth-security-ui-proof.png` 被忽略,不进入 Git。
最终全量验证于 2026-10-21 22:01(Asia/Shanghai)完成:Java 21 / Maven 3.9.9 的 `mvn -B -o clean verify`,**247 项测试,0 失败、0 错误、0 跳过**,Spring Boot JAR 成功构建。使用独立 PostgreSQL 15.18、Redis 7 容器和共享测试 network namespace,没有连接业务数据库。包含 9 项认证数据库安全回归、既有认证/角色/MFA/钱包/异步核账回归、8 项传输测试、2 项异步超限受理语义回归、3 项依赖方向门禁和跨用户任务读取回归。
前端 `npm run build`(vue-tsc + Vite)和 `npm test` 再次通过,25 项测试零失败;隔离界面验证通过。`git diff --check` 无错误。日志 `.tools/security-final-verify.log` 和截图被忽略,不进入提交。测试通过只证明本次本地已覆盖范围;CI 未远端执行,媒体 DNS 绑定、WebSocket/续接、长请求续租、公平调度、完整配置版本、依赖漏洞与备份恢复验收仍未完成。
不部署、不迁移业务数据库、不进行付费上游生成;只创建本地阶段性 Git commit,不 push。发布此版本前必须先迁移 V49,再启动新后端;首次启动须替换环境示例占位密码。不要将旧 TypeScript 参考服务当成与 Java 同时对外写账的第二套生产后端。