Files
admin 260e67e700 feat(tee): 两台真机实证落库,挖出并修复 CSV 验签两个真 bug
海光 192.168.1.102 (CSV) 与 AMD 192.168.1.7 (SNP) 真机实测结论:

- 海光官方 SM2 签名不覆盖报告 MAC 字段(篡改末字节仍 verify success)
- 海光官方验签器缺证书时联网 curl cert.hygon.cn 补链,
  即「我们提供的信任材料」未参与链验证 —— wrapper 改为强制 unshare -rn 断网
  + 本地前置校验关键证书齐全,缺任一即 fail-closed 拒
- AMD SNP 当前 HEAD 五关闭环跑通(正向 attest/kbs/key 全通,负向四类全拒)
- 跨平台 user_data 上半段逐字节相同,验证方须用同一 node 描述重算
- TCB 关必须单独可达:--tcb 实际值 / --min-tcb 门槛不得混用

新增/变更:
- csv-verify-attestation.sh:断网隔离 + 本地链完整性前置校验
- kbs-up.sh:全部参数外部优先、网段/TCB 同源自检
- selftest-csv-verify.py:零依赖 18 条 + 真机闭环 10 条(Py3.6 兼容)
- selftest-kbs-up.py:17 条参数与自检判据
- fixtures/csv/:真实报告与公开信任材料(无私钥)
- docs/REAL_MACHINE_FINDINGS.md:真机硬事实专档

主门禁仍 18 条,EXIT=0 全绿(第 10 条纳入 CSV 与 KBS 参数自测)。
2026-11-07 21:06:27 +08:00

311 lines
14 KiB
Python
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 python3
"""CSV 芯片验签器自测(正负向)。
测的是 `deploy/tee/real-machine/csv-verify-attestation.sh` 的**判定**是否 fail-closed。
★ 为什么要有这一条(2026-11-07 真机探索补上)
SNP 侧早有 `selftest-snp-verify.py`,CSV 侧却一直没有 —— 缺口。
真机(海光 192.168.1.102)实测发现:**官方验签器只验 SM2 签名与证书链,
不验报告里的 MAC 字段**。实测把 MAC 最后一字节翻转后,官方验签器输出与
原报告**逐字节相同**,仍然 `verify success`。所以:
- 「MAC 被验过了」是**错的**说法;
- wrapper 里那条 `attestation report MAC verify failed` 判据**永远不会命中**,
留着只会让人误以为 MAC 有保护。
本自测把这条边界**钉成判据**:MAC 不在签名覆盖内(已知事实),
但签名/会话字段被篡改**必须**被拒(真正的 fail-closed 底线)。
★ 两种运行模式(与 SNP 自测的差别在这里)
CSV 的真实验签依赖**海光官方二进制**
(/opt/hygon/csv/attestation/verify-attestation),只在真机上存在。
所以:
- `--self-test`:**零依赖**,只跑判据逻辑 / fixture 完整性 / wrapper 契约,
在每台机器(含 CI)都执行到 —— 缺官方二进制也不能变成盲区;
- 默认(真机模式):额外跑真官方验签器的正负向,需要真机环境。
★ 缺官方二进制时真机模式必须显式 SKIPPED,不许静默通过。
★ 用的是真数据
fixture 是从海光真机(192.168.1.102,Hygon C86 7255)采集的**真实** CSV
报告(2548 字节)与海光官方公开证书链(hrk/hsk/hsk_cek/cek/oca/pek,
**不含私钥**)。
用法:
python3 deploy/tee/real-machine/selftest-csv-verify.py --self-test # 零依赖
python3 deploy/tee/real-machine/selftest-csv-verify.py # 真机闭环
"""
import os
import shutil
import subprocess
import sys
import tempfile
HERE = os.path.dirname(os.path.abspath(__file__))
REPO = os.path.abspath(os.path.join(HERE, "..", "..", ".."))
VERIFIER = os.path.join(HERE, "csv-verify-attestation.sh")
FIXTURE = os.path.join(HERE, "fixtures", "csv")
CHAIN = os.path.join(FIXTURE, "chain")
REPORT = os.path.join(FIXTURE, "report.cert")
OFFICIAL_BIN = os.environ.get(
"MPC_CSV_VERIFY_BIN", "/opt/hygon/csv/attestation/verify-attestation")
# CSV 报告布局(sizeof(struct csv_attestation_report) = 2548)
OFF_USER_DATA = 0x0040
OFF_MEASURE = 0x0090
OFF_SIG1 = 0x00C0
OFF_MAC = 0x09D4
FAILED = 0
PASSED = 0
def check(name, ok, detail=""):
global FAILED, PASSED
if ok:
PASSED += 1
print(f" [ok] {name}")
else:
FAILED = 1
print(f" [FAIL] {name} {detail}")
def run_verifier(report_path, chain_dir=CHAIN, extra=None):
cmd = [
VERIFIER,
"--report", report_path,
"--chain-dir", chain_dir,
"--verifier", "selftest-csv",
]
if extra:
cmd.extend(extra)
# ★ 不用 capture_output / text=:那是 Python 3.7+ 的写法,
# 真机(海光 192.168.1.102)的系统 python3 是 **3.6**,
# 用 3.7+ 语法会让整条真机闭环在 TypeError 里崩掉(连 SKIPPED 都报不出来)。
p = subprocess.run(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE,
universal_newlines=True)
return p.returncode, p.stdout, p.stderr
def tamper(src, dst, offset, xor=0x01):
data = bytearray(open(src, "rb").read())
data[offset] ^= xor
open(dst, "wb").write(bytes(data))
return dst
def rejected(rc, out):
"""fail-closed 的判定:非 0 退出,且**没有**通过标志。"""
return rc != 0 and "verified=true" not in out
def py36_ok():
"""用 AST 检查 subprocess 调用有没有用 3.7+ 才有的参数。
★ 不能用字符串搜索判据自己:注释里写着 `capture_output`,
字符串搜索会命中自己的注释 → 判据自指 → 永远 FAIL(真踩过)。
★ 只看**关键字参数**,不看位置参数,也不看注释/字符串常量。
"""
import ast
with open(os.path.abspath(__file__), encoding="utf-8") as f:
tree = ast.parse(f.read(), filename=__file__)
banned = {"capture_output", "text"} # text= 是 3.7+ 的别名
for node in ast.walk(tree):
if not isinstance(node, ast.Call):
continue
func = node.func
if not (isinstance(func, ast.Attribute) and func.attr == "run"):
continue
for kw in node.keywords:
if kw.arg in banned:
return False
return True
def self_test():
"""零依赖判据逻辑自测:不碰官方二进制也能跑。"""
print("== CSV 验签器判据逻辑自测(零依赖) ==")
check("验签器脚本存在", os.path.exists(VERIFIER), VERIFIER)
check("fixture 报告存在", os.path.exists(REPORT), REPORT)
check("fixture 证书链存在(hrk/hsk_cek/cek/oca/pek)",
all(os.path.exists(os.path.join(CHAIN, c))
for c in ("hrk.cert", "hsk_cek.cert", "cek.cert", "oca.cert", "pek.cert")),
CHAIN)
size = os.path.getsize(REPORT) if os.path.exists(REPORT) else -1
check(f"fixture 报告长度 = 2548(实际 {size})", size == 2548, f"size={size}")
# fixture 里不能有私钥(仓库里只允许公开信任材料)
priv = []
for root, _, files in os.walk(CHAIN):
for fn in files:
with open(os.path.join(root, fn), "rb") as f:
blob = f.read()
if b"PRIVATE KEY" in blob:
priv.append(fn)
check("★ fixture 证书链不含私钥", not priv, priv)
with open(VERIFIER, encoding="utf-8") as f:
vsrc = f.read()
# ★ 核心边界判据:wrapper 不得把 MAC 说成已验证
check("★ wrapper 文档写明 MAC **不被验证**(不是「MAC 完整性校验失败」这类断言)",
"MAC 完整性校验失败" not in vsrc
and "不覆盖 MAC" in vsrc,
"wrapper 仍在声称验了 MAC —— 那是永不命中的死判据,会造成虚假安全感")
check("★ wrapper 的 MAC 失败分支被标注为「条件性兜底」而非证据",
"条件性兜底" in vsrc and "不可据此宣称 MAC 已被验证" in vsrc)
# wrapper 必须 fail-closed 的失败标志
for flag in ("verify report fail", "SM2_do_verify fail",
"validata cert chain failed"):
check(f"wrapper 认官方失败标志:{flag}", flag in vsrc)
check("wrapper 缺官方成功结论时 fail-closed(不静默通过)",
"官方验签器输出无明确结论(fail-closed)" in vsrc)
check("wrapper 强制报告长度 2548(截断必拒)",
"EXPECT_LEN" in vsrc and "2548" in vsrc)
# ★ 链校验必须断网(真机实测:官方工具缺证书会联网下载,链约束会失效)
check("★ wrapper 链校验模式强制断网(unshare -rn)",
"unshare -rn" in vsrc and "NETNS_CMD" in vsrc,
"没有网络隔离 = 官方工具会联网补证书链,我们的信任材料形同虚设")
check("★ wrapper 缺 unshare 时 fail-closed(不退回联网模式)",
"unshare -rn 不可用" in vsrc or "缺少 unshare" in vsrc)
check("★ wrapper 缺关键证书时本地就拒(不等官方联网兜底)",
"离线证书链缺" in vsrc and "证书链目录不存在" in vsrc)
# 自测脚本本身的自检:不能有「未知参数」类假绿
with open(os.path.abspath(__file__), encoding="utf-8") as f:
ssrc = f.read()
check("★ 自测用列表参数(不靠 shell 分词)", "subprocess.run(cmd" in ssrc)
# ★ Python 版本兼容:真机(海光 192.168.1.102)系统 python3 是 **3.6**,
# capture_output / text= 是 3.7+ 才有的参数。真踩过:整条真机闭环
# 在 TypeError 里崩掉,连 SKIPPED 结论都报不出来(崩 ≠ 跳过)。
# ★ 必须用 **AST** 查,不能用字符串搜索:注释里提到这些参数名,
# 字符串搜索会命中自己的注释 → 判据自指 → 永远 FAIL。
check("★ 子进程调用兼容 Python 3.6(真机系统 python3 版本)",
py36_ok(),
"用了 3.7+ 的 subprocess 参数,真机上会 TypeError 崩掉而不是跑判据")
# 真机模式必备的 SKIPPED 语义
check("★ 缺官方二进制时显式 SKIPPED(不许静默通过)",
"CSV_VERIFY_SKIPPED" in ssrc)
total = PASSED + FAILED
print(f"\n判据逻辑自测 {total} 条:通过 {PASSED},失败 {1 if FAILED else 0}")
if FAILED:
print("存在失败判据")
return 1
print("判据逻辑全部通过(本模式不依赖海光官方验签器是否安装)")
return 0
def real_test():
print("== CSV 芯片验签器真机闭环 ==")
if not os.path.exists(OFFICIAL_BIN):
print(f"CSV_VERIFY_SKIPPED: 缺海光官方验签器 {OFFICIAL_BIN},真闭环未执行")
print(" (--self-test 的零依赖判据仍在主门禁里跑,不因跳过变成盲区)")
return 0
if not os.path.exists(REPORT):
print(f"CSV_VERIFY_SKIPPED: 缺 fixture {REPORT}", file=sys.stderr)
return 0
with tempfile.TemporaryDirectory(prefix="mpc-csv-selftest-") as td:
# ---------- 正向 ----------
rc, out, err = run_verifier(REPORT)
check("真报告 + 真证书链 → 判通过", rc == 0 and "verified=true" in out,
f"rc={rc} out={out.strip()!r} err={err.strip()[:200]!r}")
check("结论点名 verifier 与链状态",
"verifier=selftest-csv" in out and "chain=on" in out, out.strip())
# ---------- 负向:签名覆盖范围内的字段被篡改必须拒 ----------
p = tamper(REPORT, os.path.join(td, "ud.cert"), OFF_USER_DATA)
rc, out, err = run_verifier(p)
check("★ 篡改 user_data → 拒", rejected(rc, out),
f"rc={rc} out={out.strip()!r}")
p = tamper(REPORT, os.path.join(td, "measure.cert"), OFF_MEASURE)
rc, out, err = run_verifier(p)
check("★ 篡改 measure → 拒", rejected(rc, out),
f"rc={rc} out={out.strip()!r}")
p = tamper(REPORT, os.path.join(td, "sig.cert"), OFF_SIG1 + 3)
rc, out, err = run_verifier(p)
check("★ 篡改签名 → 拒", rejected(rc, out),
f"rc={rc} out={out.strip()!r}")
# ---------- 负向:报告不完整 ----------
trunc = os.path.join(td, "trunc.cert")
data = open(REPORT, "rb").read()[:2000]
open(trunc, "wb").write(data)
rc, out, err = run_verifier(trunc)
check("★ 截断报告 → 拒(长度不符)", rejected(rc, out),
f"rc={rc} out={out.strip()!r} err={err.strip()[:160]!r}")
# ---------- 负向:缺证书链 ----------
# ★ 真机实测的关键点:官方验签器缺证书时会**联网**从 cert.hygon.cn
# 下载 hrk/hsk_cek,下载成功就报 `validata cert chain successful` ——
# 也就是说链验证结论来自网络,不是我们提供的信任材料。
# wrapper 因此在链校验模式下强制 unshare -rn 断网,并本地前置校验
# 关键证书齐全;缺一个就本地拒(rc≠0)。
empty_chain = os.path.join(td, "emptychain")
os.makedirs(empty_chain, exist_ok=True)
rc, out, err = run_verifier(REPORT, chain_dir=empty_chain)
check("★ 缺证书链 → 拒(本地前置校验,不许联网补链)",
rejected(rc, out),
f"rc={rc} out={out.strip()!r} err={err.strip()[:200]!r}")
# 缺单个关键证书(hrk)也必须拒 —— 这正是「联网补齐」会掩盖的场景
partial = os.path.join(td, "partialchain")
os.makedirs(partial, exist_ok=True)
for c in os.listdir(CHAIN):
if c != "hrk.cert":
shutil.copy(os.path.join(CHAIN, c), partial)
rc, out, err = run_verifier(REPORT, chain_dir=partial)
check("★ 缺 hrk.cert(其余齐全)→ 拒(不许联网补齐后判过)",
rejected(rc, out),
f"rc={rc} out={out.strip()!r} err={err.strip()[:200]!r}")
# ★ 真机上 cert.hygon.cn 是**可达**的(实测 HTTP 200),
# 所以「缺链仍判过」不是因为没网,而是官方工具会去下载。
# wrapper 断网后这条必须仍然拒 —— 这是链约束是否真的生效的判据。
rc, out, err = run_verifier(REPORT, chain_dir=empty_chain)
check("★ 联网可达环境下缺链仍拒(断网约束真实生效,非偶然离线)",
rejected(rc, out),
f"rc={rc} out={out.strip()!r} err={err.strip()[:200]!r}")
# ---------- 已知边界:MAC 不在签名覆盖内 ----------
# 这条**不是**「安全」判据,而是把边界钉住:MAC 被改仍可能通过,
# 因为官方 SM2 验签不覆盖该字段。wrapper 因此不得声称验了 MAC。
p = tamper(REPORT, os.path.join(td, "mac.cert"), OFF_MAC + 31)
rc, out, err = run_verifier(p)
mac_passed = (rc == 0 and "verified=true" in out)
check("★ 已知边界:MAC 不在 SM2 签名覆盖内(篡改 MAC 可能仍通过)",
mac_passed,
f"rc={rc} out={out.strip()!r} —— 若这条变了,说明厂商验签器口径变了,"
f"需要重新评估 MAC 保护假设")
total = PASSED + FAILED
print(f"\nCSV 芯片验签器真机闭环 {total} 条:通过 {PASSED},失败 {1 if FAILED else 0}")
if FAILED:
print("存在失败判据")
return 1
print("全部通过")
print("CSV_VERIFY_OK")
print("MAC_NOT_VERIFIED: 官方 SM2 验签不覆盖报告 MAC 字段,"
"本轮结论不含 MAC 完整性")
return 0
def main():
if not os.path.exists(VERIFIER):
print(f"找不到验签器: {VERIFIER}", file=sys.stderr)
return 2
if "--self-test" in sys.argv:
return self_test()
return real_test()
if __name__ == "__main__":
sys.exit(main())