fix(security): 加固模型安装与本地目录源,防止同机后端伪装 #33

Merged
Morris merged 1 commits from fix/security-hardening into main 2026-11-21 07:58:14 +08:00
Owner

背景

针对安全反馈的四类风险进行加固,基于最新 origin2/main(已含 #28/#29/#30/#32)。只含 7 个安全文件,未夹带课件、构建副作用或未跟踪文件。

改动

1. GC-DOWNLOAD/ModelInstaller.cs — 模型 Id 路径越界

  • model.Id 限定为单段安全名称白名单 ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$,拒绝 ./../路径分隔符/盘符/绝对路径。
  • target/staging/backup 一律 GetFullPath + 根目录包含校验。
  • 拒绝符号链接/重解析点;枚举源目录时跳过链接文件。

2. GC-DOWNLOAD/DirectoryRemote.cs — 验签结果与包 URL 约束

  • 不再丢弃 ManifestLoader.Parse 的验签输出,记录 Invalid/Unsigned;信任状态随 SignatureTrust 上送,由下游 UpdateService/LauncherUpdater 统一闸门拒绝。
  • file:// 与绝对路径只允许读 _root 之内;网络 URL 仅允许 http(s),拦截环回/私有/链路本地/元数据/CGNAT/ULA 地址(防 SSRF)。

3. GC-DOWNLOAD/DirectoryRemote.cs — SafePath 符号链接越界

  • 词法校验之外,逐级解析 _root 到目标的每一段,任何重解析点直接拒绝;目录遍历同样跳过符号链接。

4. GC-BOOT/FlutterShell.cs 等 — 本机后端健康检查伪装

  • 启动器生成一次性会话令牌 GC_UI_TOKEN,同时注入进程内后端与 Flutter 前端。
  • /api/health 返回由令牌派生的 sessionProof(不暴露令牌本身),启动器健康探测比对指纹,伪装服务无法复用。
  • 所有 /api/* 请求经 FixedTimeEquals 校验 header/query token;封面图走 query 参数携带。
  • 涉及 DownloadContracts.cs(令牌/指纹工具)、BackendServer.cs(鉴权中间件)、ApiModels.cs(health DTO)、api_client.dart(前端携带令牌)。

验证

  • dotnet build 0 错误;flutter analyze 0 问题。
  • 行为测试 32/32 通过:恶意 Id 拒绝 14/14、合法 Id 放行 4/4、SafePath 符号链接 5/5、URL 约束 9/9。
  • 项目自带 --update-test:篡改清单验签失败、拒绝更新、拒绝启动器更新均通过。
  • 实机启动 GC.app:无 token/错 token/无 token 访问受保护接口均 401;前端与后端 17890 建立 ESTABLISHED 连接,打开即连好。

说明

审阅提到的 SafeArchive(zip-slip/链接条目/炸弹防护)、清单验签(SignatureKeyring ECDSA-P256)、后端鉴权路由均在仓库中且链路完整,本次未改动。

## 背景 针对安全反馈的四类风险进行加固,基于最新 `origin2/main`(已含 #28/#29/#30/#32)。只含 7 个安全文件,未夹带课件、构建副作用或未跟踪文件。 ## 改动 ### 1. `GC-DOWNLOAD/ModelInstaller.cs` — 模型 Id 路径越界 - `model.Id` 限定为单段安全名称白名单 `^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$`,拒绝 `.`/`..`/路径分隔符/盘符/绝对路径。 - `target`/`staging`/`backup` 一律 `GetFullPath` + 根目录包含校验。 - 拒绝符号链接/重解析点;枚举源目录时跳过链接文件。 ### 2. `GC-DOWNLOAD/DirectoryRemote.cs` — 验签结果与包 URL 约束 - 不再丢弃 `ManifestLoader.Parse` 的验签输出,记录 Invalid/Unsigned;信任状态随 `SignatureTrust` 上送,由下游 `UpdateService`/`LauncherUpdater` 统一闸门拒绝。 - `file://` 与绝对路径只允许读 `_root` 之内;网络 URL 仅允许 http(s),拦截环回/私有/链路本地/元数据/CGNAT/ULA 地址(防 SSRF)。 ### 3. `GC-DOWNLOAD/DirectoryRemote.cs` — SafePath 符号链接越界 - 词法校验之外,逐级解析 `_root` 到目标的每一段,任何重解析点直接拒绝;目录遍历同样跳过符号链接。 ### 4. `GC-BOOT/FlutterShell.cs` 等 — 本机后端健康检查伪装 - 启动器生成一次性会话令牌 `GC_UI_TOKEN`,同时注入进程内后端与 Flutter 前端。 - `/api/health` 返回由令牌派生的 `sessionProof`(不暴露令牌本身),启动器健康探测比对指纹,伪装服务无法复用。 - 所有 `/api/*` 请求经 `FixedTimeEquals` 校验 header/query token;封面图走 query 参数携带。 - 涉及 `DownloadContracts.cs`(令牌/指纹工具)、`BackendServer.cs`(鉴权中间件)、`ApiModels.cs`(health DTO)、`api_client.dart`(前端携带令牌)。 ## 验证 - `dotnet build` 0 错误;`flutter analyze` 0 问题。 - 行为测试 32/32 通过:恶意 Id 拒绝 14/14、合法 Id 放行 4/4、SafePath 符号链接 5/5、URL 约束 9/9。 - 项目自带 `--update-test`:篡改清单验签失败、拒绝更新、拒绝启动器更新均通过。 - 实机启动 `GC.app`:无 token/错 token/无 token 访问受保护接口均 401;前端与后端 17890 建立 ESTABLISHED 连接,打开即连好。 ## 说明 审阅提到的 SafeArchive(zip-slip/链接条目/炸弹防护)、清单验签(`SignatureKeyring` ECDSA-P256)、后端鉴权路由均在仓库中且链路完整,本次未改动。
Morris added 1 commit 2026-11-21 07:57:29 +08:00
fix(security): 加固模型安装与本地目录源,防止同机后端伪装
PR 审核 / 后端编译 (pull_request) Waiting to run
PR 审核 / 前端检查(Flutter) (pull_request) Waiting to run
PR 审核 / 安全扫描 (pull_request) Waiting to run
46ed84475d
- ModelInstaller: 模型 Id 限定为单段安全名称,拒绝路径分隔符/绝对路径/
  符号链接,源目录枚举跳过重解析点,防止写到模型库外
- DirectoryRemote: 清单验签失败如实记录;包 URL 仅允许 http(s) 公网地址,
  拦截 file:/私有 IP/环回/元数据地址(SSRF);SafePath 逐级解析符号链接
  并确认仍在根目录内
- 本机后端健康检查改为一次性会话令牌双向校验(/api/health 返回指纹),
  同机伪造服务无法通过身份确认;所有 /api 请求需带令牌,封面图走 query

只含 7 个安全文件,基于最新 origin2/main(含已合入的 #32 课件)。
Morris merged commit 4043ed5e72 into main 2026-11-21 07:58:14 +08:00
Author
Owner

#31

#31
Morris deleted branch fix/security-hardening 2026-11-21 07:58:22 +08:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Morris/GC#33