Files

26 KiB
Raw Permalink Blame History

插件发布者指南(P3-12c / P3-13):从模板到托管分发

目标读者:在 VDE 微内核之上开发并对外分发原生插件的团队/个人。 本文覆盖完整发布链路:scaffold → 独立 build → --check → 打包 → 签名 → --build-index → 托管(HTTPS/对象存储/离线镜像)→ 宿主侧 --fetch-index / --install → PluginManager 发现与加载。

版本基线:VDE 1.0.70+(插件 ABI 1.3,宿主 1.x 兼容 ABI 1.0–1.3)。 相关文档:


1. 发布流水线总览

# 阶段 命令/产物 门禁
1 生成工程 vde_plugin_tool scaffold <kind> <name> --out <dir> 生成后立即可独立构建
2 独立构建 cmake -S <dir> -B <dir>/build -DVDE_SDK_DIR=<VDE> + cmake --build 0 error;不链接内核
3 自检 vde_plugin_tool --check <dir>/build/plugin 退出码 0;ABI/query/artifacts 一致
4 打包 目录:vde-plugin.json + 动态库 + 必要数据 无构建中间产物;清单与产物同目录
5 签名建索引 --build-index ... --sign <seed> --key-id <id> --publisher <name> --verify-index --pubkey 退出码 0
6 托管 静态 HTTPS/CDN/对象存储/离线镜像 索引稳定 URL + 不可变版本路径 + 公钥指纹公示
7 宿主获取/安装 --fetch-index / --install --fetch-packages / --upgrade 验签+哈希+ABI 门禁通过
8 宿主发现/加载 PluginManager 指向安装目录;安全策略 trusted_keys/revoked_key_ids 加载前校验(P3-5)、失败隔离

发布物 = 插件包目录 + index.json(可整体 Ed25519 签名)。私钥/种子永远不进入发布物、仓库、镜像或宿主。


2. 从模板生成工程(scaffold)

# kind = format | cae | cam | gcs(也接受 format_plugin/cae_solver/cam_strategy/gcs_solver)
# name = 插件唯一 id(反域名,如 com.acme.widget;也接受短名,工具会派生能力前缀/slug)
vde_plugin_tool scaffold format com.acme.widget --out plugins-src/acme-widget
# 可选:显式模板目录(默认按 $env:VDE_PLUGIN_TEMPLATE_DIR、<VDE>/plugins/templates 查找)
vde_plugin_tool scaffold gcs com.acme.solver --out plugins-src/acme-solver --templates <VDE>/plugins/templates
  • 生成内容:插件实现 *.cpp、vde-plugin.json、独立 CMakeLists.txt、README.md(四类模板矩阵见 plugin-development.md §14.1);
  • 模板声明 ABI { "major": 1, "minor": 3 };如需发布兼容旧宿主的插件,参见 §9 兼容矩阵;
  • 目标目录已存在时需 --force;非法 kind / 缺 --out / 无效 --templates 均返回退出码 2;
  • 生成后会打印 next steps(configure/build/--check/--list)。

3. 独立构建

cmake -S plugins-src/acme-widget -B plugins-src/acme-widget/build `
      -G Ninja -DCMAKE_BUILD_TYPE=Release -DVDE_SDK_DIR=<VDE 源码根或安装前缀>
cmake --build plugins-src/acme-widget/build
# 产物:plugins-src/acme-widget/build/plugin/{vde-plugin.json, <动态库>}
  • 插件只依赖纯 C ABI 头 include/vde/plugin/vde_plugin_api.h,不链接内核(宿主在运行时注入 服务表 VdePluginHost);
  • Windows 产物无 lib 前缀(模板 CMake 已设 PREFIX ""),与清单 entry.windows 一致;
  • 构建产物目录即“插件目录”:vde-plugin.json 与动态库必须位于同一目录;
  • 如需可复现构建:固定 SDK 头/工具版本、固定编译器与 -DNDEBUG -O2、去掉时间戳类宏(清单里不要写 构建时间;generated_at 由索引生成时刻决定,见 §6)。

4. 发布前自检(--check / --list / --abi)

vde_plugin_tool --abi                              # 打印宿主 ABI/内核版本/C 结构体尺寸(CI 记录基线)
vde_plugin_tool --check plugins-src/acme-widget/build/plugin
vde_plugin_tool --list  plugins-src/acme-widget/build/plugin
vde_plugin_tool --inspect plugins-src/acme-widget/build/plugin/vde-plugin.json

--check 校验(退出码 0 通过 / 2 用法错误 / 3 校验失败):

  1. 清单存在且可解析:必填 id/version/kind/entry/abi;
  2. 平台 entry 解析后的动态库存在;
  3. 动态库导出 vde_plugin_query,其 id/version/kind/abi 与清单一致;
  4. manifest.abi_major == host major 且 manifest.abi_minor <= host minor;
  5. 清单声明的 artifacts[{path,sha256}] 路径安全/存在/哈希一致;
  6. kind 与能力前缀一致性(warning,不阻断)。

注意:对构建产物目录执行 --check/--list,不要对源码目录执行(源码目录清单引用的 DLL 尚未构建, 会报 plugin library not found,属预期)。

5. 打包(package)

插件包 = 一个目录,至少包含:

packages/com.acme.widget/
  vde-plugin.json          # 清单(id/version/kind/abi/entry/capabilities/artifacts...)
  vde_widget.dll           # entry 指向的动态库
  data/...                 # 可选:模板/内置数据/许可声明
  • 不要包含:build/ 中间产物、.pdb/调试符号、测试数据、私钥、CI 日志;
  • artifacts 由 --build-index 扫描包目录自动计算 SHA-256(列为包内相对路径);也可在清单里显式声明 artifacts[{path,sha256}](strict 宿主策略要求声明,见 plugin-security.md §4.5);
  • 包内文件使用相对路径;工具与宿主会拒绝 ..、绝对路径、盘符/UNC 等逃逸路径;
  • 多版本:同一 id 可并存多个版本目录(packages/<id>/<version>/ 由发布流程约定;索引条目用 path 指向具体版本目录),便于 --install --version / --upgrade --version 回滚;
  • 许可:在清单 license 与包内 LICENSE 中一致声明(SPDX 标识);发布说明中列第三方组件与许可。

6. 签名与构建索引(index)

6.1 建立发布密钥(生产:离线/受控环境)

# 仅开发/测试可用工具生成(生产建议 KMS/HSM 或离线机生成并保管种子)
vde_plugin_tool --gen-keypair --out-dir keys/
# keys/plugin_signing.key(32B seed hex,保密,绝不入库/上传)
# keys/plugin_signing.pub(32B 公钥 hex/ed25519:<base64>,随信任配置分发)
  • 算法:Ed25519(RFC 8032);签名串 ed25519:<base64(64B)>;
  • 索引签名载荷 = 索引 JSON 去掉顶层 signature 的 canonical 序列化(键字典序、无空白、UTF-8); key_id/publisher/generated_at/全部插件条目与 artifacts 哈希均在签名载荷内;
  • key_id 是轮换/吊销的抓手:建议 <publisher>-<YYYY>[-<env>](如 acme-2026-release),不要复用;
  • publisher 是签名后可信的自称值(宿主可做白名单,但白名单必须与验签公钥绑定);
  • 开发/CI 用临时密钥;生产密钥只放在离线签名环境,CI 通过受控签名作业或人工离线签名, 不允许把生产种子放进普通 CI secret 供所有 PR 使用(见 plugin-ci-template.md);
  • 吊销:--verify-index / --install / --upgrade 支持 --revoked-keys <file>(文件每行一个 key_id, 或 JSON {"revoked_key_ids":[...]});不传该参数时工具不做吊销检查(吊销≠撤回索引签名)。 推荐用签名 CRL 分发吊销(P4-08,见 §6.4):宿主固定 CRL 公钥后可自动合并吊销, 无需逐台维护列表;--revoked-keys 仍保留用于离线/临时吊销。

6.2 构建索引

vde_plugin_tool --build-index repo/packages -o repo/index.json `
    --sign keys/plugin_signing.key --key-id acme-2026-release --publisher "Acme Corp"
  • 扫描 repo/packages/** 下每个插件包,计算 artifact SHA-256,写入 schema v1 index.json (字段定义见 plugin-distribution.md §2);
  • 不带 --sign 生成 unsigned 索引(仅内网/开发;正式分发必须签名);
  • --build-index 会校验清单/ABI/entry 等基本项;建议先对每个包做 --check;
  • 索引 generated_at 由工具生成(审计用途)。需要“同一内容多次构建字节一致”时,发布流程应固定 索引生成时点/由外部工具生成 canonical JSON;签名覆盖字节,重签前不要手工改索引。

6.3 校验索引(发布门禁,必须做)

vde_plugin_tool --verify-index repo/index.json --pubkey keys/plugin_signing.pub
# 校验:schema → 签名 → 路径安全 → 每个 artifact 存在且 SHA-256 一致 → ABI 与宿主兼容 → 重复条目
  • --allow-unsigned 只允许开发/内网镜像;公网发布应始终 --pubkey 且拒绝 unsigned(退出码 4);
  • --pubkey 支持内联 ed25519:<base64|hex> 或文件路径;文件为单行 hex/base64/ed25519: 前缀;
  • 负例回归(发布 CI 必测):篡改任一 artifact → 退出码 3;改索引内容导致坏签名 → 3;路径逃逸 → 3; ABI 2.0 → 3;unsigned 未加 --allow-unsigned → 3;已签名但未给 --pubkey → 4;key_id 在 --revoked-keys 列表中 → 3。

6.4 发布吊销列表(CRL,P4-08)

  1. 生成 payload(发布系统按密钥生命周期生成;时间 UTC ISO8601):
{
  "version": 1,
  "issued_at": "2026-01-01T00:00:00Z",
  "expires_at": "2026-01-31T00:00:00Z",
  "revoked_key_ids": ["acme-2025-release"]
}
  1. 离线签名(与索引同一 canonical/Ed25519 规范):
vde_plugin_tool --sign-crl crl.payload.json -o repo/crl.json --sign keys/crl_signing.key
  1. 发布:与 index.json 同域静态站点(如 https://plugins.acme.example/vde/crl.json),HTTPS + 固定 URL;建议短有效期 (30 天)并定期重签,旧 CRL 过期后宿主会拒绝(退出码 3),需在过期前更新;
  2. 宿主/安装器使用:--verify-index ... --crl <crl.json|url> --crl-pubkey <crl_signing.pub> (或复用索引公钥;建议独立 CRL 签名密钥便于轮换);离线环境分发本地 crl.json;
  3. 发布门禁:CRL 过期/签名失败 → 退出码 3;URL/文件不可获取或工具无 Ed25519 支持 → 4; 非 Windows 平台 --crl 不支持 http(s) URL,需下载到本地文件后传入;
  4. 轮换:CRL 公钥可独立于索引 key 轮换;宿主同时固定新旧公钥过渡,旧 CRL 公钥退役后 从宿主配置移除。

7. 托管(hosting)

推荐布局(静态站点即可,无需自建服务器):

https://plugins.acme.example/vde/                 # 稳定索引 URL(发布说明里固定)
  index.json                                     # --build-index 产物(已签名)
  packages/
    com.acme.widget/
      1.4.0/{vde-plugin.json, vde_widget.dll, data/...}
    com.acme.solver/
      2.0.1/{...}
  • 索引 URL 稳定(如 .../vde/index.json),包路径按索引相对 path 组织;宿主/安装器只需配置该 URL;
  • 版本不可变:已发布版本目录只增不改;要修 bug 发新版本(索引保留旧版本用于回滚);
  • 适合的托管:GitHub Releases(把 repo/ 打包上传或逐文件)、静态对象存储 + CDN、企业内网静态服务器、 离线 U 盘/共享盘镜像(目录结构同上,本地路径或 file://);
  • 响应头建议:index.json 用短缓存(Cache-Control: max-age=300, must-revalidate);版本化包路径可用 长缓存/immutable;Content-Type: application/json;提供 SHA-256/公钥指纹到发布说明;
  • 不要托管:私钥/种子、.git、构建机日志、未签名索引供公网使用、--allow-unsigned 说明;
  • 平台限制(当前):--fetch-index/--fetch-packages 的 http(s) 获取在 Windows 构建经 WinHTTP; Linux/macOS 构建当前仅支持本地路径/file://。跨平台在线分发建议:宿主用 Windows 安装器拉取,或 由宿主/安装器自行下载到本地 repo/ 后以本地索引调用工具(离线镜像方式最稳);
  • 多镜像:同一 index.json + packages/ 可镜像到多个站点,公钥固定即可;切换镜像不改变信任根;
  • 迁移/回滚:保留旧 index.json 副本与旧版本包;回滚宿主只需改回旧索引 URL(或 --upgrade --version);
  • 吊销信息:在托管站点提供稳定 revoked.json({"revoked_key_ids":[...]},只增不改)或等价说明, 宿主/安装器以受信通道获取后传给 --revoked-keys / 宿主策略 revoked_key_ids;吊销文件本身应与发布 说明一起签名/审计(当前工具只消费 key_id 列表,不校验吊销文件签名)。

8. 宿主侧获取与安装(host fetch/install)

8.1 命令行(安装器/运维脚本)

# 1) 只取索引并验签(远程元数据;--verify-artifacts 需本地已有 packages)
vde_plugin_tool --fetch-index https://plugins.acme.example/vde/index.json `
    -o installed/index.json --pubkey acme-2026.pub --verify-artifacts

# 2) 从索引安装(自动验签/哈希/ABI;远程需 --fetch-packages)
vde_plugin_tool --install https://plugins.acme.example/vde/index.json --dest installed/ `
    --id com.acme.widget --fetch-packages --pubkey acme-2026.pub

# 3) 升级(staging + 校验 + 原子替换;失败自动回滚)
vde_plugin_tool --upgrade https://plugins.acme.example/vde/index.json --id com.acme.widget `
    --dest installed/ --fetch-packages --pubkey acme-2026.pub

# 4) 带吊销列表校验/升级(--revoked-keys 可选,文件或 JSON)
vde_plugin_tool --verify-index installed/index.json --pubkey acme-2026.pub \
    --revoked-keys revocations.txt

# 5) 卸载(仅删 <dest>/<id>/,路径安全校验)
vde_plugin_tool --uninstall com.acme.widget --dest installed/
  • 安装布局:<dest>/<id>/(vde-plugin.json + 动态库 + 数据),可直接作为宿主插件搜索路径;
  • requires 依赖(简化 semver)在 --install/--upgrade 时递归解析;批量安装先落 staging、校验后原子提交, 失败回滚本批(详见 plugin-distribution.md §4.7/§4.9);
  • 远程索引 URL 必须配合 --fetch-packages(否则退出码 3);从不信任的 URL 只取索引而不校验哈希时, 仅获得元数据,不应据此加载插件。

8.2 宿主进程内(PluginManager)

安装完成后,宿主把 PluginManager 的扫描目录指向 <dest>(或逐个 load(<dest>/<id>)),并配置安全策略:

// 示意:宿主初始化(具体 API 以 include/vde/plugin/plugin_manager.h 为准)
PluginManager manager;
manager.add_search_path("C:/ProgramData/Acme/plugins");     // 工具安装目标目录

PluginSecurityPolicy policy;
policy.require_signature        = true;      // 生产:拒绝未签名插件
policy.require_artifact_hashes  = true;      // strict:清单必须声明 artifacts(P3-5)
policy.trusted_keys             = { {"acme-2026-release", acme_pubkey_bytes} };
policy.revoked_key_ids          = { "acme-2024-old" };  // 优先于受信表
policy.allowed_publishers       = { "Acme Corp" };
manager.set_security_policy(policy);
// 可选:注入签名验证器(默认不含 Ed25519;宿主用 vde_license/KMS/HSM 实现)
// manager.set_security_verifier(...);

manager.scan_search_paths();                  // 发现;--list 同规则
manager.load("com.acme.widget");             // 扫描后 load() 在 dlopen 前做签名/哈希/ABI/权限校验
  • 公钥必须来自可信通道(宿主内置/企业 PKI/发布说明指纹);不要信任索引或下载站点自带的公钥;
  • 权限是声明式(默认拒绝):清单 permissions 声明的权限需宿主显式 grant;
  • 安全校验失败:宿主记录 last_error 并拒绝加载,不影响其他插件(失败隔离);
  • 校验发生在加载前;宿主应确保安装目录普通用户不可写(见 §10 TOCTOU 缓解)。

9. 兼容矩阵(内核 1.x × ABI 1.0–1.3)

规则:宿主接受 plugin.abi.major == host.major 且 plugin.abi.minor <= host.minor;否则加载前拒绝。

插件 ABI 能力增量 宿主要求
1.0 基础插件 ABI(query/init/shutdown、format 扩展点基础、host 服务表最小集) 宿主插件 ABI ≥ 1.0
1.1 body_from_mesh host 服务;官方 STL/OBJ/PLY 插件化(ABI 1.1 旧插件继续可加载) 宿主插件 ABI ≥ 1.1
1.2 CAE solver + CAM strategy 扩展点;官方 STEP/IGES/DXF 格式插件 宿主插件 ABI ≥ 1.2
1.3 GCS 约束求解器扩展点(VdeGcsSolverPlugin/gcs:solve);struct_size 尾扩展 宿主插件 ABI ≥ 1.3
  • 当前主线(1.0.70–1.0.77)宿主 ABI = 1.3:接受插件声明 ABI 1.0/1.1/1.2/1.3,拒绝 2.0;
  • 旧宿主(如 ABI 1.2)加载声明 1.3 的插件会被清单/ABI 规则拒绝;需要兼容旧宿主就发布对应旧 minor 的构建(同一源码用 -DVDE_PLUGIN_ABI_MINOR_OVERRIDE=<n> 编出 1.0/1.1/1.2 版本,见 CI 模板矩阵);
  • 兼容性以 ABI 声明与 struct_size 规则为准;插件不要假设宿主新字段,未知字段按 struct_size 判空;
  • 旧 ABI 插件(1.0–1.2)在新宿主上仍应可用(向后兼容);发布前用目标宿主版本的 --check 验证。

10. 供应链安全与 TOCTOU

10.1 已有防护(P3-1/P3-5/P3-13)

  • 清单/索引 Ed25519 签名(canonical payload;签名覆盖 artifacts 哈希清单);
  • artifact SHA-256 校验(--check/--verify-index/--install/宿主 load 前);
  • 路径安全(拒绝 ../绝对路径/盘符);ABI 门禁;重复条目检查;
  • 安装/升级 staging + 原子提交 + 失败回滚;卸载路径安全校验;
  • 宿主侧安全策略(trusted_keys/revoked_key_ids/allowed_publishers/权限默认拒绝)。

10.2 TOCTOU(校验与加载之间)

已知窗口:artifact 哈希校验(以及签名校验)发生在加载前;从校验完成到 dlopen 之间,若攻击者 对插件目录有写权限,可在窗口期替换动态库。P3 范围未做 OS 代码签名/Authenticode,也未做“校验后以独占 句柄/文件锁加载”的强保证(后续 P3 安全项)。

发布者/宿主可做的缓解:

  1. 安装目录只读、普通用户不可写(Windows:管理员安装 + 目录 ACL;POSIX:root 安装 + 0555/属主保护);
  2. 安装/升级后立即加载前重新校验(--check/宿主 verify),校验与加载在同一受控账户;
  3. 避免把插件装到用户可写路径(如 %TEMP%、共享目录)再“提权加载”;
  4. 高价值链(许可/计量)优先使用进程外服务(vde-service,P3-14 沙箱/容器隔离), 进程内原生插件无法提供强隔离(崩溃/恶意代码仍影响宿主);
  5. 容器/独立用户运行宿主,限制可写挂载;
  6. 保留发布侧索引/哈希审计记录,部署后可用 --verify-index --verify-artifacts 复检;
  7. 生产使用 OS 代码签名(Authenticode)作为纵深防御(当前内核不强制,见 plugin-security.md §8)。

10.3 进程外建议(不可信/高风险插件)

  • 需要强隔离/资源限制/网络关闭时,不使用进程内插件,改用外部服务:vde-service.json + 沙箱策略 (network:none/filesystem:read_only/isolation:process)或容器运行时(P3-14c);
  • 外部服务同样需要发布物哈希/签名与来源校验(发布者侧签名 JSON/工件哈希,宿主侧固定服务路径与 允许列表);
  • 详见 plugin-development.md §12 与 plugin-security.md。

11. 常见错误码与排查

11.1 工具退出码

退出码 含义 常见原因
0 成功 —
2 用法/参数错误(含公钥文本格式错) 缺 -o/--dest/--id;非法 --pubkey;非法 kind;目录已存在未加 --force
3 校验失败 清单/query/ABI 不一致;签名/哈希/路径逃逸;unsigned 索引;ABI 不兼容;插件/依赖不存在;索引 URL 未配合 --fetch-packages
4 加密校验不可用 签名索引/签名验证未提供 --pubkey;工具构建未启用 vde_license(无 Ed25519 实现)

11.2 宿主安全错误码(摘要;全表见 plugin-security.md §5.3)

码 触发/修复
ManifestInvalid 清单 JSON 非法/字段类型错:修清单并用 --check 复验
SignatureMissing 宿主要求签名但清单/索引未签:发布流程固定签名环节
SignatureMalformed 缺 alg:/Base64 错/长度非 64B:用工具重新签名,勿手改签名字段
SignatureAlgorithmUnsupported 非 ed25519:使用工具/宿主支持的算法
SignatureInvalid 验签失败(篡改或公钥不对):确认公钥与 key_id/指纹一致
PublicKeyMissing / VerifierUnavailable 宿主未配置公钥/未注入验证器:配置 trusted_keys/set_security_verifier
PublisherNotAllowed 签名通过但 publisher 不在白名单:更新宿主允许列表
PermissionNotDeclared / PermissionDenied 清单缺 permissions 或宿主未 grant:补声明/显式授权
ArtifactMissing 严格策略要求 artifacts 或声明文件缺失:补声明/重新打包
ArtifactHashMismatch 包内容被改/打包不完整:重新 --build-index 并重签,勿手改索引
ArtifactPathInvalid 路径逃逸:包内使用相对路径
UnknownKeyId key_id 不在 trusted_keys:先分发公钥再发布索引
RevokedKey key_id 已吊销(宿主策略/--revoked-keys):轮换新 key 重新签名并发布

11.3 典型现象 → 原因

现象 原因/解决
--check 报 plugin library not found 对源码目录执行了 --check;改到构建产物 build/plugin/
--check 报 ABI 不兼容 插件清单 ABI major/minor 超出宿主(如 2.0 或 minor 大于宿主);按目标宿主调整声明/构建
--verify-index 退出码 4 索引已签名但没给 --pubkey;或工具未链接 vde_license(用默认全量构建)
--install 退出码 3 提示已存在 目标 <dest>/<id> 已存在:--upgrade 或 --force
--install <url> 退出码 3 远程索引需 --fetch-packages;POSIX 构建不支持 http(s) URL(用本地镜像/file://)
宿主能发现但不能加载 安全策略拒绝(trusted_keys/revoked/publisher/权限)或 ABI/query 不一致;看宿主 last_error
加载崩溃 进程内原生插件无崩溃隔离;按 §10 改进程外服务/加隔离

12. 发布检查清单

[ ] 用 scaffold 模板/独立构建,目标 SDK 版本与目标宿主 ABI 匹配;0 warning 目标可选
[ ] --check 通过(对构建产物目录);--list 可发现;--abi 记录宿主基线
[ ] 包内容仅 manifest + 动态库 + 必要数据;无 build 中间产物/调试符号/私钥
[ ] 清单 artifacts 完整;--build-index 后 --verify-index --pubkey 通过
[ ] 负例回归:篡改 artifact/索引/ABI/路径逃逸/unsigned 均失败(退出码 3/4)
[ ] 公钥指纹/key_id/publisher 写入发布说明;生产私钥离线保管
[ ] 托管:稳定索引 URL + 不可变版本路径 + 旧版本保留;HTTP(S) 获取仅 Windows 工具支持(跨平台用离线镜像)
[ ] 宿主安装:--fetch-index/--install/--upgrade 在干净目录验证;PluginManager scan/load/调用/unload
[ ] 宿主安全策略:require_signature/require_artifact_hashes/trusted_keys/revoked_key_ids/权限
[ ] 回滚演练:旧索引/旧版本 --upgrade --version 可回退;吊销 key 后旧索引被拒
[ ] 吊销:生成签名 CRL(--sign-crl)并发布稳定 URL/文件;宿主以 --crl + --crl-pubkey 验证,
    CRL 在有效期内(过期/篡改 → 退出码 3,不可获取 → 4)
[ ] CI:插件仓库使用 [plugin-ci-template.md](plugin-ci-template.md) 的 build/check/sign/verify 流水线

13. Authenticode 签名规划(Windows;方案,未实施)

背景与威胁模型:当前 Ed25519 清单/索引签名证明“发布者自签 + 内容未被篡改”,但 不参与 OS 加载器信任链,也不防“重新打包的恶意 DLL 携带自签清单”。Windows 宿主可用 Authenticode(signtool + 代码签名证书)提升用户/企业环境信任。

规划(P4 后续;当前环境无 signtool/证书,仅文档方案):

  • 签名对象:插件 DLL(每个发布版本)、vde_plugin_tool、宿主安装器;清单/索引继续用 Ed25519(跨平台一致),Authenticode 作为 Windows 附加层;
  • 证书:OV/EV Code Signing 证书;私钥放 HSM/离线签名机;使用 RFC3161 时间戳,签名后 signtool verify /pa /all 自检;
  • 发布流程:构建 → Ed25519 清单/索引签名(现有)→ signtool sign /tr <ts> /td sha256 /fd sha256 签 DLL/工具 → --build-index 的 artifact SHA-256 覆盖签名后的二进制 → 发布说明记录 证书 SHA-256 指纹与时间戳;
  • 宿主校验(可选):Windows 宿主可在加载前 WinVerifyTrust + 证书指纹白名单; 与 §4.8 CRL 互补:CRL 吊销 VDE key_id,Authenticode 吊销由 Windows 信任链/时间戳负责;
  • 限制:MinGW 工具链无 signtool;需 Windows 发布机或自备 runner;本轮未实现/未验证; 不覆盖已 root 宿主或内核级攻击;Linux/macOS 继续使用 Ed25519 + 后续平台方案。

14. 相关文档

  • 插件开发指南:ABI/扩展点/模板/--check/scaffold/进程外服务;
  • 插件分发指南:索引 schema v1/签名规范/命令/退出码/信任模型/升级回滚;
  • 插件安全设计:威胁模型/策略/错误码/密钥轮换/TOCTOU 限制;
  • 插件 CI 模板:GitHub Actions 片段与 ABI 1.0–1.3 兼容矩阵;
  • 架构与插件路线图:P3-12/P3-13 状态;
  • 模板:plugins/templates/、plugins/sample_vbox、plugins/sample_gcs;
  • 工具:tools/vde_plugin_tool/main.cpp(命令/退出码权威实现)。