> For the complete documentation index, see [llms.txt](https://carloss-organization-4.gitbook.io/tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://carloss-organization-4.gitbook.io/tech/ecus/rt117x_documents/rt-117x-i.mx-rt1170s-secure-boot/rt-117x-signing-image-with-the-hsm-signserver.md).
# \[RT-117x]Signing image with the HSM (SignServer)
在本文档中介绍如何使用sign server来对X-NAV的image进行签名。
## 1. PKI 体系
根据NXP-RT1176的secure boot的文档，
需要**角色**为：
* root CA （用于公钥的认证） 对应PKI体系图中的CA
* Level 1：Sign Server （在NXP中叫做SRK， super root key，二级证书）对应SRK1
* Level 2: CSF signer（用于对CSF header签名）
* Level2: IMAGE signer（用于对IMAGE签名）
**需要给到车端的证书：**
* ca.crt文件 （1个）
* srk.crt文件 （4个）
* csf.crt文件（4个）
* img.crt文件（4个）
其中4个srk.crt文件要组成列表计算hash放入eFUSE中，其中csf.crt和img.crt文件需要放入boot image的header中，其中ca.crt和srk.crt需要组成证书链用于image和csf的验签过程。
关于Key和Cert的生成要求，参见：
## 2. 签名要求
签名使用CMS\_sign，参考：
### 2.1 接口要求
使用SHA2\_256作为digest，接口要求（抽象为下面的伪代码接口）：
***sign\_request(srk\_number, csf\_or\_img\_signer, origin\_sign\_data)：***
输入参数：
* srk\_number: srk序列号（只有4个），在PKI体系图中对应SRK1-4
* csf\_or\_img\_signer：signer选择（只有2种），CSF signer或者IMAGE signer
* original\_sign\_data：签名的二进制数据的原始数据，几个字节到几十兆不等，通常低于1MB。
输出参数：
* CMS blob格式的签名二进制文件（DER格式）参考：[8.0\_Security\_pkcs7(CMS)\_embedded](https://github.com/carloscn/blog/issues/186)
注意CMS生成的二进制flags：
`CMS_DETACHED | CMS_NOCERTS | CMS_NOSMIMECAP | CMS_BINARY;`
这里有个sign的示例可以在这个工具中：
{% @github-files/github-code-block url="" %}
如何运行？
`make`
`make sign`
这里面分别有sign之前的数据和sign之后的数据。
### 2.2 签名验证
提供签名的验证工具，可以帮助你初步的快速的验证签名的数据。
`make verify`
## 3. NXP签名格式测试用例
{% embed url="" %}
以下为使用openssl命令行模拟NXP签名格式的测试用例（**请注意参数**）：
```bash
# !/bin/bash
rm -rf signed_imgsig.bin.cmdline
echo "[INFO] sign imgsig.bin.dup file."
openssl cms -sign -signer keys/IMG1_1_sha256_2048_65537_v3_usr_crt.pem \
-CAfile keys/ca_cert_chains.crt \
-inform der \
-inkey keys/IMG1_1_sha256_2048_65537_v3_usr_key.pem \
-md sha256 \
-outform DER \
-in imgsig.bin.dup \
-out signed_imgsig.bin.cmdline \
-passin pass:test \
-binary \
-nocerts \
-nosmimecap
if [ $? -ge 1 ]; then
echo "[ERR] sign failed!"
exit 2
fi
echo "[INFO] verify signed_imgsig.bin.cmdline file."
openssl cms -verify -certfile keys/IMG1_1_sha256_2048_65537_v3_usr_crt.pem \
-inform der \
-CAfile keys/ca_cert_chains.crt \
-in signed_imgsig.bin.cmdline \
-content imgsig.bin.dup \
-binary \
-nocerts \
-nosmimecap \
-nodetach > /dev/null
if [ $? -ge 1 ]; then
echo "[ERR] verify failed!"
exit 2
fi
echo "[INFO] done!"
```
{% file src="/files/52Sbwx07foY3aE12zJ4T" %}