Intel® Stratix® 10 Device Security User Guide

ID 683642
Date 7/14/2023
Public
Document Table of Contents

2.1.4. Creating a Signature Chain Public Key Entry

Create a new public key entry for a signature chain with the append_key operation. You specify the prior signature chain, the private key for the last entry in the prior signature chain, the next level public key, the permissions and cancellation ID you assign to the next level public key, and the new signature chain file.

Depending on your use of keys on the file system or in an HSM, you use one of the following example commands to append the design0_sign public key to the root signature chain created in the prior section:
quartus_sign --family=stratix10 --operation=append_key \ 
--previous_pem=root_private.pem --previous_qky=root.qky \ 
--permission=6 --cancel=0 --input_pem=design0_sign_public.pem \ 
design0_sign_chain.qky
quartus_sign --family=stratix10 --operation=append_key --module=softHSM \
-–module_args="--token_label=s10-token \
--user_pin=s10-token-pin \
--hsm_lib=/usr/local/lib/softhsm/libsofthsm2.so" \
--previous_keyname=root --previous_qky=root.qky \
--permission=6 --cancel=0 --input_keyname=design0_sign \
design0_sign_chain.qky

You may repeat the append_key operation up to two more times for a maximum of three public key entries between the root entry and header block entry in any one signature chain.

The following example assumes you created another authentication public key with the same permissions and assigned cancellation ID 1 called design1_sign_public.pem, and are appending this key to the signature chain from the previous example:
quartus_sign --family=stratix10 --operation=append_key \ 
--previous_pem=design0_sign_private.pem \ 
--previous_qky=design0_sign_chain.qky \
--permission=6 \
--cancel=1 \
--input_pem=design1_sign_public.pem design1_sign_chain.qky 
quartus_sign --family=stratix10 --operation=append_key --module=softHSM \ 
--module_args="--token_label=s10-token \
--user_pin=s10-token-pin \
--hsm_lib=/usr/local/lib/softhsm/libsofthsm2.so" \
--previous_keyname=design0_sign_private.pem \
--previous_qky=design0_sign_chain.qky \
--permission=6 \
--cancel=1 \
--input_keyname=design1_sign design1_sign_chain.qky