aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJames Bottomley <James.Bottomley@HansenPartnership.com>2018-06-29 17:54:46 -0700
committerJames Bottomley <James.Bottomley@HansenPartnership.com>2018-06-29 17:54:46 -0700
commit52e9d5cfbc3e7f1c566ad1153761792498174dd6 (patch)
treedde1a147c195643be9c4b8dffcf34b9a3810d34d
parent8763f3c14fb82bb910c99c3db5e46ebc42526315 (diff)
downloadopenssl_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.in20
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