TPM2 engine support for openssl
cover TPM2 engine support for openssl
This is a basic RFC to show that it's possible to get TPM2 to act as an engine for openssl as well as TPM1.2. The format follows as closely as possible what happens in TPM1.2. The file format is full blown ASN.1 because we have to include both a public and private key blob. I chose to use TSS2 KEY BLOB as the guards to distinguish it from the TPM1.2 file.
TPM2 has significant limitations over TPM1.2 in what it will sign:
basically it must recognise the signature algorithm (that's why all the signature parsing in the rsa_priv_enc() routine). There's also another problem in that a primary asymmetric key of the SPS must be provisioned every time we perform this operation (which is time consuming and annoying). I think we need to do something about this under Linux, but I'll take that off the openssl list because they likely won't be interested.
The authority handling is missing at the moment, but I'll add that shortly. We should probably discuss how policy based authorisation should be handled: I think as extensions to the key ASN.1 file.
Because of the signature recognition problem, you have to test this out with x509 certificates:
openssl genrsa 2048 > tmp.keycreate_tpm2_key -w tmp.key tmp.bin
openssl req -new -engine tpm2 -key tmp.bin -keyform e > tmp.csr openssl x509 -req -engine tpm2 -in tmp.csr -signkey tmp.bin -keyform e -out tmp.crt openssl x509 -text -in tmp.crt
The last step will validate you've got a genuine x509 self signed certificate with the key from the TPM.
This kit is constructed using the IBM TSS2:
https://sourceforge.net/projects/ibmtpm20tss/
And, at the moment, it's only been validated on a software TPM2.
James
---
James Bottomley (1):
add TPM2 version of create_tpm2_key and libtpm2.so engine
Makefile.am | 12 +- create_tpm2_key.c | 381 ++++++++++++++++++++++++++++++++++++++++++ e_tpm2.c | 482 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ tpm2-asn.h | 35 ++++ tpm2-common.c | 172 +++++++++++++++++++ tpm2-common.h | 10 ++ 6 files changed, 1090 insertions(+), 2 deletions(-) create mode 100644 create_tpm2_key.c create mode 100644 e_tpm2.c create mode 100644 tpm2-asn.h create mode 100644 tpm2-common.c create mode 100644 tpm2-common.h
Signature · 9 lines
2.6.6 ------------------------------------------------------------------------------ Developer Access Program for Intel Xeon Phi Processors Access to Intel Xeon Phi processor-based developer platforms. With one year of Intel Parallel Studio XE. Training and support from Colfax. Order your platform today.http://sdm.link/intel
RFC 1/1 add TPM2 version of create_tpm2_key and libtpm2.so engine
Proof of concept patch to wrap RSA (and eventually other) keys in TPM2 format and use them to load into a TPM2 to perform signatures.
This scheme has significant limitations over TPM1.2 in that TPM2 insists on knowing and validating the signature, so it will only sign stuff it knows the OID to. That's also why the signature has to be parsed into an X509_SIG before signing.
--- Makefile.am | 12 +- create_tpm2_key.c | 381 ++++++++++++++++++++++++++++++++++++++++++ e_tpm2.c | 482 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ tpm2-asn.h | 35 ++++ tpm2-common.c | 172 +++++++++++++++++++ tpm2-common.h | 10 ++ 6 files changed, 1090 insertions(+), 2 deletions(-) create mode 100644 create_tpm2_key.c create mode 100644 e_tpm2.c create mode 100644 tpm2-asn.h create mode 100644 tpm2-common.c create mode 100644 tpm2-common.h
Makefile.am +10 -2
@@ -2,12 +2,20 @@ SUBDIRS=. test EXTRA_DIST = README openssl.cnf.sample -openssl_engine_LTLIBRARIES=libtpm.la -bin_PROGRAMS=create_tpm_key +openssl_engine_LTLIBRARIES=libtpm.la libtpm2.la +bin_PROGRAMS=create_tpm_key create_tpm2_key openssl_enginedir=@libdir@/openssl/engines libtpm_la_LIBADD=-lcrypto -lc -ltspi libtpm_la_SOURCES=e_tpm.c e_tpm.h e_tpm_err.c +libtpm2_la_LIBADD=-lcrypto -lc -ltss +libtpm2_la_SOURCES=e_tpm2.c tpm2-common.c +libtpm2_la_CFLAGS=-g -Werror + create_tpm_key_SOURCES=create_tpm_key.c create_tpm_key_LDADD=-lcrypto -ltspi + +create_tpm2_key_SOURCES=create_tpm2_key.c tpm2-common.c +create_tpm2_key_LDADD=-lcrypto -ltss +create_tpm2_key_CFLAGS=-Werror
create_tpm2_key.c new file +381 -0
381 lines not on this page · raw message
e_tpm2.c new file +482 -0
482 lines not on this page · raw message
tpm2-asn.h new file +35 -0
@@ -0,0 +1,35 @@ +/* Copyright (C) 2016 James Bottomley <[email protected]> +* +* GPLv2 +*/ +#ifndef _TPM2_ASN_H +#define _TPM2_ASN_H + +#include <openssl/asn1t.h> + +/* +* Define the format of a TSS2 key file. The current format is a +* symmetrically encrypted private key produced by TSS2_Import and +* the TPM2 format public key which contains things like the policy but +* which is cryptographically tied to the private key +*/ + +typedef struct { +ASN1_OCTET_STRING *pubkey; +ASN1_OCTET_STRING *privkey; +}TSSLOADABLE ; + +ASN1_SEQUENCE (TSSLOADABLE ) = { +ASN1_SIMPLE (TSSLOADABLE , pubkey,ASN1_OCTET_STRING ), +ASN1_SIMPLE (TSSLOADABLE , privkey,ASN1_OCTET_STRING ) +} ASN1_SEQUENCE_END(TSSLOADABLE) + +IMPLEMENT_ASN1_FUNCTIONS (TSSLOADABLE); + +/* This is the PEM guard tag */ +#define TSSLOADABLE_PEM_STRING "TSS2 KEY BLOB" + +static IMPLEMENT_PEM_write_bio(TSSLOADABLE, TSSLOADABLE, TSSLOADABLE_PEM_STRING, TSSLOADABLE) +static IMPLEMENT_PEM_read_bio(TSSLOADABLE, TSSLOADABLE, TSSLOADABLE_PEM_STRING, TSSLOADABLE) + +#endif
tpm2-common.c new file +172 -0
172 lines not on this page · raw message
tpm2-common.h new file +10 -0
@@ -0,0 +1,10 @@ +#ifndef _TPM2_COMMON_H +#define _TPM2_COMMON_H + +void tpm2_error (TPM_RC rc,const char *reason); +TPM_HANDLE tpm2_load_srk (TSS_CONTEXT *tssContext,TPM_HANDLE *h,const char *auth,TPM2B_PUBLIC *pub); +void tpm2_flush_handle (TSS_CONTEXT *tssContext,TPM_HANDLE h); +EVP_PKEY *tpm2_to_openssl_public (TPMT_PUBLIC *pub); +void tpm2_flush_srk (TSS_CONTEXT *tssContext); + +#endif
Signature · 5 lines
2.6.6 -- openssl-dev mailing list To unsubscribe: https://mta.openssl.org/mailman/listinfo/openssl-dev
A message that is not in the archive (sent off-list or not yet received): 1482382526.2350.57.camel-d9PhHud1JfjCXq6kfMZ53/[email protected]
[openssl-dev cut; they're likely not interested in this]
Quoted 5 lines · James Bottomley
There's also another problem in that a primary asymmetric key of the SPS must be provisioned every time we perform this operation (which is time consuming and annoying). I think we need to do something about this under Linux, but I'll take that off the openssl list because they likely won't be interested.
I talked to Microsoft about what they do. Apparently there is an unpublished TPM 2.0 provisioning guide which specifies how the SRK should be handled, and a published one for the EK:
http://www.trustedcomputinggroup.org/wp-content/uploads/Credential_Profile_EK_V2.0_R14_published.pdf
the SRK template is identical to the EK one except that
userWithAuth = 1
adminWithPolicy = 0
noDA = 1
authPolicy = empty policy
The persistent handles for these two are EK: 0x81010001; SRK:0x81000001. Conventionally the SRK is provisioned with empty auth.
I think as part of our tpm2 take ownership, we should provision the owner and lockout auth and create these two primary objects if they don't already exist.
That would mean I can get rid of the primary object stuff in my tpm2 engine code and simply look for the well known handle.
James
------------------------------------------------------------------------------
Developer Access Program for Intel Xeon Phi Processors Access to Intel Xeon Phi processor-based developer platforms. With one year of Intel Parallel Studio XE.
Training and support from Colfax.
Order your platform today.http://sdm.link/intel