Skip to content

fix(totp): 持久 factor 绑定、有限匹配及删除账号恢复 - #882

Merged
ranxi2001 merged 6 commits into
productionfrom
fix/issue881-totp-factor-binding
Nov 16, 2026
Merged

ranxi2001 merged 6 commits into
productionfrom
fix/issue881-totp-factor-binding

Conversation

@ranxi2001

@ranxi2001 ranxi2001 commented Nov 16, 2026 •

Copy link
Copy Markdown
Owner

解决的问题与行为变化

多 TOTP 账号原先按返回顺序选择第一个 factor,新增验证器后又要求旧密钥失效,导致两个有效验证器被笼统视为失败。本 PR 持久保存密钥与 factor 绑定,按明确拒绝执行有限匹配,并支持软删除账号的恢复。当前 head 5474722715fc7b9faf4bfdcbe167990e75c9624c 已完成源码审查;71 项检查成功、46 项按条件跳过,当前各工作流最新 attempt 无失败或等待项;全历史仍保留首轮 E2E failure。

  • secret、factor ID 与 enrollment session ID 在同一版本化加密记录中持久保存;journal 和数据库确认先于 activation。session ID 不冒充 factor ID。
  • 本地已绑定登录只挑战指定 factor;旧记录最多匹配两个不同 factor,仅明确 400/401 OTP 拒绝允许下一次挑战。429、网络错误、非 OTP 错误及含糊 HTTP 200 都停止。
  • 成功只表示所选 factor 已验证,返回 selected_factor_verified_no_revocation,不要求另一个有效密钥失败,不删除任何 factor。未获得本次绑定确认不能提交成功,未决任务保留候选及来源。
  • 支持按 task ID 从软删除账号恢复快照;校验邮箱,并将完整恢复配置导入同身份、尚未配置的新账号。专用仓库 SQL 使用 INSERT ... ON CONFLICT DO NOTHING,零行写入返回 409;并发赢家配置不得被覆盖。原身份未决时不允许重新 enroll。
  • 真实授权、登录/2FA 及外部 Session Studio 验收:NOT EXECUTED。需要另行明确授权;不能关闭整个 Issue。 外部首次导入服务的实现与部署不可见,本地修复不能证明它已修复。

独审 R1 已修复:原 raw ProtocolClient.getJson/assertOk 将整个 JSON 拼入异常,error.code=session_expired 配上 message=incorrect code 会错误挑战 F2。现在真实 raw HTTP 边界只把精确允许的 OTP code 转为类型化拒绝,MFA 不再用异常全文 regex。message-only、显式非 OTP code、重复字段、429、网络错误均停止。

R1 原始 reviewer RED 保留;同反例在实际 raw 模块和完整 CLI 先 RED,再生产 patch GREEN。17 项 raw module、27 项 worker/CLI、19 项 adapters、11 项 journal/diagnostics 通过;独审原复现脚本复制到新临时模块后 actual_challenges=1。补丁源码 hash guard 保留,并改用无空白上下文的 tracked diff;基于最新 production 的整个 PR range git diff --check exit 0。

关联记录与来源

管理员新功能提示

  • 提示 ID 与登记项:不适用;本次为已有 TOTP 故障的协议/API 恢复修复,无新增页面、菜单、页签或设置入口。
  • 所有 NewFeatureBadge 展示位置:不适用;未添加前端入口。
  • 关闭行为:不适用;无新标签或本地存储变更。
  • ID 沿用 / 重新公告说明:不适用;未重新公告已有功能。
  • 同一 PR 必要回归证据:协议、worker、journal、API/PG 回归见下表;无 UI 改动,前后截图不适用。
  • A 已关闭后升级 B:不适用,无新提示。
  • B 任一入口关闭后同步隐藏:不适用,无标签入口。
  • 刷新/重新登录持久隐藏:不适用,未改提示存储。
  • 后续 C 显示、旧提示不复活:不适用,未改提示机制。

复现与验收

  • 环境:Linux 开发工作树、合成 S1/S2、F1/F2、离线 HTTP;没有使用生产凭据。
  • 操作:在固定实际协议模块上测试两种 factor 顺序与两个密钥;完整 CLI 执行仅替换 HTTP 边界;随后连接真实 WorkerAPI HTTP 客户端与加密 journal。
  • 修复前:第二个 factor 对应密钥触发人工输入或失败;双有效密钥泛化为 verification_failed。实际离线 RED 已保存。
  • 修复后:指定绑定与有限匹配成功;不确定路径保留材料,不重新 enroll;绑定来源不可覆盖;普通 Codex 诊断层保留有限匹配所需的明确拒绝证据。
  • Go/PG 回归:TestTOTPRecoveryInsertNeverOverwritesExistingOrConcurrentConfig 覆盖现存配置及可观察锁等待的确定性新配置竞态;两种情况下均要求输家 409、赢家完整配置不变。TestTOTPBindingMigrationCanReloadWithoutReplacingSnapshot 实际重复执行 migration 并重新读取。
  • PG RED 是 compatibility reproduction:新方法的兼容 shim 委派到真实旧 UpsertConfig SQL,复现旧行为;不是完整历史 blob 恢复。RED 要求 existing 与 concurrent-insert 各自确切 FAIL 和各自的 conflict 断言,拒绝 build/setup/undefined/no-tests/skip/panic/race/timeout 污染。GREEN 前还原并检查干净 candidate。
协议、调度或传输改动补充
  • OpenAI OAuth/password TOTP;不涉及模型生成、stream 或付费探测。
  • enroll → 加密双写确认 → activate → 新时间窗口验证 → secret/factor CAS 绑定 → 原子提交;已有候选恢复只验证,不 enroll。
  • 429/网络/非 OTP 错误立即停止;含糊 HTTP 200 不成为绑定证据。单次无绑定匹配上限为两个不同 factor。
  • 旧 factor 仍有效不等于新 factor 无效;本流程没有撤销请求,也不声明旧 factor 已撤销。
  • 数据库 claim 清除本次验证标记;过期租约进入 uncertain。来源恢复采用 ciphertext CAS;不会替换不同候选或已知绑定。
  • 外部 Session Studio 初始导入独立未验证;恢复导入配置强制选择本地 worker,返回 verified: false。

实际验证

检查与执行目录 / 命令 结果 覆盖范围、证据或未运行原因
实际 pinned 模块 RED → node --test tools/test_openai_totp_protocol.mjs GREEN 通过 最终 13 项通过;S1/S2、反序、双 factor、限额、含糊响应;red-02、red-06、green-06 原始日志
python3 -m unittest tools.test_openai_totp_integration tools.test_openai_totp_rotation -v 通过 26 项;实际 CLI + WorkerAPI HTTP + sealed journal,API存储/上游为 mock;red-03/04、green-08
worker / engines / runtime-controls 回归 通过 92 项,green-05-worker-regression.log
实际 Codex CLI compatibility + multi-factor 通过 最新 green-09-codex-matching.log:7 项、exit 0;保留初次旧单次挑战断言失败日志,不隐藏失败
diagnostics + journal node tests 通过 11 项,green-10-node.log
Excel/SIWC 适配离线回归 通过 12 项,green-11-adapter-compat.log;不是完整 runtime 构建
验收门禁定向回归与 YAML/bash 语法 通过 3 项,green-12-acceptance-gate.log;缺任一子用例/对应诊断、执行污染均被拒绝
git diff --check 通过 提交前检查
真实 Go handler/service、真实 PG migration/reload/CAS/竞态 当前头通过 547472271 验收:两个真实 PG RED、74 条 handler/service PASS、37 条 PG PASS(含子用例),无失败或跳过污染
amd64/arm64 runtime 当前头通过 547472271 runtime:双架构实际执行 R1 17 项模块及4项完整 worker/CLI集成;正常 API/PostgreSQL deployment 已通过,11项恢复/绑定链路检查实际执行,上游MFA保持mock
production 前端 + go build -tags embed Linux binary 当前头通过 547472271 production build;SHA256 36f99d2dd41ca58c94d1e9732865c93cd80894ccac39d653d3316bb98561f4f4
全 CI 当前头通过 2026-11-16 回读 117 项检查:71 success、46 skipped。主 PR CI、push CI、双架构 runtime、PG、构建及 Pelican E2E 重跑 均成功;首轮失败记录保留,真实上游仍未验证。
真实授权/登录/2FA、外部 Session Studio NOT EXECUTED 需要另行明确授权,不能由 mock/CI 替代

原始本地审计日志位于 /data/development/artifacts/issue881/;远程日志/证据随 workflow artifacts 按 head SHA 保留。旧头 Go/PG/runtime/API/build 成功及独审 R1 失败证据均保留。本轮补充审查核对绑定校验、加密存储、恢复导入的并发保护、协议拒绝分类及最新 production 的无冲突整合;未发现新增阻断问题。未执行真实上游登录或生产部署。

兼容性与运行影响

  • 配置/API:旧密钥 ciphertext 仍可读,所有已知普通 claim、TOTP export、Session export 消费者已适配版本化绑定。新增管理员 task recovery export/import;观察员拒绝访问,敏感响应 no-store。
  • 数据库:migration 382 IF NOT EXISTS,只补空的历史邮箱快照,不覆盖已有快照。开发基线迁移最新为 381;精确 head 547472271 的真实 migrate/reload、CAS/并发保护已在 run 43873797817 重新通过(37 条 PG PASS,含子用例)。
  • 旧 binary 不支持新版本化加密载荷,binary-only rollback 不安全。 必须保留可读绑定的 server/runtime,或另行审核兼容转换。不得清空 journal/候选,或恢复会丢失新凭据的旧数据库快照以绕过 uncertain。
  • 权限/脱敏:secret 与来源同一密文原子保存;日志只给固定类别,不输出 provider body。无真实用户数据。
  • 资源/计费:无模型/付费调用;新增有限 MFA 分支,activation 后仅等待一个新 OTP 窗口;不宣称性能提升。
  • 残余边界:软删除恢复不等于硬删除恢复,FK cascade 与丢失密钥仍不可恢复;未知 factor 格式不猜测;外部 provider 的 factor 行为未验证。未 deploy。

文档与用户可见变化

docs/openai-totp-factor-recovery.md 描述匹配预算、成功不等于撤销、任务恢复接口、同身份目标导入、未决身份禁止重新 enroll、外部导入的受支持恢复路线以及回滚限制。无 UI 重设计或未验证截图声明。

Agent 使用声明

  • Codex(本轮合并推进):源码与 CI 审查、正文状态更新;GPT-6,完整模型 ID 与推理强度未知(当前接口未提供)。未启动子 Agent。

  • Codex CLI:唯一代码 writer,分析、实现、离线回归、文档和远程验收跟进;实际 session metadata 为 gpt-6-astra / xhigh,fast requested,delivered tier 未确认。未派生代码子 Agent。

  • Hermes Agent(Nous Research)监督 Agent:任务/重复项核查、实际 diff 和原始日志审阅、Draft 发布及验收纠偏;先前披露模型 gpt-6.1-sol,推理强度未知(监督运行上下文未提供配置档位)。

  • Hermes Agent 独立完整审查:gpt-6.1-sol,推理强度未知(运行时未提供);发现并离线复现 R1。已独立复审精确头 5474722715fc7b9faf4bfdcbe167990e75c9624c 并亲自执行 raw module/完整 CLI 同测 RED/GREEN,R1 CLOSED / SOURCE CLEAR;精确 head 最新 CI attempt 已通过,合并结果的 production CI 单独跟踪,不把无冲突整合当作 combined-base 动态通过。

提交前自查

  • base production,同分支唯一 PR,无无关源码或其他工作树修改。
  • 已检查 diff、正文和合成样例,不含真实凭据或用户数据。
  • 实际通过、历史失败、待远程结果和未覆盖边界分别列明。
  • 已说明 API、权限、配置、数据兼容与旧 binary 回滚限制。
  • 有实际协议/worker RED/GREEN,真实 PG 回归与证据门禁已接入。
  • 管理员新功能提示各字段及 A/B/C 清单均写明不适用原因。
  • 没有将新功能提示或 UI 验证留待 Release;本次无 UI 入口。
  • 已披露 Agent、可验证模型/强度和未知项。

合并状态:GitHub 记录账号 ranxi2001 于 2026-11-16T14:19:31Z 合并,merge commit 41778efe6f7cb28dd2c70a4b70c6c8b6f04a352c;本次监督与原代码 writer 未执行 ready/merge。合并前最新 attempt 的 117 个 job 全终态(71 success、46 skipped),最后完成的是 E2E 重跑 14:18:29Z;历史首轮 E2E 13:30:31Z failure 保留。合并 commit 的 production CI 尚未全部完成,按该精确 merge SHA 单独跟踪,尚无完整 combined-base 动态 GREEN。Issue #881 保持 open;未 release、deploy 或执行真实授权/登录/2FA。

Preserve uncertain recovery state with allowlisted diagnostics when enrollment leaves both secrets usable. Factor binding and recovery follow-up remain pending.

Refs #881
…tials safely

Bound local challenges, atomically preserve encrypted factor provenance, and require fresh binding before promotion. Add insert-only recovery import, idempotent migration, and isolated PostgreSQL/API acceptance.

Refs #881
Require both recovery subtests to fail their own conflict assertion and replace inverted grep checks with explicit failures. Label the old-Upsert compatibility reproduction accurately.

Refs #881
@ranxi2001 ranxi2001 changed the title fix: 多 TOTP factor 匹配与 429 更换恢复(增量 Draft) fix(totp): 持久 factor 绑定、有限匹配及删除账号恢复 Nov 16, 2026
Check fixture type assertions and express the accepted factor alphabet directly. Repairs exact-head golangci-lint findings without changing the binding contract.

Refs #881
Only exact allowlisted OTP codes at the MFA verify HTTP boundary produce a typed rejection. Explicit non-OTP codes, message-only and duplicate fields stop matching. Cover the independent session_expired counterexample through real getJson/assertOk and the complete CLI.

Refs #881
@ranxi2001
ranxi2001 marked this pull request as ready for review November 16, 2026 14:16
@ranxi2001
ranxi2001 merged commit 41778ef into production Nov 16, 2026
118 of 119 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant