fix(update): 换发清单签名密钥,补齐 1.0.9 已签名清单
仓库里硬编码的公钥 gc-2026-11 没有对应的私钥(.signing/ 在 .gitignore 里, 私钥从来没入过库,也无法找回),导致 build.sh 每次签名都失败,version.json 始终是「未签名」。而客户端默认 RequireSignedManifest=true,未签名清单一律 拒绝更新 —— 自动更新实际上完全不可用。 改动: - keygen 生成新密钥 gc-2026-12(指纹 ee6083be47a87907),公钥写进 SignatureKeyring;旧 gc-2026-11 保留一个版本周期,标注为「私钥遗失、已停用」 - GC-SAVEDOG 的 DefaultKeyId 与 build_funcs.sh 的 GC_SIGNING_KEY_ID 默认值 同步改为 gc-2026-12,避免 keyId 与私钥不匹配又签出 Invalid - GC.Tests 构造可信清单时用的 keyId 改为 gc-2026-12(原来硬编码旧 keyId, 换钥匙后会判成 Invalid) - README 补上密钥轮换的实际步骤与「换钥匙老客户端就更新不了」的代价 - Directory.Build.props 版本 1.0.7 → 1.0.9(此前只靠 -version 传参, 仓库里一直停在 1.0.7,与实际发布脱节) - version.json / model/version.json 换成 1.0.9 且带 gc-2026-12 签名, 两份字节一致 验证: - GC.Tests --update-test 全通过,日志里是「清单验签通过(gc-2026-12)」, 篡改清单被判 Invalid 并拒绝更新 - GC-SAVEDOG verify --manifest version.json → Verified - 三平台重新出包:win-amd64 109 MB、win-arm64 105 MB、mac-arm64 57 MB 注意:1.0.8 及更早的客户端只认识旧公钥,这份清单在它们眼里是「签名无效」, 与之前的「未签名」等价 —— 都不会自动更新。要让自动更新真正生效,需要把 带新公钥的 1.0.9 发出去。
This commit is contained in:
1 parent
40e72957e3
commit
e327a56421
13 files changed
+108
-72
No files matched your search
@@ -135,12 +135,23 @@ Windows 用 `.\build.ps1`,参数相同(`build / check / models / stamp / run
|
||||
### 签名密钥
|
||||
|
||||
- 私钥:`.signing/gc-signing.pem`(**已在 `.gitignore`,永不入库**;请自行备份)
|
||||
- 公钥:硬编码在 `GC/src/Security/SignatureKeyring.cs`,指纹 `b41b1dd6259ea9ed`
|
||||
- 生成新密钥:`dotnet run --project GC-SAVEDOG -- keygen`
|
||||
- 轮换:把新公钥追加进 `SignatureKeyring.Keys`(保留旧公钥一个版本周期),再重新签名清单
|
||||
- 公钥:硬编码在 `GC/src/Security/SignatureKeyring.cs`
|
||||
- 当前生效:`gc-2026-12`,指纹 `ee6083be47a87907`
|
||||
- 已停用:`gc-2026-11`,指纹 `b41b1dd6259ea9ed`(私钥遗失,仅保留占位)
|
||||
- 生成新密钥:`dotnet run --project GC-SAVEDOG -- keygen --key-id gc-YYYY-MM`
|
||||
- 轮换:把新公钥追加进 `SignatureKeyring.Keys`(保留旧公钥一个版本周期),
|
||||
同时把 `GC_SIGNING_KEY_ID`(默认值在 `buildsh/lib/build_funcs.sh`)改成新 keyId,
|
||||
再重新签名清单
|
||||
- 部署前核对两边公钥一致:
|
||||
`dotnet run --project GC-SAVEDOG -- verify --manifest version.json`
|
||||
|
||||
`build.sh` 在刷新清单后自动调用 `sign_manifest` 签名并同步 `model/version.json`;
|
||||
`.signing/gc-signing.pem` 不存在时只告警,清单不带签名(客户端会拒绝更新)。
|
||||
|
||||
> 换钥匙的代价:老客户端只认识编译进去的那份公钥,所以**用新密钥签出的清单
|
||||
> 在旧版本上会判成「签名无效」**。密钥一旦丢失,只能靠发一个新版本把新公钥带出去,
|
||||
> 中间这段时间老客户端无法自动更新 —— 私钥务必备份两处以上。
|
||||
|
||||
### zip 解压加固
|
||||
|
||||
更新包和模型源 zip 一律当成不可信输入:拒绝 `../`、绝对路径、盘符、UNC、符号链接;
|
||||
|
||||
Reference in new issue
Block a user