跳转至

一道安全校验锁死了整张设置表单

🔴 v0.10.196 后续(ISSUE-0164):本篇的修复方向(判据下沉到凭据出门处)是对的, 但那把尺子仍然量错了东西 —— 它默认「https = 安全」,而 https 只保证传输不被窃听, 不保证收件人是你信任的那个。Tony 实测填 https://test.com,判据放行,凭据照发。 ⇒ v0.10.196 取消了可配置地址本身,本篇的 audit_grep 第二条随之反转为 absent。

怎么发现的

v0.10.177–180 这批(设置页清地雷)送 terra-dsh + dshf 双路对抗审。 两路独立判出同一条 P0,且与主控事前自查到的是同一条。

审查方 裁决 P0
terra-dsh NO-GO 存量非 https 的 cloudSyncBaseUrl 让用户无法保存任何设置
dshf GO-WITH-CHANGES 同上(另报 4 条 P1/P2)

两路在事实层完全一致,分歧只在 BLOCKER 阈值。按「不投票、回判据」裁决: 存在 P0 ⇒ 取 NO-GO,返工。

F1(P0):判据放错了层

v0.10.178 给 cloudSyncBaseUrl 加了 https 校验,写在设置页的 yup schema 里。

而这一页没有保存按钮 —— 唯一写入路径是 performSave 里 handleSubmit 的成功回调:

settings-view.tsx  performSave()
  → handleSubmit(onValid, onInvalid)
      onValid:   settingParamsStorageItem.setValue(data)   ← 唯一写点
      onInvalid: setSaveError(第一条错误)                   ← 什么都不写

⇒ 任何一个字段不过,整份设置一个字节都不落盘。

复现: 1. 用户在 ≤v0.10.177 填过 http://<自建>/api/v1 并保存成功(当时 schema 是裸 Yup.string()) 2. 升级到 v0.10.178+ 3. 改「任务间隔」→ 800ms debounce → yup 报 cloudSyncBaseUrl → 任务间隔不落盘 4. 界面上只有一行小字 ⚠ 必须是 https://…,而那个字段在一个他可能从没展开过的折叠区里

🔴 一道为了保护凭据而加的校验,把整张设置表单变成只读。

根因

要保证的是「Bearer 凭据不发往非 https 地址」, 而这道 yup 量的是「表单能不能保存」。两件事。

而且设置页天然拦不住存量值 —— 那个 http 地址早就在 storage 里了, 校验只在「用户这次编辑」时跑。真正绕不过的关口在凭据出门那一刻。

修

判据下沉,并且只写一处:

src/utils/cloud-sync-url.ts       isUsableCloudBaseUrl()   ← 判据唯一源(零副作用,可直接测真值)
  ├─ cloud-sync-client.ts getBaseUrl()   非 https ⇒ 回退官方地址 + sysLog 留痕   ← 真关口
  └─ settings-view.tsx                   当场红字提示,**不进 yup**              ← 只提示

额外收益:判据成了纯函数,能用行为测试跑真值。 上一版只能用源码断言,而源码断言挡不住 === 'https:' || true 这种改法 (terra 给的构造:源码里 'https:' 还在,测试照样绿,http 却被放行)。

F2(P1):v0.10.180 只修了一半

0153-max-concurrent-fallback-fork 把三处 || 字面量 收归真相源, 两个 catch 分支原样留着 return 1 与 return 2。

而 ISSUE-0153 正文写的触发条件第一条就是「storage 读失败」—— 那正是 catch。

⇒ 修的是自己描述的场景里最次要的那一半,最典型的那一半原样留着, 而 issue 已标 fixed、commit message 写「三处兜底全部改引」。

闸也没拦住:断言只匹配 maxConcurrentTasks || <数字>, dshf 实测把 catch 改成 return 9 测试照样全绿。

F3(P1):留痕在批量删除时被整体吃掉

system-log.ts 的 sanitize():detail 的 JSON 超过 2048 字符 ⇒ 把整个 detail 对象换成 { _truncated, preview, length }。

而 v0.10.179 的留痕写的是 { count, ids: dropIds },两万个 id ≈ 109KB ⇒ count 和 ids 在真实存储里一个都不剩,只剩一截字符串预览。

🔴 删得越多,留痕越没用 —— 而留痕正是为「一次删两万条、没有回收站」设的。

现有的 finalize-guard 测试 mock 掉了 appendSysLog,断言的是未经 sanitize 的参数, 所以「记了 count + ids」在批量场景下是测试给的错觉。

⇒ 改为 { count, sampleIds: 前 20 个, idsTruncated },并新增 tests/delete-log-survives-sanitize.test.ts 直接对着真实阈值算(含对照组证明断言有牙)。

F4:文案闸自己的两个洞

  • codeOnly() 只剥整行注释 ⇒ const x = 0; // Bearer token 照样喂给断言
  • 文件头写「每条断言都必须用它」,实际 9 条里只有 4 条用了

⇒ 补引号状态机剥行内注释('https://…' 里的 // 必须留着)、全部断言改走 codeOnly、 并加一条元断言让那句声称变成可执行的。

⚠️ 元断言第一版立刻被自己抓住 —— 本文件有三处注释在叙述「第一版直接 src.includes()」 这段历史,而那正是它要禁的形态。同一天第三次踩同族。

F5:minRating 的 helper 漏了判据的一半

真实判据是 minRating > 0 && (无评分 || 低于阈值), 而 v0.10.177 补的文案「没有评分的商家也会被跳过」是无条件句 —— 填 0 时整条过滤根本不跑。

🔴 订正(v0.10.184):这一条当时只改了 wiki,UI 的两处 helper 根本没进提交。 当轮变异还原用的 cp 备份是在这处改动之前做的,把它一起抹了; 而那句话当时没有任何断言守着 ⇒ vitest / tsc / verify / build 全绿通过。 是 Tony 加载 unpacked 截图才发现的。 本文原句「helper 与 wiki 一并补上」当时不成立,现已在 v0.10.184 补回并加断言。 完整复盘见 0156-mutation-restore-wiped-a-real-edit。

验证

  • 定向变异 8 条(catch×2 / 留痕 / yup 回退 / 关口删除 / 行内注释伪造 / 裸 src / mock 分叉) —— 7 条一次打中,1 条首打没抓住(见下),收紧判据后复打抓住
  • vitest 1584 全绿(70 文件) · tsc rc=0 · pnpm verify rc=0

⚠️ 自己的变异首打失手一次,如实记

M5「删掉 getBaseUrl 里的 https 关口」第一次没被抓。 断言写的是 expect(clientSrc).toContain('isUsableCloudBaseUrl') —— 而 import { isUsableCloudBaseUrl } from './cloud-sync-url' 那一行也含这个名字。

又是「判据在量别的东西」:量的是「文件里有没有这个词」, 要守的是「关口在不在那条路上」。改为切到 getBaseUrl 的函数体内再断言。

元教训

一道安全校验放错了层,比不加还糟。

不加 ⇒ 少一层防护。放错层 ⇒ 既没防住真正的入口(存量值绕过它), 又把无关的功能(整张设置表单)锁死。

判断它该放哪一层的问题只有一个: 你要保证的那件事,最后是在哪一行代码上发生的? —— 凭据是在 fetch 前拼 header 那一刻出门的,不是在用户按键那一刻。