- 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 变量
12 KiB
QSPI 安全更新闭环:方案评审与烧写 Runbook
前提:用户的设想 = 开
AES_ONLY+ 禁 JTAG → 服务器生产加密 BOOT.bin(含 bitstream)→ SD/USB 刷 QSPI → 闭环。 结论:方向正确,可以成立。但有 3 处必须修正、1 条硬顺序、1 个防不住的漏洞。 依据:AMD 官方 Article 65110 — Zynq-7000 PS and PL eFUSE summary 与 UG585 §32/§33 的位定义,加上本板实测。
一、你说对的三件事
| # | 你的判断 | 评价 |
|---|---|---|
| 1 | 用 eFuse 锁死"只许加密启动" | ✅ 正确,而且这是唯一能封死"明文镜像还能启动"的手段 |
| 2 | 禁 JTAG | ✅ 正确,但要最后烧(见 §三) |
| 3 | 服务器统一生产、介质刷新、形成闭环 | ✅ 正确。密钥不进工程师电脑,是唯一可规模化的做法 |
二、必须修正的三处
2.1 「AES_ONLY」的真实名字与效果
你叫的 AES_ONLY,官方是个"一名三姓"的位,容易在工具里点错:
| 名称体系 | 名字 |
|---|---|
| UG585 / UG470 | eFUSE Secure Boot |
| Vivado | eFUSE_Secure_Boot(bit 8) |
| XilSKey (UG1191) | XSK_EFUSEPL_FORCE_USE_AES_ONLY |
它的实际语义(AMD 65110 原文):
Must boot securely and use the eFUSE key as the AES key source. Non-secure boot of the device is not allowed. If the boot image header doesn't match this setting, a security lockdown will occur.
判定靠镜像头偏移 0x028:
0x028 的值 |
含义 |
|---|---|
0xA5C3C5A3 |
加密镜像,用 eFuse key |
0x3A5C3C5A |
加密镜像,用 BBRAM key |
| 其他 | 明文镜像 |
实测印证:BOOT.ENC-EFUSE.BIN 偏移 0x28 正是 a5c3c5a3,明文版是 00000000。所以这颗镜像确实是"eFuse key 加密",烧 bit 8 后它仍然能启动,而明文版会被 security lockdown。✅ 与你的设想一致。
另外:BBRAM Key Disable 是 bit 10,不是 bit 8——不要混。
2.2 烧 bit 8 只防「启动」,不防「读」
这是我上一轮 P0 的关键区分:
| 问题 | 烧 bit 8 后 |
|---|---|
| 拿明文镜像启动板子 | ✅ 被 security lockdown 拒绝 |
拿明文镜像读出 K_tpm |
❌ 照样能读 |
因为读文件不需要启动。K_tpm 的裸字节就在 SD 卡那两个 BOOT.BIN 里(偏移 645,312 处 KTB1 + 紧随 32 字节高熵)。
所以 bit 8 不能替代另外两件事:
- 清除所有明文成品镜像(SD、样板、共享目录、release、构建机输出);
K_tpm改每机唯一K_device = HKDF(K_seed, Device DNA ‖ eFuse USER)。
做完这两条,就算再漏一份镜像,也只影响那一台。
2.3 「含 bitstream」还不够,L3 的真正断点是 kernel/dtb
你的描述是「加密 boot.bin(含 bitstream)」。但当前启动是:
QSPI: BOOT.bin = FSBL + U-Boot (+KTB1) ← 受保护
↓ U-Boot 执行 uEnv.txt 的 sdboot
SD: fatload system.bit → fpga loadb ← 明文
SD: fatload zImage / system.dtb → bootz ← 不验签
把 bitstream 打进 BOOT.bin 是必须的,但只解决了 bitstream 那一条。zImage + system.dtb 仍然从 SD 的 FAT 分区裸加载、bootz 不验签 ⇒ 换内核依然能拿 K_tpm。
闭环必须包含 kernel/dtb,二选一:
| 方案 | 做法 | 适用 |
|---|---|---|
| A. 全打 BOOT.bin | bootgen 把 kernel/dtb 作为分区加载到固定 DDR 地址,U-Boot 直接 bootz 该地址,不再 fatload |
最彻底;每次升级要刷 QSPI(有 A/B 就不痛) |
| B. FIT 签名(推荐组合用) | kernel+dtb 打成 FIT,mkimage -F 签名,U-Boot 开 CONFIG_FIT_SIGNATURE + required,公钥注入 U-Boot DTB |
升级灵活,不动 QSPI |
建议:bitstream 走 A(不常变),kernel/dtb 走 B(常变更)。两者都必须验签,否则闭环有个缺口。
三、烧写顺序(这是全文最要紧的一节)
3.1 一条硬约束:这块板没有 eFuse 编程 MUX
AMD 65110 明确:用 XilSKey 驱动写 PL eFuse 需要板上有一个外部 MUX 把 MIO 接到 JTAG 引脚。你的 ACZ7015 没有这个设计(教学板不会做)。
⇒ PL eFuse 的所有位,只能通过 Vivado/JTAG 烧。⇒ JTAG_DIS 一旦烧,PL eFuse 永久不可再改。
这一条直接决定了顺序:所有想烧的 PL eFuse 位,必须在 JTAG_DIS 之前全部烧完。
3.2 PL eFuse 控制位清单(AMD 65110 + UG470)
| bit | UG470 名 | Vivado 名 | 作用 | 该不该烧 |
|---|---|---|---|---|
| 8 | eFUSE Secure Boot |
eFUSE_Secure_Boot |
必须加密启动 + 必须用 eFuse key;明文镜像 → security lockdown | ✅ 要烧(这是你要的核心) |
| 9 | JTAG Chain Disable |
命令行 program_hw_devices control_efuse {0200} |
DAP/TAP 永久禁用;任何试图激活 DAP 都会触发 lockdown | ✅ 要烧,但最后 |
| 10 | BBRAM Key Disable |
BBRAM_Key_Disable |
安全启动时必须用 eFuse key(不能退回 BBRAM) | ✅ 建议烧(防"降级到 BBRAM"路径) |
| 1 | AES_Exclusive |
— | 必须断电才能重配;禁止从外部配置接口部分重配 | ⚠️ 慎烧 —— 会影响 PL 加载/重配流程 |
| 5 | W_EN_B_Cntl |
— | 禁止再编程任何 FUSE_CNTL 位 | ⚠️ 这是"熔丝写保护",烧了再也改不了 |
| 2 | W_EN_B_Key_User |
— | 禁止再编程 FUSE_AES / FUSE_USER | ⚠️ 注意:如果以后想用 USER fuses 做 DNA 绑定的盐或单调计数器,烧了就不能加了 |
| 3 | R_EN_B_Key |
— | 禁止编程 + 禁止读 FUSE_AES | 可选(AES key 本来就读不出) |
| 4 | R_EN_B_User |
— | 禁止读 USER fuses | 可选 |
⚠️ 最关键的一条:W_EN_B_Cntl(5) 与 W_EN_B_Key_User(2) 是"写保护位"。它们必须在所有其他位烧完之后才烧。反过来做,就等于把自己的手绑住。
3.3 推荐顺序(每步都要先在一台样机验证)
| 阶段 | 动作 | 立刻验证 | 回退 |
|---|---|---|---|
| 0 | 不烧任何东西。先在现状 eFuse(RSA_EN + AES key 已烧,控制位全 0)上把更新闭环跑通 | 见 §五 验收清单 | 随便改 |
| 1 | 补 kernel/dtb 验签(FIT)+ 删掉 /etc/init.d/xdma 运行时加载 |
换 zImage 必须启动失败 |
可回退 |
| 2 | QSPI 做 A/B + U-Boot 验签后刷新 + 断电测试 | 刷写中断电,能用备用槽启动 | 可回退 |
| 3 | 烧 bit 8 后验证 | 加密镜像正常启动;明文镜像 → lockdown 无输出 | ❌ 不可逆 |
| 4 | 烧 bit 10 | 同上 | ❌ 不可逆 |
| 5 | 烧 bit 9(JTAG_DIS) | Vivado 连不上;串口仍可救 | ❌ 不可逆,救砖通道彻底关闭 |
| 6 | 烧 bit 5 / 2 / 3(写保护) | 熔丝从此不可变 | ❌ 不可逆 |
| 7 | 批量生产 | 逐台烧写 + 记录 + 抽检 | — |
留一台不烧 bit 9 的工程样机,用于日后排查。这是行业惯例,不要省。
四、闭环的五段结构(每段都要有验签点)
① 生产(服务器) 密钥在 HSM/U 盘;产出「唯一一份加密镜像」
↓ 签名+加密后的 BOOT.bin(含 bitstream / 或 + FIT 的 kernel)
② 分发 分发物 = 签名后的 update 包(FIT),不是裸 BOOT.bin
↓
③ 刷新(板子侧) U-Boot 验签 → 校验 payload sha256 → sf erase/write → 回读校验
↓
④ 启动 BootROM 验 FSBL(RSA) → FSBL 验 U-Boot/KTB1 → U-Boot 验 FIT
↓
⑤ 回滚/恢复 A/B 双槽 + multiboot + 单调计数器(防降级)
4.1 刷新这一步交给谁执行?三种做法对比
| 做法 | 优点 | 风险 | 建议 |
|---|---|---|---|
Linux + mtd + flashcp |
脚本好写 | 需要 DT 加 jedec,spi-nor 节点 ⇒ root 获得 QSPI 擦写权;配合 JTAG 禁用,一次误操作 = 变砖无救 |
❌ 不推荐(这也是我上一轮说"别加 spi-nor 节点"的原因) |
U-Boot + sf(验签后写) |
写之前就能验签;不依赖 Linux 权限;断电可回滚 | 必须锁死 U-Boot shell(bootdelay=0,或加口令) |
✅ 推荐 |
| FSBL 里做"按键恢复模式" | 最安全,攻击面最小 | 工作量最大,要改 FSBL | ⚠️ 可作为二期 |
推荐形状:U-Boot 里一个"verify-then-flash"流程
fatload mmc 0 <addr> update.itb # 或从 USB
bootm <addr>#verify # FIT 签名验证(不执行)
(验证通过)sha256 比对 payload
sf probe && sf erase <slot> && sf write <slot>
sf read 回读 → sha256 再比一次
切换 boot slot(写 USER fuse 计数器 / 写到 QSPI 的 slot 表)
4.2 QSPI 布局建议(16 MB)
0x000000 Slot A BOOT.bin(加密+签名,含 FSBL/U-Boot/KTB1/bitstream) ~700 KB
0x100000 Slot B BOOT.bin(同一份,备用/golden) ~700 KB
0x200000 预留(slot 表 / 版本号 / 元数据) ~64 KB
0x210000 其余 14.9 MB:**不要用于存放"备份镜像/升级包"**
- BootROM 的 multiboot 字段指向 Slot B;Slot A 头部校验失败时自动 fallback;
- 注意 BootROM 只在头部校验失败时 fallback,不会因为"镜像能启动但功能坏"而切换 ⇒ 应用层的 A/B 切换逻辑仍要自己做;
- 两份都必须用同一个
K_boot加密(UG585:加密启动时 golden 也必须加密,明文 golden 不被接受)。
4.3 回滚攻击与单调计数器(一个现实约束)
JTAG 禁了、加密强制了,但攻击者还能让你回滚到有漏洞的旧版本。要防必须有序号递增的计数器。这块板没有 eMMC(无 RPMB),可选:
| 载体 | 可行性 | 上限 |
|---|---|---|
| eFuse USER fuses(256 bit,按位当计数器) | ✅ 可用,烧一位 = +1 版本 | 最多 256 次升级,且烧完不可逆 |
| BBRAM + 电池 | 板上无电池 | — |
| PL BRAM | 掉电丢失 | — |
所以:用 USER fuses 做单调计数器是目前唯一现实方案,但要注意:
- 一旦启用,
W_EN_B_Key_User(bit 2) 就不能烧(否则加不了位); - 这就需要接受"USER fuses 保持可写"的风险 —— 或者换一块带 eMMC/RPMB 的板。
五、烧 bit 8/9 之前的验收清单(缺一项就别烧)
- 1. 明文镜像被拒:SD 放明文签名版 + SW1 拨 SD,上电后完全无输出(这一条只能在烧 bit 8 之后验;烧之前先确认加密版能启动)
- 2. 换 kernel 必须失败:SD 的
zImage换成任意别的内核 → U-Boot 拒绝启动(FIT 验签生效) - 3. 换 bitstream 必须失败:把
system.bit换成别的 → PL 不加载 / 启动失败 - 4. 断电恢复:
sf erase进行中直接断电 → 上电后用备用槽起得来 - 5. 坏镜像恢复:主动写入一个"签名有效但内容错"的镜像 → 能自动回滚
- 6. 加密 recovery 已就位:手里有一份加密版可启动镜像(明文版烧 bit 8 后就废了),且已实测能启动
- 7. 密钥托管签字:
ppk.pem/k_boot.nky的 3 份副本、2 个地点、分片保管记录齐全;且做过一次用备份重建镜像的演练 - 8. 明文副本清零:所有介质上的明文成品镜像已清除,清单签字
- 9.
K_device已做 DNA 绑定(否则烧再多位,一张卡泄露仍是全舰队) - 10. U-Boot shell 已锁(
bootdelay=0/ 口令),否则串口能sf erase自毁
六、一句话总结
你的机制成立:eFUSE Secure Boot(bit 8) + JTAG Chain Disable(bit 9) + 服务器统一出加密镜像 + 介质刷新,这是 Zynq 上标准的封闭方案。
但要记住三件事:
- 顺序是
bit8 → bit10 → bit9 → 写保护。因为这块板没有 eFuse MUX,PL 熔丝只能 JTAG 烧,JTAG_DIS 烧完就再也烧不了别的位。 - bit 8 防"用明文镜像启动",不防"从明文镜像里读
K_tpm"。所以「清副本」和「K_tpm每机唯一」两件事不能省。 - 闭环必须含 kernel/dtb 验签,否则 QSPI 锁得再紧,换个
zImage一样拿密钥。
最后一条判断:在 L3(kernel/dtb 验签)补上之前,不要烧 bit 9。因为烧了之后你既挡不住"换内核",又失去了救砖通道——风险全给自己,收益给不了。