4. 固件签名工具链：OpenSSL、Python cryptography 与 Hashicorp Vault

说到固件签名，工具链的选择其实挺多的。我个人习惯把这套东西分成三个层次：命令行快速验证、脚本化集成、企业级密钥管理。今天我们就挨个过一遍。

4.1 OpenSSL 命令行：最朴素的签名方式

OpenSSL 是嵌入式开发者的老朋友了。你想想看，几乎每个 Linux 开发环境都自带它，用来做固件签名的原型验证再方便不过。

我一般用 ECDSA（椭圆曲线数字签名算法）而不是 RSA。为什么？因为固件体积小、验签速度快。在资源受限的 MCU 上，ECDSA 的验签时间能比 RSA 快一个数量级。

先看生成密钥对：

# 生成 ECDSA P-256 私钥
openssl ecparam -genkey -name prime256v1 -out firmware_priv.pem

# 导出公钥（给设备验签用）
openssl ec -in firmware_priv.pem -pubout -out firmware_pub.pem

然后对固件签名：

# 计算固件哈希并签名
openssl dgst -sha256 -sign firmware_priv.pem -out firmware.sig firmware.bin

# 验签（模拟设备端）
openssl dgst -sha256 -verify firmware_pub.pem -signature firmware.sig firmware.bin

嗯，这里要注意：千万别直接用私钥加密整个固件。签名和加密是两码事。签名是对哈希值做运算，不是对原始数据。

4.2 Python cryptography 库：脚本化签名的正确姿势

OpenSSL 命令行虽然好用，但一旦涉及批量签名、多版本管理、密钥轮换，你就需要编程语言层面的支持了。Python 的 cryptography 库是我最常用的选择。

为什么不用 PyCrypto 或 PyCryptodome？说实话，cryptography 的 API 设计更现代，而且底层调用了 OpenSSL 的 C 库，性能有保障。

看一个完整的签名脚本骨架：

from cryptography.hazmat.primitives import hashes, serialization
from cryptography.hazmat.primitives.asymmetric import ec
from cryptography.hazmat.primitives.asymmetric.utils import (
    Prehashed, decode_dss_signature, encode_dss_signature
)
import hashlib

def sign_firmware(firmware_path: str, key_path: str) -> bytes:
    # 加载私钥
    with open(key_path, "rb") as f:
        private_key = serialization.load_pem_private_key(
            f.read(),
            password=None,  # 生产环境建议加密
        )

    # 计算固件 SHA-256
    sha256 = hashlib.sha256()
    with open(firmware_path, "rb") as f:
        while chunk := f.read(4096):
            sha256.update(chunk)
    digest = sha256.digest()

    # 签名（使用 Prehashed 避免二次哈希）
    signature = private_key.sign(
        digest,
        ec.ECDSA(Prehashed(hashes.SHA256()))
    )

    return signature

我在项目中遇到过一个问题：签名后的固件在设备端验签失败。排查了半天，发现是 Python 端签名时用了 Prehashed，但设备端验签时又对哈希值做了一次哈希。说白了就是哈希次数对不上。后来我统一在两边都使用原始数据 + 标准哈希流程，问题就解决了。

4.3 Hashicorp Vault 集成：企业级密钥管理

到了生产环境，私钥不能躺在开发者的笔记本里，也不能放在 CI 服务器的环境变量中。这时候就需要 Hashicorp Vault 这样的密钥管理服务了。

Vault 的核心价值在于：私钥从不离开 Vault。签名操作在 Vault 内部完成，你拿到的只是签名结果。这样即使 CI 服务器被攻破，攻击者也拿不到私钥。

集成方式其实不复杂，Vault 提供了 REST API 和 PKI/TLS 引擎。我画了一张架构图帮你理解：

用 Vault 签名的 Python 代码也很简洁：

import requests
import base64

def vault_sign(firmware_hash: bytes, vault_addr: str, token: str) -> bytes:
    """通过 Vault API 签名固件哈希"""
    url = f"{vault_addr}/v1/transit/sign/firmware-key"
    headers = {"X-Vault-Token": token}
    
    payload = {
        "input": base64.b64encode(firmware_hash).decode(),
        "hash_algorithm": "sha2-256",
        "signature_algorithm": "ecdsa-p256"
    }
    
    resp = requests.post(url, json=payload, headers=headers)
    resp.raise_for_status()
    
    # 解析 Vault 返回的签名
    signature_b64 = resp.json()["data"]["signature"]
    # 格式: vault:v1:base64_signature
    return base64.b64decode(signature_b64.split(":")[-1])

4.4 三种工具链的对比选择

我把这三种方式的特点整理成了表格，方便你根据场景选择：

工具链	适用场景	密钥安全	自动化程度	性能
OpenSSL CLI	原型验证、临时签名	低（私钥在文件系统）	低（手动执行）	中等
Python cryptography	CI/CD 集成、批量签名	中（可加密存储）	高（脚本化）	高（内存运算）
Hashicorp Vault	生产环境、合规要求	高（私钥不出 Vault）	高（API 驱动）	受网络延迟影响