diff options
author | James Bottomley <James.Bottomley@HansenPartnership.com> | 2018-06-29 17:54:46 -0700 |
---|---|---|
committer | James Bottomley <James.Bottomley@HansenPartnership.com> | 2018-06-29 17:54:46 -0700 |
commit | 52e9d5cfbc3e7f1c566ad1153761792498174dd6 (patch) | |
tree | dde1a147c195643be9c4b8dffcf34b9a3810d34d | |
parent | 8763f3c14fb82bb910c99c3db5e46ebc42526315 (diff) | |
download | openssl_tpm2_engine-52e9d5cfbc3e7f1c566ad1153761792498174dd6.tar.gz |
create_tpm2_key: man page updates
Add a files secton to describe the policy file format (copied from the
README file) and lose the bit about us taking 50s to generate the
parent if unspecified: now we generate the ECC version which is much
faster.
Signed-off-by: James Bottomley <James.Bottomley@HansenPartnership.com>
-rw-r--r-- | create_tpm2_key.1.in | 20 |
1 files changed, 18 insertions, 2 deletions
diff --git a/create_tpm2_key.1.in b/create_tpm2_key.1.in index 19a171b..0e52d86 100644 --- a/create_tpm2_key.1.in +++ b/create_tpm2_key.1.in @@ -7,6 +7,23 @@ Can be used to create a TPM loadable representation of a private key. The key is either internal to the TPM or wrapped from an existing private key. +[files] + +Policy File Format + +The policy file should contain a rule for each line, where rules +can be generated for example with the tsspolicymakerpcr tool from IBM TSS. + +Example (PolicyPCR): + +$ tsspolicymakerpcr -bm 10000 -if policypcr16aaasha256.txt -v -pr -of policies/policypcr.txt >> policy.txt + +where policypcr16aaasha256.txt contains the desired value of PCR 16. + +Example (PolicyAuthValue): + +$ echo 0000016b >> policy.txt + [examples] Create a self-signed cert using the TPM engine: @@ -37,8 +54,7 @@ Create a self-signed cert using the TPM engine: Note: specifying the parent is optional (and you need to have created it in step 0) but if you leave it out, the key will still end up parented to the primary storage seed and the TPM will have - to re-derive the RSA version of that seed each time you use it - (possibly taking 50s or more each time) + to re-derive the ECC version of that seed each time you use it Note: because the RSA private key is sent to the TPM encrypted, the tss has to have access to the public part of the parent key (if you |