Go to file
Patrick Uiterwijk e2f32d0fa0 Support some more weird pcr_id specifications
This change makes it pass all the different possible values provided by the clevis tpm2
pin test suite.

Signed-off-by: Patrick Uiterwijk <patrick@puiterwijk.org>
2020-08-27 14:04:33 +02:00
src Support some more weird pcr_id specifications 2020-08-27 14:04:33 +02:00
tests Test symlinked encrypt and decrypt 2020-08-25 13:11:46 +02:00
.gitignore Generate a new key and signed policy during the test 2020-07-22 16:46:54 +02:00
Cargo.toml Support some more weird pcr_id specifications 2020-08-27 14:04:33 +02:00
LICENSE Initial commit 2020-07-16 16:22:34 +02:00
README.md Add some policy instructions to the README 2020-07-22 16:38:36 +02:00

clevis-pin-tpm2

Rewritten Clevis TPM2 PIN

This rewrite supports all previously encrypted values of the PCR-only clevis TPM2 PIN. Additionally, it supports Authorized Policies to delegate authorization of PCR values to an external party.

Creating policies

A reference implementation has been made available for creating policies as parsed by this pin. To use this, first create a policy (see instructions in the repository) and take the output signed policy and the public key JSON. These files need to be available when the PIN runs, so if the pin is used to encrypt the filesystem root, it will probably need to be in /boot. Then run: $binary encrypt '{"policy_pubkey_path": "/boot/policy_pubkey.json", "policy_ref": "", "policy_path": "/boot/policy.json"}' <somefile. This results in an encrypted blob. During the encryption, the policy pubkey needs to exist, the policy does not.

To decrypt this blob, the file specified in the policy_path during encrypt needs to contain a policy that matches the policy_ref with any steps that would match the current PCRs of the system. If that's the case, $binary decrypt <blob will return the contents of the original file back.