NXP Layerscape安全启动：uni_sign工具配置与分离式签名实践

1. 项目概述与安全启动核心价值在嵌入式系统开发尤其是涉及工业控制、网络通信或汽车电子等领域时确保设备从加电那一刻起运行的代码是可信且未被篡改的是构建系统安全基石的首要任务。这就是“安全启动”Secure Boot技术要解决的核心问题。NXP的Layerscape系列处理器作为高性能网络和计算平台的主流选择其内置的信任架构Trust Architecture为实现这一目标提供了硬件级支持。简单来说安全启动就像给设备的启动过程安排了一位铁面无私的“海关官员”每一段想要被加载执行的代码如RCW、U-Boot、Linux内核都必须出示由可信机构即开发者持有的私钥签发的“护照”数字签名只有验证通过才能放行。整个验证链条的起点是一个被预先烧录在芯片一次性可编程OTP熔丝中的“根公钥哈希”SRKH。系统上电后第一段固件如ISBC的签名会使用这个根公钥来验证。如果验证失败芯片将拒绝启动从而将恶意代码挡在门外。而生成这些“护照”——即包含签名和关键信息的“安全启动头文件”——的关键工具就是NXP代码签名工具CST套件中的uni_sign。很多开发者初次接触其配置文件时面对诸如PLATFORM、ESBC、IMAGE_1等数十个字段往往会感到无从下手。本文将结合一个LS2088平台的U-Boot签名实例彻底拆解uni_sign工具的配置逻辑、命令行玩法和背后的安全考量让你不仅能“配出来”更能“弄明白”。2. uni_sign工具核心功能与输入文件深度解析uni_sign工具是CST套件中的多面手它的核心职责是根据你的配置生成一个附加在原始镜像前面的“安全头”CSF Header。这个头里包含了镜像的哈希值、公钥、UID信息以及最重要的——用私钥对前述内容生成的数字签名。BootROM或前一级引导程序会按照预定的格式解析这个头完成验证。2.1 输入文件配置的蓝图所有操作都始于一个文本格式的输入文件例如input_uboot_secure。它定义了签名的所有参数。我们可以将其分为几个逻辑区块来理解。2.1.1 平台与基础标识# Specify the platform. [Mandatory] PLATFORMLS2088PLATFORM是必须指定的字段它告诉工具目标芯片的型号。不同平台的信任架构版本TA1.x, TA2.x, TA3.x和安全启动头的格式有细微差别。例如LS2088属于TA3.xTrust Architecture 3.1而LS1043属于TA2.x。工具会根据平台选择正确的头格式。ENTRY_POINT定义了镜像的入口地址即CPU开始执行该段代码的地址。对于U-Boot这通常是其链接地址如0x30008000。2.1.2 密钥体系信任的根源PUB_KEYsrk.pub KEY_SELECT1 PRI_KEYsrk.pri这是安全启动的核心。PUB_KEY指定用于验证签名的公钥文件PEM格式。这个公钥的哈希值SRKH最终需要被烧录到芯片的SFP熔丝中是建立信任链的绝对锚点。PRI_KEY指定用于生成签名的私钥文件PEM格式。此私钥必须被严格保护最好在离线、隔离的机器上使用。一旦泄露攻击者即可为任意恶意代码签发“合法”签名。KEY_SELECT当使用多个密钥对例如用于密钥轮换或不同开发阶段时此字段指定当前使用哪一对密钥。1表示使用PRI_KEY和PUB_KEY列表中第一个密钥。注意gen_keys脚本生成的默认密钥对通常命名为srk.pri和srk.pub。在实际产品中强烈建议生成并使用自己独有的密钥对而非示例中的默认密钥。2.1.3 镜像定义签什么放哪里IMAGE_1{u-boot.bin,30008000,ffffffff} IMAGE_2{,,} ... IMAGE_8{,,}这是配置中最容易出错的部分之一。IMAGE_x字段定义了需要被签名和管理的镜像片段。格式{IMAGE_NAME, SRC_ADDR, DST_ADDR}IMAGE_NAME镜像文件的路径。SRC_ADDR该镜像内容在最终生成的复合镜像文件中的加载地址。对于大多数情况这就是ENTRY_POINT。工具会计算从这个地址开始的数据的哈希。DST_ADDR该镜像在内存中的目标运行地址。对于像U-Boot这样的单一、位置无关或已重定位的镜像通常设置为0xffffffff表示“与SRC_ADDR相同”。对于更复杂的场景如包含多个需重定位段的镜像需要分别指定。一个常见的误区是混淆了“文件中的位置”和“内存中的位置”。SRC_ADDR关乎“验什么”DST_ADDR关乎“放哪里”。在简单的U-Boot签名中两者通常一致。2.1.4 可选标识与输出控制FSL_UID_0 OEM_UID_0 ... OUTPUT_HDR_FILENAMEhdr_uboot.outFSL_UID_x和OEM_UID_x用于填充头中的厂商标识字段。可用于版本控制或设备溯源非强制。OUTPUT_HDR_FILENAME定义输出的安全头文件名。如果不指定工具会使用默认名。2.1.5 功能标志位MP_FLAG0 ISS_FLAG1 LW_FLAG0 VERBOSE0这些标志位精细控制安全状态ISS_FLAG(Increment Security State)设置为1时成功验证此镜像后芯片的安全状态计数器SSM将递增。这是一个不可逆的操作通常用于从开发阶段可调试切换到生产阶段锁定调试接口。在最终生产镜像中通常设为1在开发调试阶段慎用。MP_FLAG(Manufacturing Protection)与NXP的制造保护功能相关一般设为0。LW_FLAG(Leave Writeable)控制镜像加载后相关内存区域的写权限通常设为0只读。VERBOSE设为1时工具会打印生成的头文件的详细信息调试时非常有用。2.2 命令行参数灵活性的体现除了配置文件uni_sign还提供命令行参数来覆盖配置或实现特殊流程。./uni_sign --in input_file --out custom_header.bin --verbose常用参数--in指定输入配置文件。这是唯一必须通过命令行或配置文件提供的参数。--out覆盖配置文件中OUTPUT_HDR_FILENAME的设置直接指定输出头文件名。--verbose覆盖配置文件中的VERBOSE设置强制输出详细信息。--hash不生成头文件仅计算并输出SRK公钥的哈希值。这是获取待烧录熔丝值的最直接方式。--img_hash关键选项。它让工具生成不含签名的头文件并单独输出一个镜像哈希文件。这实现了签名流程的“分离”私钥可以仅在完全隔离的签名服务器上使用极大提升了私钥的安全性。我们将在后续章节详细展开。3. 完整签名流程实操从生成密钥到合成固件理解了配置文件后我们来看一个完整的、可操作的签名流程。假设我们的目标是为LS2088ARDB平台的NOR Flash启动U-Boot镜像启用安全启动。3.1 第一步准备环境与生成密钥首先确保你已安装或编译了Layerscape SDKLSDK或相应的开发环境其中包含了CST工具。# 进入CST工具目录通常位于SDK的build/cst下 cd path_to_sdk/build/cst # 使用gen_keys脚本生成密钥对 ./gen_keys执行后会在当前目录生成srk.pri私钥、srk.pub公钥以及一个srk_hash.txt文件。立即备份srk_hash.txt里面是8个32位的十六进制数这就是需要烧录到芯片SFP熔丝中的SRKH值。私钥srk.pri必须转移到安全的离线环境保管3.2 第二步配置并运行uni_sign生成安全头将需要签名的u-boot.bin镜像拷贝到CST目录。根据你的硬件平台和启动介质NOR SD等SDK的input_files/uni_sign/目录下通常有参考配置文件。我们以input_uboot_nor_secure为模板进行修改。# 复制并编辑配置文件 cp input_files/uni_sign/ls2088/input_uboot_nor_secure my_uboot_secure.csf vim my_uboot_secure.csf你需要至少修改以下几项以匹配你的环境PLATFORM确认是你的平台如LS2088。ENTRY_POINT确认是你的U-Boot链接地址。IMAGE_1确保第一个花括号内的镜像文件名正确例如{u-boot.bin,30008000,ffffffff}。检查PRI_KEY和PUB_KEY路径是否正确。如果密钥文件不在当前目录需提供相对或绝对路径。配置完成后执行签名# 单步生成带签名的完整安全头 ./uni_sign my_uboot_secure.csf如果一切顺利将生成hdr_uboot.out或在配置文件中指定的文件名。这个文件就是包含了签名和所有元数据的安全头。3.3 第三步合成最终可启动镜像生成的安全头需要与原始的RCW复位配置字和U-Boot镜像拼接起来形成芯片BootROM能够识别的完整启动流。# 假设 rcw.bin 是你的RCW文件hdr_uboot.out是安全头u-boot.bin是原始镜像 cat rcw.bin hdr_uboot.out u-boot.bin final_boot_image.bin顺序至关重要必须是RCW在前然后是安全头最后是应用程序镜像U-Boot。BootROM会先加载RCW然后根据RCW的指示找到安全头进行验证验证通过后才会跳转到U-Boot执行。3.4 第四步烧录SRK哈希与测试将合成的final_boot_image.bin烧写到启动介质的起始位置如NOR Flash的0x0地址。接下来是最关键的一步将之前srk_hash.txt中的哈希值烧录到芯片的SFP熔丝中。开发阶段常用方法通过调试器写入镜像寄存器 对于LS2088可以通过将其置于复位暂停状态RSP然后使用CodeWarrior或类似调试工具直接写入SFP镜像寄存器地址0x1E80254-0x1E80270。具体命令如项目正文所示需要根据你的调试环境适配。写入后让芯片退出RSP并复位。如果SRKH匹配且签名验证通过系统将正常启动至U-Boot。否则可能会卡住或进入恢复模式。实操心得在第一次尝试安全启动前务必先确保非安全启动的镜像即不带头和签名的普通RCWU-Boot可以正常工作。这能排除基础硬件和镜像本身的问题。然后在烧录SRKH熔丝这个“不可逆”操作前可以先通过写入镜像寄存器的方式进行测试。只有确认整个安全启动流程无误后再考虑在量产环境中真正烧断熔丝。4. 高级应用与安全最佳实践分离式签名直接将私钥放在构建服务器上运行uni_sign存在风险。NXP CST工具提供了--img_hash选项支持分离式签名流程这是更符合高安全等级要求的做法。4.1 分离式签名流程详解该流程将签名过程拆分为三个步骤私钥仅在最后一步的隔离环境中使用生成哈希与无签名头在连接网络的构建服务器上执行。此步骤不涉及私钥。./uni_sign --img_hash --verbose my_uboot_secure.csf此命令会做两件事生成一个不包含签名的安全头文件如hdr_uboot.out。生成一个单独的二进制文件默认为hash.out其中包含了待签名数据的SHA256哈希值。 工具会输出类似如下的信息其中“Image Hash”就是需要被签名的核心数据。Image Hash: 8588c174dd92f4a1b114b9029fc647e18cac4aaa46f03a6538ef20531e796e8f * Image Hash Stored in File: hash.out * Header File is w/o Signature appended离线签名将hash.out文件通过安全方式如手动拷贝转移到一台离线、无网络、物理隔离的签名机器上。该机器上存放着受保护的私钥srk.pri。使用gen_sign工具生成签名。# 在离线签名机上操作 ./gen_sign hash.out srk.pri命令执行后会生成一个签名文件sign.out默认名。这个sign.out文件就是私钥对哈希值的加密结果。嵌入签名将sign.out文件带回构建环境使用sign_embed工具将其嵌入到之前生成的无签名头文件中。./sign_embed hdr_uboot.out sign.out执行后hdr_uboot.out文件尾部就被附加了签名数据变成了一个完整的安全头文件。后续的镜像合成步骤与普通流程一致。4.2 为何选择分离式签名私钥隔离私钥永远不需要离开高安全性的离线环境从根本上杜绝了通过网络泄露的风险。流程合规满足许多行业安全标准中对密钥管理的要求便于审计。灵活性哈希文件hash.out是一个很小的二进制文件传递方便。同一份哈希可以在多个离线签名机上进行备份签名。5. 常见问题排查与实战技巧在实际操作中你可能会遇到各种问题。下面是一些典型故障的排查思路。问题1签名验证失败芯片无法启动。检查SRKH值确认烧录到芯片熔丝或镜像寄存器的SRKH值与uni_sign工具运行--hash选项输出的值完全一致。特别注意字节序工具输出的哈希值通常是内存顺序大端而通过某些调试接口如U-Boot的mw命令写入时可能需要转换为小端格式。项目正文中U-Boot部分的示例明确展示了字节交换44ad9053vs5390ad44。检查镜像拼接顺序确认最终烧写镜像的顺序是RCW 安全头 应用程序镜像。顺序错误会导致BootROM解析头失败。检查入口地址和镜像地址确认ENTRY_POINT和IMAGE_1中的SRC_ADDR与U-Boot的实际链接地址匹配。使用readelf -a u-boot或查看U-Boot的链接脚本可以确认。检查密钥匹配确保用于签名的私钥srk.pri和配置文件中指定的公钥srk.pub是一对。可以用OpenSSL命令验证openssl rsa -in srk.pri -pubout -out derived_pub.pub然后比较derived_pub.pub和srk.pub是否相同。问题2使用--img_hash流程后合成的镜像仍然启动失败。检查签名嵌入步骤确认sign_embed命令执行成功并且输出的hdr_uboot.out文件大小比之前增大了通常是增加了256字节对应RSA-2048签名长度。核对哈希文件确保gen_sign工具签名的hash.out文件与uni_sign --img_hash生成的hash.out是同一个文件在传递过程中没有损坏。可以使用sha256sum命令校验。问题3ISS_FLAG标志位使用不当导致芯片被锁定。现象设置ISS_FLAG1并成功启动一次后芯片拒绝加载旧的、或未设置此标志的镜像甚至可能关闭调试接口。解决方案这是安全状态递增的正常行为。在开发阶段务必谨慎使用ISS_FLAG。可以先设置为0待所有功能稳定后再测试设置为1的流程。如果误操作导致芯片锁死可能需要联系NXP支持或使用芯片的强制恢复模式如果有的话但这通常很困难。问题4为多个镜像片段签名时配置错误。场景除了U-Boot还需要为ATFARM Trusted Firmware或其它固件签名。配置要点正确使用IMAGE_1到IMAGE_8。每个条目需要准确填写SRC_ADDR该段在复合镜像中的位置和DST_ADDR该段在内存中的运行地址。对于需要重定位的复杂镜像这两者可能不同。务必参考SDK中对应平台的示例配置文件。一个关键的调试技巧始终在首次尝试时启用--verbose标志或者将配置文件中的VERBOSE设为1。工具会打印出生成的头文件的所有字段信息包括计算出的镜像哈希、SRK哈希等。将这些信息与你的预期进行比对是定位配置错误的最快方法。例如检查打印出的“Entry Point”和“SRC”地址是否与你设想的一致。