一道安全校验锁死了整张设置表单¶
🔴 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 那一刻出门的,不是在用户按键那一刻。