Files
admin 0326311888 feat(tee): KBS 从 stub 变为真判定,打通「先验证明,才给密钥」闭环
密钥下发从「问就给」改成「先出证明,才给密钥」:

- 新增 crates/mpc-tee/src/bundle.rs:唯一的证明判定实现,判定五关
  全部 fail-closed(平台一致+布局解析 / 重算绑定值挡重放 / 度量 pin /
  TCB 门槛 / 芯片签名)。验证方与放行方共用同一份,口径不分叉。
- 新增 crates/mpc-tee/src/collect.rs:guest 内从芯片驱动采真报告
  (CSV ioctl 0xC0104401;SNP 证书链需单独 ioctl,显式 Unsupported)。
- 新增 crates/mpc-core/src/sm3.rs:CSV launch 度量与挑战哈希用。
- deploy/tee/kbs/serve.py:新增 /kbs/v0/attestation,判定调
  `mpc tee attest-check`(Rust),Python 只搬字节看退出码。
  严格模式默认开,缺判定器或缺验签器一律拒发。
- guest/init.sh:去掉 offline-demo 兜底,改「采集证明 → POST 换 token
  → 凭 token 取钥」。
- 新增 CLI 子命令 tee attest-collect/attest-check/attest-mkbundle/attest-post。

修掉多个真 bug:

- GNU coreutils `tee` 把非选项参数当文件名创建且成功退出,判定退化成
  「不报错就算过」就是假绿 → KBS 加五道闸(判定器校验 / 独立工作目录 /
  stdin=DEVNULL / 超时上限 / 输出必须是含 ok+verdict 的判定结论)。
- Rust TcpStream::connect 无超时,对端不可达时挂 ~130s,guest 表现为
  卡死 → 新增 connect_with_timeout(10s)。
- guest 显式等 carrier 就绪(LOWER_UP),消除 attest-post 偶发超时。
- tap 名两处各记一份导致「配置全对但连不上」→ 统一兜底。
- iproute2 接口名上限 15 字符,超长报误导性的 policy validation → 预检。
- argparse 吞「以 - 开头的值」→ 证书链目录改用独立选项 --chain-dir。
- 跨目标编译盲区:#[cfg(target_os="linux")] 代码在宿主目标被整段排除,
  宿主零告警但交叉编译出告警 → CI 新增跨目标零告警闸门。
- lint-shell-vars.py 只扫 deploy/tee,对 tools/ci.sh 自身无感 → 扩到
  tools;并跳过纯注释行(shell 不解析注释,对教学示例持续误报会让人
  习惯性忽略闸门输出 = 假绿的温床)。

真机(海光 CSV 192.168.1.102):正向 7/7 全绿,负向 6/6 全部 fail-closed。
CI 扩到九条,全部通过。
2026-11-07 08:46:24 +08:00

149 lines
5.0 KiB
Bash
Executable File
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/usr/bin/env bash
# 在 **ash** 上校验 guest 脚本的语法(本机可跑,不需要真机)。
#
# 为什么必须有这道闸门
# ------------------
# guest 的 `/init` 由 **busybox ash** 解析(脚本头 `#!/bin/busybox sh`),
# 而宿主上 `bash -n` 通过 ≠ ash 能解析。真机实测踩到过:
#
# /init: line 175: syntax error: unexpected "do" (expecting ")")
#
# 起因是 POSIX sh **不允许复合命令(while/for)作为管道元素** ——
# bash 宽容地接受了 `$((... | while read; do ... done))`,ash 直接语法错。
# 而这类错误只有等 guest 起来才暴露,排查一轮要几分钟。
#
# 本脚本与 `deploy/tee/real-machine/guest-syntax-check.sh` 的分工:
# · 本脚本:校验**仓库里的源文件**,本机跑,进 CI(秒级)。
# · 那个脚本:校验**打包进 initrd 的那份**(解包后用真机的 musl loader
# 跑真机的 busybox),需要 initrd + 真机。
# 两个都要有:源文件过了不代表打包进去的那份过。
#
# 用法:
# deploy/tee/guest/syntax-check.sh # 校验仓库里的 guest 脚本
# deploy/tee/guest/syntax-check.sh <文件> # 校验指定文件
#
# 退出码:0 = 语法 OK(若没有可用解析器,也返回 0 但明确打印 SKIP)。
set -u
HERE=$(cd "$(dirname "$0")" && pwd)
REPO=$(cd "$HERE/../../.." && pwd)
# ★ 本脚本是**宿主侧**闸门(由 bash 执行),不是 guest 脚本。
# 它放在 guest 目录里只是为了跟被检查的文件待在一起 ——
# 但它用的是 bash 数组语法,ash 解析不了。所以:
# ① 默认不检查自己;
# ② 下面刻意用 POSIX 写法(不用数组),这样万一有人手工喂给 ash
# 也能解析 —— 闸门自己过不了自己的闸门,是很难受的。
SELF=$(basename "$0")
# 用 POSIX 的方式收参数(不用 `set --` 破坏原参数,改为逐个处理)。
DEFAULT_LIST=0
if [ $# -eq 0 ]; then
DEFAULT_LIST=1
fi
TARGET_COUNT=0
for a in "$@"; do
TARGET_COUNT=$((TARGET_COUNT + 1))
done
# 找一个能当 ash 用的解析器。
# 优先级:
# 1. 本机 busybox(有 ash applet,且是**真 ash**)
# 2. docker 里的 alpine busybox ash(最接近 guest 环境)
# 3. dash —— 近似替身:比 bash 严格,能暴露大部分 POSIX 违规,
# 但**不等于** ash,不能当最终结论(所以只做兜底并标注)。
find_checker() {
if command -v busybox >/dev/null 2>&1; then
echo "busybox"
return 0
fi
if command -v docker >/dev/null 2>&1; then
echo "docker"
return 0
fi
if [ -x /bin/dash ]; then
echo "dash"
return 0
fi
return 1
}
CHECKER=$(find_checker) || {
echo "GUEST_SYNTAX_SKIP: 本机没有 busybox / docker / dash,跳过(不是 OK)"
exit 0
}
echo "解析器: $CHECKER"
RC=0
check_one() {
f=$1
base=$(basename "$f")
case "$CHECKER" in
busybox)
if busybox ash -n "$f"; then
echo " [ok] $base"
else
echo " [FAIL] $base: ash 语法错误"
RC=1
fi
;;
docker)
# 用 alpine 的 busybox ash —— 与 guest 内同一个解析器家族。
# 注意:镜像拉取可能没网;拉不到就降级到 dash 并明确标注,
# **不能**因为拉不到镜像就报 OK(那是假绿)。
if docker image inspect alpine:3.19 >/dev/null 2>&1 || \
docker pull -q alpine:3.19 >/dev/null 2>&1; then
if docker run --rm -v "$f:/t.sh:ro" alpine:3.19 \
busybox ash -n /t.sh; then
echo " [ok] $base"
else
echo " [FAIL] $base: ash 语法错误"
RC=1
fi
else
echo " [WARN] $base: 无法取得 alpine 镜像,退到 dash(近似,非 ash)"
if /bin/dash -n "$f"; then
echo " [ok*] $base (dash 近似通过,ash 未验证)"
else
echo " [FAIL] $base: dash 语法错误"
RC=1
fi
fi
;;
dash)
if /bin/dash -n "$f"; then
echo " [ok*] $base (dash 近似通过,ash 未验证)"
else
echo " [FAIL] $base: dash 语法错误"
RC=1
fi
;;
esac
}
if [ "$DEFAULT_LIST" -eq 1 ]; then
for f in "$HERE"/*.sh; do
[ -f "$f" ] || continue
base=$(basename "$f")
# 本脚本自己跳过(宿主侧 bash 脚本,见上文说明)。
if [ "$base" = "$SELF" ]; then
continue
fi
check_one "$f"
done
else
for f in "$@"; do
[ -f "$f" ] || continue
check_one "$f"
done
fi
if [ "$RC" -eq 0 ]; then
echo "GUEST_SYNTAX_OK: guest 脚本语法检查通过"
else
echo "GUEST_SYNTAX_FAIL: guest 脚本存在语法错误"
fi
exit "$RC"