Files
ssw 60b6fa6f7b vault: 设备绑定密钥 + 密封存储(宿主 16 用例 / QEMU VAULT_ALL_OK / 签名验收通过)
- src/vault-core: no_std 密码学核心(HKDF 派生、AES-256-GCM、两条水位线防回滚)
- src/ta-vault / src/ca-vault: TA 薄壳与 selftest 客户端
- build/p1_vault_qemu.sh: QEMU 全链,判据 VAULT_ALL_OK
- build/p2_ta_keys_qemu.sh: TA 公钥编进 tee.bin,默认密钥签的被拒
- build/gen_ta_keys.sh: 自建签名密钥
- docs/07-VAULT-TA.md: 设计 + 已验证/未验证清单
- CLAUDE.md 雷区 11-16:user_ta_header、嵌套 workspace、ARCH=arm、SIGPIPE、TA_PUBLIC_KEY、heredoc 变量
2026-10-28 14:37:04 +08:00

185 lines
8.9 KiB
Markdown
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.
# op-tee-test
Zynq-7015(ACZ7015,双核 Cortex-A9 / armv7)上跑 **OP-TEE 4.11 + Rust 写的 TA** 的完整工作集:
构建脚本、沙箱编排、实测日志、预编译产物,以及**板子上的后续动作清单**。
打包时间:2026-10-28 · 来源工程:`~/WorkBuddy/2026-10-26-13-43-18`
---
## 一句话现状
| | 状态 |
|---|---|
| **QEMU(arm32)全链** | ✅ **已跑通**。Rust CA → `/dev/tee0` → SMC → OP-TEE 4.11 → **Rust TA 执行并返回** |
| **真板(Zynq-7015)** | ❌ 未开始。`tee.bin` 已编出,剩下是 FSBL/内存/内核/DT 的板级活 |
| **vault(设备绑定密钥 + 密封存储)** | ✅ 宿主 16 用例 + QEMU `VAULT_ALL_OK` + 签名验收(默认密钥签的 TA 被拒),见 `docs/07` |
QEMU 上的成功证据(`logs/p0-nw.log`):
```
optee: revision 4.11 (f54190f2)
optee: initialized driver
crw------- 1 0 0 250, 0 /dev/tee0
crw------- 1 0 0 250, 16 /dev/teepriv0
--- run CA ---
INC_VALUE: 41 -> 42
ALL OK
CA_RC=0
```
安全世界侧(`logs/p0-sw.log`):
```
I/TC: OP-TEE version: 4.11.0 (gcc 12.2.0) #1 ... arm
I/TC: Primary CPU switching to normal world boot
```
> 验证用的是 **armv7**,和目标板同架构 —— 不是拿 aarch64 糊过去的。
---
## 目录
```
op-tee-test/
├── README.md ← 本文件
├── CLAUDE.md ← 给 AI 编码助手的项目约定(怎么改、别踩什么)
├── docs/
│ ├── 01-HANDOFF.md 交接文档:目标/前置/阶段划分/Rust 侧要点
│ ├── 02-P0-RESULTS.md ★ QEMU 实测全过程,含两个「根因级」坑与纠正
│ ├── 03-TRUST-CHAIN.md Zynq 八层启动信任链 + eFuse 位定义 + 优化排序
│ ├── 04-PL-ENCLAVE.md PL 安全岛设计(PS 不可见内存 / AXI-NS 校验 / 寄存器映射)
│ ├── 05-BOARD-ACTIONS.md ★★ 上板动作清单(P1→P5、验收、回滚)
│ ├── 06-QSPI-UPDATE-LOOP.md QSPI 安全更新闭环 + eFuse 烧写 Runbook
│ └── 07-VAULT-TA.md ★ 设备绑定密钥 + 密封存储(core/TA/CA 三层,QEMU 已验证)
├── build/
│ ├── p0_qemu_arm32.sh ★ 一键:空容器 → 看到 INC_VALUE(203 行,已验证)
│ ├── p1_vault_qemu.sh ★ 一键:vault TA 全链 → VAULT_ALL_OK(已验证)
│ ├── p2_ta_keys_qemu.sh ★ 一键:TA 签名公钥进 tee.bin → 默认密钥签的被拒
│ ├── build_ta_ca.sh TA+CA 单独编译签名(本地容器版,参数化)
│ ├── build_vault.sh 编 vault TA/CA,支持 board / VAULT_SIM_DEV
│ ├── gen_ta_keys.sh 生成自己的 TA 签名密钥(公钥编进 tee.bin)
│ ├── vault_selftest_host.sh 宿主验证:纯 Rust,两秒,不需要板子/QEMU
│ ├── steps/s1..s5 分步脚本,就是本次实际执行顺序(排错用这个)
│ └── sandbox/csbx.py CubeSandbox 托管(创建/复用/后台跑/收发文件)
├── src/
│ ├── ta/ Rust TA(no_std,CMD_INC_VALUE / CMD_ECHO)— P0 基线
│ ├── ca/ Rust CA(libteec)— P0 基线
│ ├── vault-core/ ★ no_std 密码学核心:HKDF 派生 / AES-GCM 密封 / 防回滚
│ ├── ta-vault/ ★ vault TA(薄壳:参数/随机数/secure storage/DNA)
│ ├── ca-vault/ ★ vault CA(provision/seal/unseal/rotate/selftest)
│ ├── c-skeleton/ C 版 TA/CA 对照骨架(想用 C 写就从这开始)
│ └── pl_enclave_regs.h PL 安全岛寄存器/命令字定义(RTL 与驱动共用)
├── logs/
│ ├── p0-nw.log 正常世界串口(成功)
│ ├── p0-sw.log 安全世界串口(成功)
│ ├── vault-nw.log ★ vault 全链:VAULT_ALL_OK
│ ├── vault-sw.log ★ 同上,安全世界侧
│ └── fail-bl32-silent.log 修复前:「BL32 后静默」的真实现象,留作对照
└── artifacts/
├── tee-zynq7k.bin OP-TEE OS,PLATFORM=zynq7k(391 KB)
├── hello_rust.ta Rust TA,已 RSA-PSS-SHA256 签名 + verify 通过
├── hello_ca Rust CA(ELF32 ARM)
├── libteec.so.2.0.0 armhf
├── tee-supplicant armhf
├── SHA256SUMS 上面几个产物的校验和
└── vault/
├── syvault.ta ★ vault TA(armv7,开发密钥签名)
├── syvault_ca ★ vault CA(armhf)
└── SHA256SUMS
```
全部都是 **ELF32 / ARM**(`hello_rust.ta` 是被签名的容器,`file` 显示 `data` 属正常)。
---
## 怎么跑(QEMU,约 15 分钟)
### 路线 A:沙箱(推荐,16 核 / 16G,不受本机 I/O 拖累)
```bash
cd build/sandbox
PY=/path/to/python3 # 需要 pip install cubesandbox
$PY csbx.py up # 创建(token 会落到 /tmp/cube_sbx.json)
$PY csbx.py put ../p0_qemu_arm32.sh /root/p0.sh
$PY csbx.py bg p0 'bash /root/p0.sh' 1800
$PY csbx.py log p0 80
$PY csbx.py down # 用完销毁
```
服务端地址与默认模板写在 `csbx.py` 顶部(`CUBE_API_URL` 等),按环境改。
### 路线 B:任意 Linux x86_64(含 WSL / 云主机)
```bash
bash build/p0_qemu_arm32.sh 2>&1 | tee build.log
# 判据:最后打印 PASS: Rust TA 在安全世界被调用并返回
```
脚本自带:装依赖 → 拉 6 个源码 → 编 optee_os/u-boot/ATF → 编内核(开 OPTEE)→
编 Rust TA/CA 并签名 → 拼 armhf rootfs → 生成带 optee 节点的 DTB → 跑 QEMU → 判 PASS。
> 本机(2015 i5 / 4 核 / 2.5G 容器)跑不动:**光解压内核就要 25 分钟**。
> 别在这类机器上死磕,换台像样的。
---
## 五条「不改就会再踩」的硬约束
1. **OP-TEE 的 console 走 secure UART = 第二个 `-serial`**
官方 `qemu.mk` 一直是 `-serial tcp:NW -serial tcp:SW` 两条。只用 `-nographic`(只接 serial0)
会看到 `BL1: Booting BL32` 之后**永久静默**,让人误判「BL32 挂了 / 上游已 bit-rot」。
→ 正确做法:`-serial file:nw.log -serial file:sw.log` 分开落盘。
2. **DT 的 optee 节点必须带 `interrupts`**
OP-TEE 4.x 默认开 async notif,Linux 驱动因此强制要求中断。缺了就是
`optee: error -ENXIO: IRQ index 0 not found`,`/dev/tee0` 不出现。**板子上同理。**
3. **平台名是 `PLATFORM=zynq7k`**,不是 `zynq`(后者报 `plat-zynq/sub.mk: No such file`)。
4. **Rust 工具链版本以 SDK 的 `rust-toolchain.toml` 为准**(当前 `nightly-2026-08-05`)。
网上文档写的 2024-05 已过时,会报 `feature edition2024 is required`。
另外 SDK 自带的 `cargo-optee` 工具本身编不过,**直接用 `cargo build`**,然后手工补 `dyn_list`。
5. **构建机上的 `python3` 必须是系统 python3**(带 `cryptography` / `pyelftools`)。
很多镜像 `/usr/local/bin/python3` 是另一个,会报 `ModuleNotFoundError: cryptography`。
→ `PYTHON3=/usr/bin/python3`。
---
## vault:密钥托管,不用等板子
```sh
bash build/vault_selftest_host.sh # 2 秒:16 个用例 + 「两台设备互相解不开」
SRC=/root/src bash build/p1_vault_qemu.sh # 15 分钟:QEMU 全链 → VAULT_ALL_OK
```
做的事:`K_device = HKDF(K_root, Device DNA ‖ USER eFuse)`,AES-256-GCM 密封,
`K_root` 只在 TA 内存与 secure storage 里出现;普通世界拿到的只有 blob,且旧 blob 会被判回滚。
它**不解决**内核被替换(L3)—— 换掉 `zImage` 的攻击者仍能调用 TA 的合法接口。
详见 `docs/07-VAULT-TA.md`(含"已验证 / 未验证"清单)。
## 从哪开始做板子
先读 **`docs/05-BOARD-ACTIONS.md`**,按 §0 把六个先决条件过一遍。最关键的两条:
- **内核源码 + DTS 拿不拿得到?** 拿不到就做不了(开 OP-TEE 必须重编内核)。
- **用哪块板?** `.233` 是生产网关(别碰),`.234` 的 SD 卡已坏(先换卡)。
然后按 P1(OP-TEE 起来)→ P2(内存划分)→ P3(内核+用户态)→ P4(Rust TA)→ P5(DEK 下沉)推进。
**Zynq 上没有 ATF**:A9 无虚拟化扩展,OP-TEE 自己就是 secure monitor,跑 Monitor 模式。
QEMU 那套 ATF(BL1/BL2/BL31) + BL32 的启动链**不能照搬**。
---
## 注意
- `artifacts/` 里的 TA/CA 是 **armv7 + 开发签名**,只能用于验证;量产换自己的密钥,
且要把 TA 签名公钥编进 `tee.bin`,否则攻击者可以换 TA。
- 令牌/凭据不落盘:`csbx.py` 把 sandbox token 写到 `/tmp/cube_sbx.json`,用完 `down` 即删。
- 三个 eFuse 位(`AES_ONLY` bit8 / `BBRAM_KEY_DISABLE` bit10 / `JTAG_DIS` bit9)**不可逆**,
顺序在 `docs/06` 里;**`JTAG_DIS` 必须最后烧**,否则 PL eFuse 永久改不了。