From: Randy Dunlap <rdunlap@infradead.org>
To: Stefan Berger <stefanb@linux.ibm.com>,
keyrings@vger.kernel.org, linux-integrity@vger.kernel.org
Cc: zohar@linux.ibm.com, jejb@linux.ibm.com,
Alexander.Levin@microsoft.com, jsnitsel@redhat.com,
jmorris@namei.org, linux-kernel@vger.kernel.org
Subject: Re: [PATCH] docs: Extend trusted keys documentation for TPM 2.0
Date: Fri, 19 Oct 2018 16:07:42 -0700 [thread overview]
Message-ID: <a55a53a8-1308-aff3-afb8-6cbe0ffa1bee@infradead.org> (raw)
In-Reply-To: <20181019101758.1569-1-stefanb@linux.ibm.com>
Hi,
Feel free to ignore my comments. I don't know anything about TPM.
On 10/19/18 3:17 AM, Stefan Berger wrote:
> Extend the documentation for trusted keys with documentation for how to
> set up a key for a TPM 2.0 so it can be used with a TPM 2.0 as well.
>
> Signed-off-by: Stefan Berger <stefanb@linux.ibm.com>
> Reviewed-by: Mimi Zohar <zohar@linux.ibm.com>
> ---
> .../security/keys/trusted-encrypted.rst | 31 ++++++++++++++++++-
> 1 file changed, 30 insertions(+), 1 deletion(-)
>
> diff --git a/Documentation/security/keys/trusted-encrypted.rst b/Documentation/security/keys/trusted-encrypted.rst
> index 3bb24e09a332..6ec6bb2ac497 100644
> --- a/Documentation/security/keys/trusted-encrypted.rst
> +++ b/Documentation/security/keys/trusted-encrypted.rst
> @@ -18,10 +18,33 @@ integrity verifications match. A loaded Trusted Key can be updated with new
> when the kernel and initramfs are updated. The same key can have many saved
> blobs under different PCR values, so multiple boots are easily supported.
>
> +TPM 1.2
> +-------
> +
> By default, trusted keys are sealed under the SRK, which has the default
> authorization value (20 zeros). This can be set at takeownership time with the
> trouser's utility: "tpm_takeownership -u -z".
It appears to be TrouSerS or maybe just trousers (no ').
BTW, is this still the current location for it or has it moved elsewhere?
http://trousers.sourceforge.net/
>
> +TPM 2.0
> +-------
> +
> +The user must first create a storage key and make it persistent, so the key is
> +available after reboot. This can be done using the following commands.
> +
> +With the IBM TSS 2 stack::
> +
> + #> tsscreateprimary -hi o -st
> + Handle 80000000
> + #> tssevictcontrol -hi o -ho 80000000 -hp 81000001
> +
> +Or with the Intel TSS 2 stack::
> +
> + #> tpm2_createprimary --hierarchy o -G rsa2048 -o key.ctxt
> + [...]
> + handle: 0x800000FF
Is that handle value important? It doesn't seem to be used later...
> + #> tpm2_evictcontrol -c key.ctxt -p 0x81000001
> + persistentHandle: 0x81000001
> +
> Usage::
>
> keyctl add trusted name "new keylen [options]" ring
> @@ -30,7 +53,9 @@ Usage::
> keyctl print keyid
>
> options:
> - keyhandle= ascii hex value of sealing key default 0x40000000 (SRK)
> + keyhandle= ascii hex value of sealing key
s/ascii/ASCII/g
> + TPM 1.2: default 0x40000000 (SRK)
> + TPM 2.0: no default; must be passed every time
> keyauth= ascii hex auth for sealing key default 0x00...i
> (40 ascii zeros)
> blobauth= ascii hex auth for sealed data default 0x00...
> @@ -84,6 +109,10 @@ Examples of trusted and encrypted key usage:
>
> Create and save a trusted key named "kmk" of length 32 bytes::
>
> +Note: When using a TPM 2.0 with a persistent key with handle 0x81000001,
> +append 'keyhandle=0x81000001' to statements between quotes, such as
> +"new 32 keyhandle=0x81000001".
> +
> $ keyctl add trusted kmk "new 32" @u
> 440502848
>
>
ta.
--
~Randy
next prev parent reply other threads:[~2018-10-19 23:07 UTC|newest]
Thread overview: 13+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-10-19 10:17 [PATCH] docs: Extend trusted keys documentation for TPM 2.0 Stefan Berger
2018-10-19 23:07 ` Randy Dunlap [this message]
2018-11-05 16:57 ` Dan Williams
2018-11-05 20:42 ` Jerry Snitselaar
2018-11-06 16:00 ` Jerry Snitselaar
2018-11-06 16:14 ` Joshua Lock
2018-11-07 0:53 ` Roberts, William C
2018-11-06 16:46 ` Jerry Snitselaar
2018-11-06 18:17 ` Mimi Zohar
2018-11-30 23:45 ` Jarkko Sakkinen
2018-11-30 23:46 ` Jarkko Sakkinen
2018-12-02 15:10 ` Mimi Zohar
2018-12-02 23:04 ` Jarkko Sakkinen
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=a55a53a8-1308-aff3-afb8-6cbe0ffa1bee@infradead.org \
--to=rdunlap@infradead.org \
--cc=Alexander.Levin@microsoft.com \
--cc=jejb@linux.ibm.com \
--cc=jmorris@namei.org \
--cc=jsnitsel@redhat.com \
--cc=keyrings@vger.kernel.org \
--cc=linux-integrity@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=stefanb@linux.ibm.com \
--cc=zohar@linux.ibm.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).