/* SPDX-License-Identifier: LGPL-2.1-or-later */ #include "extract-word.h" #include "parse-util.h" #include "tpm2-util.h" #if HAVE_TPM2 #include "alloc-util.h" #include "dirent-util.h" #include "dlfcn-util.h" #include "fd-util.h" #include "format-table.h" #include "fs-util.h" #include "hexdecoct.h" #include "memory-util.h" #include "random-util.h" #include "time-util.h" static void *libtss2_esys_dl = NULL; static void *libtss2_rc_dl = NULL; static void *libtss2_mu_dl = NULL; TSS2_RC (*sym_Esys_Create)(ESYS_CONTEXT *esysContext, ESYS_TR parentHandle, ESYS_TR shandle1, ESYS_TR shandle2, ESYS_TR shandle3, const TPM2B_SENSITIVE_CREATE *inSensitive, const TPM2B_PUBLIC *inPublic, const TPM2B_DATA *outsideInfo, const TPML_PCR_SELECTION *creationPCR, TPM2B_PRIVATE **outPrivate, TPM2B_PUBLIC **outPublic, TPM2B_CREATION_DATA **creationData, TPM2B_DIGEST **creationHash, TPMT_TK_CREATION **creationTicket) = NULL; TSS2_RC (*sym_Esys_CreatePrimary)(ESYS_CONTEXT *esysContext, ESYS_TR primaryHandle, ESYS_TR shandle1, ESYS_TR shandle2, ESYS_TR shandle3, const TPM2B_SENSITIVE_CREATE *inSensitive, const TPM2B_PUBLIC *inPublic, const TPM2B_DATA *outsideInfo, const TPML_PCR_SELECTION *creationPCR, ESYS_TR *objectHandle, TPM2B_PUBLIC **outPublic, TPM2B_CREATION_DATA **creationData, TPM2B_DIGEST **creationHash, TPMT_TK_CREATION **creationTicket) = NULL; void (*sym_Esys_Finalize)(ESYS_CONTEXT **context) = NULL; TSS2_RC (*sym_Esys_FlushContext)(ESYS_CONTEXT *esysContext, ESYS_TR flushHandle) = NULL; void (*sym_Esys_Free)(void *ptr) = NULL; TSS2_RC (*sym_Esys_GetCapability)(ESYS_CONTEXT *esysContext, ESYS_TR shandle1, ESYS_TR shandle2, ESYS_TR shandle3, TPM2_CAP capability, UINT32 property, UINT32 propertyCount, TPMI_YES_NO *moreData, TPMS_CAPABILITY_DATA **capabilityData); TSS2_RC (*sym_Esys_GetRandom)(ESYS_CONTEXT *esysContext, ESYS_TR shandle1, ESYS_TR shandle2, ESYS_TR shandle3, UINT16 bytesRequested, TPM2B_DIGEST **randomBytes) = NULL; TSS2_RC (*sym_Esys_Initialize)(ESYS_CONTEXT **esys_context, TSS2_TCTI_CONTEXT *tcti, TSS2_ABI_VERSION *abiVersion) = NULL; TSS2_RC (*sym_Esys_Load)(ESYS_CONTEXT *esysContext, ESYS_TR parentHandle, ESYS_TR shandle1, ESYS_TR shandle2, ESYS_TR shandle3, const TPM2B_PRIVATE *inPrivate, const TPM2B_PUBLIC *inPublic, ESYS_TR *objectHandle) = NULL; TSS2_RC (*sym_Esys_PCR_Read)(ESYS_CONTEXT *esysContext, ESYS_TR shandle1,ESYS_TR shandle2, ESYS_TR shandle3, const TPML_PCR_SELECTION *pcrSelectionIn, UINT32 *pcrUpdateCounter, TPML_PCR_SELECTION **pcrSelectionOut, TPML_DIGEST **pcrValues); TSS2_RC (*sym_Esys_PolicyGetDigest)(ESYS_CONTEXT *esysContext, ESYS_TR policySession, ESYS_TR shandle1, ESYS_TR shandle2, ESYS_TR shandle3, TPM2B_DIGEST **policyDigest) = NULL; TSS2_RC (*sym_Esys_PolicyPCR)(ESYS_CONTEXT *esysContext, ESYS_TR policySession, ESYS_TR shandle1, ESYS_TR shandle2, ESYS_TR shandle3, const TPM2B_DIGEST *pcrDigest, const TPML_PCR_SELECTION *pcrs) = NULL; TSS2_RC (*sym_Esys_StartAuthSession)(ESYS_CONTEXT *esysContext, ESYS_TR tpmKey, ESYS_TR bind, ESYS_TR shandle1, ESYS_TR shandle2, ESYS_TR shandle3, const TPM2B_NONCE *nonceCaller, TPM2_SE sessionType, const TPMT_SYM_DEF *symmetric, TPMI_ALG_HASH authHash, ESYS_TR *sessionHandle) = NULL; TSS2_RC (*sym_Esys_Startup)(ESYS_CONTEXT *esysContext, TPM2_SU startupType) = NULL; TSS2_RC (*sym_Esys_Unseal)(ESYS_CONTEXT *esysContext, ESYS_TR itemHandle, ESYS_TR shandle1, ESYS_TR shandle2, ESYS_TR shandle3, TPM2B_SENSITIVE_DATA **outData) = NULL; const char* (*sym_Tss2_RC_Decode)(TSS2_RC rc) = NULL; TSS2_RC (*sym_Tss2_MU_TPM2B_PRIVATE_Marshal)(TPM2B_PRIVATE const *src, uint8_t buffer[], size_t buffer_size, size_t *offset) = NULL; TSS2_RC (*sym_Tss2_MU_TPM2B_PRIVATE_Unmarshal)(uint8_t const buffer[], size_t buffer_size, size_t *offset, TPM2B_PRIVATE *dest) = NULL; TSS2_RC (*sym_Tss2_MU_TPM2B_PUBLIC_Marshal)(TPM2B_PUBLIC const *src, uint8_t buffer[], size_t buffer_size, size_t *offset) = NULL; TSS2_RC (*sym_Tss2_MU_TPM2B_PUBLIC_Unmarshal)(uint8_t const buffer[], size_t buffer_size, size_t *offset, TPM2B_PUBLIC *dest) = NULL; int dlopen_tpm2(void) { int r; r = dlopen_many_sym_or_warn( &libtss2_esys_dl, "libtss2-esys.so.0", LOG_DEBUG, DLSYM_ARG(Esys_Create), DLSYM_ARG(Esys_CreatePrimary), DLSYM_ARG(Esys_Finalize), DLSYM_ARG(Esys_FlushContext), DLSYM_ARG(Esys_Free), DLSYM_ARG(Esys_GetCapability), DLSYM_ARG(Esys_GetRandom), DLSYM_ARG(Esys_Initialize), DLSYM_ARG(Esys_Load), DLSYM_ARG(Esys_PCR_Read), DLSYM_ARG(Esys_PolicyGetDigest), DLSYM_ARG(Esys_PolicyPCR), DLSYM_ARG(Esys_StartAuthSession), DLSYM_ARG(Esys_Startup), DLSYM_ARG(Esys_Unseal)); if (r < 0) return r; r = dlopen_many_sym_or_warn( &libtss2_rc_dl, "libtss2-rc.so.0", LOG_DEBUG, DLSYM_ARG(Tss2_RC_Decode)); if (r < 0) return r; return dlopen_many_sym_or_warn( &libtss2_mu_dl, "libtss2-mu.so.0", LOG_DEBUG, DLSYM_ARG(Tss2_MU_TPM2B_PRIVATE_Marshal), DLSYM_ARG(Tss2_MU_TPM2B_PRIVATE_Unmarshal), DLSYM_ARG(Tss2_MU_TPM2B_PUBLIC_Marshal), DLSYM_ARG(Tss2_MU_TPM2B_PUBLIC_Unmarshal)); } struct tpm2_context { ESYS_CONTEXT *esys_context; void *tcti_dl; TSS2_TCTI_CONTEXT *tcti_context; }; static void tpm2_context_destroy(struct tpm2_context *c) { assert(c); if (c->esys_context) sym_Esys_Finalize(&c->esys_context); c->tcti_context = mfree(c->tcti_context); if (c->tcti_dl) { dlclose(c->tcti_dl); c->tcti_dl = NULL; } } static inline void Esys_Finalize_wrapper(ESYS_CONTEXT **c) { /* A wrapper around Esys_Finalize() for use with _cleanup_(). Only reasons we need this wrapper is * because the function itself warn logs if we'd pass a pointer to NULL, and we don't want that. */ if (*c) sym_Esys_Finalize(c); } static inline void Esys_Freep(void *p) { if (*(void**) p) sym_Esys_Free(*(void**) p); } static ESYS_TR flush_context_verbose(ESYS_CONTEXT *c, ESYS_TR handle) { TSS2_RC rc; if (!c || handle == ESYS_TR_NONE) return ESYS_TR_NONE; rc = sym_Esys_FlushContext(c, handle); if (rc != TSS2_RC_SUCCESS) /* We ignore failures here (besides debug logging), since this is called * in error paths, where we cannot do anything about failures anymore. And * when it is called in successful codepaths by this time we already did * what we wanted to do, and got the results we wanted so there's no * reason to make this fail more loudly than necessary. */ log_debug("Failed to get flush context of TPM, ignoring: %s", sym_Tss2_RC_Decode(rc)); return ESYS_TR_NONE; } static int tpm2_init(const char *device, struct tpm2_context *ret) { _cleanup_(Esys_Finalize_wrapper) ESYS_CONTEXT *c = NULL; _cleanup_free_ TSS2_TCTI_CONTEXT *tcti = NULL; _cleanup_(dlclosep) void *dl = NULL; TSS2_RC rc; int r; r = dlopen_tpm2(); if (r < 0) return log_error_errno(r, "TPM2 support not installed: %m"); if (!device) device = secure_getenv("SYSTEMD_TPM2_DEVICE"); if (device) { const char *param, *driver, *fn; const TSS2_TCTI_INFO* info; TSS2_TCTI_INFO_FUNC func; size_t sz = 0; param = strchr(device, ':'); if (param) { driver = strndupa_safe(device, param - device); param++; } else { driver = "device"; param = device; } fn = strjoina("libtss2-tcti-", driver, ".so.0"); dl = dlopen(fn, RTLD_NOW); if (!dl) return log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Failed to load %s: %s", fn, dlerror()); func = dlsym(dl, TSS2_TCTI_INFO_SYMBOL); if (!func) return log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Failed to find TCTI info symbol " TSS2_TCTI_INFO_SYMBOL ": %s", dlerror()); info = func(); if (!info) return log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Unable to get TCTI info data."); log_debug("Loaded TCTI module '%s' (%s) [Version %" PRIu32 "]", info->name, info->description, info->version); rc = info->init(NULL, &sz, NULL); if (rc != TPM2_RC_SUCCESS) return log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Failed to initialize TCTI context: %s", sym_Tss2_RC_Decode(rc)); tcti = malloc0(sz); if (!tcti) return log_oom(); rc = info->init(tcti, &sz, param); if (rc != TPM2_RC_SUCCESS) return log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Failed to initialize TCTI context: %s", sym_Tss2_RC_Decode(rc)); } rc = sym_Esys_Initialize(&c, tcti, NULL); if (rc != TSS2_RC_SUCCESS) return log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Failed to initialize TPM context: %s", sym_Tss2_RC_Decode(rc)); rc = sym_Esys_Startup(c, TPM2_SU_CLEAR); if (rc == TPM2_RC_INITIALIZE) log_debug("TPM already started up."); else if (rc == TSS2_RC_SUCCESS) log_debug("TPM successfully started up."); else return log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Failed to start up TPM: %s", sym_Tss2_RC_Decode(rc)); *ret = (struct tpm2_context) { .esys_context = TAKE_PTR(c), .tcti_context = TAKE_PTR(tcti), .tcti_dl = TAKE_PTR(dl), }; return 0; } static int tpm2_credit_random(ESYS_CONTEXT *c) { size_t rps, done = 0; TSS2_RC rc; int r; assert(c); /* Pulls some entropy from the TPM and adds it into the kernel RNG pool. That way we can say that the * key we will ultimately generate with the kernel random pool is at least as good as the TPM's RNG, * but likely better. Note that we don't trust the TPM RNG very much, hence do not actually credit * any entropy. */ for (rps = random_pool_size(); rps > 0;) { _cleanup_(Esys_Freep) TPM2B_DIGEST *buffer = NULL; rc = sym_Esys_GetRandom( c, ESYS_TR_NONE, ESYS_TR_NONE, ESYS_TR_NONE, MIN(rps, 32U), /* 32 is supposedly a safe choice, given that AES 256bit keys are this long, and TPM2 baseline requires support for those. */ &buffer); if (rc != TSS2_RC_SUCCESS) return log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Failed to acquire entropy from TPM: %s", sym_Tss2_RC_Decode(rc)); if (buffer->size == 0) return log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Zero-sized entropy returned from TPM."); r = random_write_entropy(-1, buffer->buffer, buffer->size, false); if (r < 0) return log_error_errno(r, "Failed wo write entropy to kernel: %m"); done += buffer->size; rps = LESS_BY(rps, buffer->size); } log_debug("Added %zu bytes of entropy to the kernel random pool.", done); return 0; } static int tpm2_make_primary( ESYS_CONTEXT *c, ESYS_TR *ret_primary, TPMI_ALG_PUBLIC alg, TPMI_ALG_PUBLIC *ret_alg) { static const TPM2B_SENSITIVE_CREATE primary_sensitive = {}; static const TPM2B_PUBLIC primary_template_ecc = { .size = sizeof(TPMT_PUBLIC), .publicArea = { .type = TPM2_ALG_ECC, .nameAlg = TPM2_ALG_SHA256, .objectAttributes = TPMA_OBJECT_RESTRICTED|TPMA_OBJECT_DECRYPT|TPMA_OBJECT_FIXEDTPM|TPMA_OBJECT_FIXEDPARENT|TPMA_OBJECT_SENSITIVEDATAORIGIN|TPMA_OBJECT_USERWITHAUTH, .parameters = { .eccDetail = { .symmetric = { .algorithm = TPM2_ALG_AES, .keyBits.aes = 128, .mode.aes = TPM2_ALG_CFB, }, .scheme.scheme = TPM2_ALG_NULL, .curveID = TPM2_ECC_NIST_P256, .kdf.scheme = TPM2_ALG_NULL, }, }, }, }; static const TPM2B_PUBLIC primary_template_rsa = { .size = sizeof(TPMT_PUBLIC), .publicArea = { .type = TPM2_ALG_RSA, .nameAlg = TPM2_ALG_SHA256, .objectAttributes = TPMA_OBJECT_RESTRICTED|TPMA_OBJECT_DECRYPT|TPMA_OBJECT_FIXEDTPM|TPMA_OBJECT_FIXEDPARENT|TPMA_OBJECT_SENSITIVEDATAORIGIN|TPMA_OBJECT_USERWITHAUTH, .parameters = { .rsaDetail = { .symmetric = { .algorithm = TPM2_ALG_AES, .keyBits.aes = 128, .mode.aes = TPM2_ALG_CFB, }, .scheme.scheme = TPM2_ALG_NULL, .keyBits = 2048, }, }, }, }; static const TPML_PCR_SELECTION creation_pcr = {}; ESYS_TR primary = ESYS_TR_NONE; TSS2_RC rc; usec_t ts; log_debug("Creating primary key on TPM."); /* So apparently not all TPM2 devices support ECC. ECC is generally preferably, because it's so much * faster, noticeably so (~10s vs. ~240ms on my system). Hence, unless explicitly configured let's * try to use ECC first, and if that does not work, let's fall back to RSA. */ ts = now(CLOCK_MONOTONIC); if (IN_SET(alg, 0, TPM2_ALG_ECC)) { rc = sym_Esys_CreatePrimary( c, ESYS_TR_RH_OWNER, ESYS_TR_PASSWORD, ESYS_TR_NONE, ESYS_TR_NONE, &primary_sensitive, &primary_template_ecc, NULL, &creation_pcr, &primary, NULL, NULL, NULL, NULL); if (rc != TSS2_RC_SUCCESS) { if (alg != 0) return log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Failed to generate ECC primary key in TPM: %s", sym_Tss2_RC_Decode(rc)); log_debug("Failed to generate ECC primary key in TPM, trying RSA: %s", sym_Tss2_RC_Decode(rc)); } else { log_debug("Successfully created ECC primary key on TPM."); alg = TPM2_ALG_ECC; } } if (IN_SET(alg, 0, TPM2_ALG_RSA)) { rc = sym_Esys_CreatePrimary( c, ESYS_TR_RH_OWNER, ESYS_TR_PASSWORD, ESYS_TR_NONE, ESYS_TR_NONE, &primary_sensitive, &primary_template_rsa, NULL, &creation_pcr, &primary, NULL, NULL, NULL, NULL); if (rc != TSS2_RC_SUCCESS) return log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Failed to generate RSA primary key in TPM: %s", sym_Tss2_RC_Decode(rc)); else if (alg == 0) { log_notice("TPM2 chip apparently does not support ECC primary keys, falling back to RSA. " "This likely means TPM2 operations will be relatively slow, please be patient."); alg = TPM2_ALG_RSA; } log_debug("Successfully created RSA primary key on TPM."); } log_debug("Generating primary key on TPM2 took %s.", FORMAT_TIMESPAN(now(CLOCK_MONOTONIC) - ts, USEC_PER_MSEC)); *ret_primary = primary; if (ret_alg) *ret_alg = alg; return 0; } static void tpm2_pcr_mask_to_selecion(uint32_t mask, uint16_t bank, TPML_PCR_SELECTION *ret) { assert(ret); /* We only do 24bit here, as that's what PC TPMs are supposed to support */ assert(mask <= 0xFFFFFFU); *ret = (TPML_PCR_SELECTION) { .count = 1, .pcrSelections[0].hash = bank, .pcrSelections[0].sizeofSelect = 3, .pcrSelections[0].pcrSelect[0] = mask & 0xFF, .pcrSelections[0].pcrSelect[1] = (mask >> 8) & 0xFF, .pcrSelections[0].pcrSelect[2] = (mask >> 16) & 0xFF, }; } static unsigned find_nth_bit(uint32_t mask, unsigned n) { uint32_t bit = 1; assert(n < 32); /* Returns the bit index of the nth set bit, e.g. mask=0b101001, n=3 → 5 */ for (unsigned i = 0; i < sizeof(mask)*8; i++) { if (bit & mask) { if (n == 0) return i; n--; } bit <<= 1; } return UINT_MAX; } static int tpm2_pcr_mask_good( ESYS_CONTEXT *c, TPMI_ALG_HASH bank, uint32_t mask) { _cleanup_(Esys_Freep) TPML_DIGEST *pcr_values = NULL; TPML_PCR_SELECTION selection; bool good = false; TSS2_RC rc; assert(c); /* So we have the problem that some systems might have working TPM2 chips, but the firmware doesn't * actually measure into them, or only into a suboptimal bank. If so, the PCRs should be all zero or * all 0xFF. Detect that, so that we can warn and maybe pick a better bank. */ tpm2_pcr_mask_to_selecion(mask, bank, &selection); rc = sym_Esys_PCR_Read( c, ESYS_TR_NONE, ESYS_TR_NONE, ESYS_TR_NONE, &selection, NULL, NULL, &pcr_values); if (rc != TSS2_RC_SUCCESS) return log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Failed to read TPM2 PCRs: %s", sym_Tss2_RC_Decode(rc)); /* If at least one of the selected PCR values is something other than all 0x00 or all 0xFF we are happy. */ for (unsigned i = 0; i < pcr_values->count; i++) { if (DEBUG_LOGGING) { _cleanup_free_ char *h = NULL; unsigned j; h = hexmem(pcr_values->digests[i].buffer, pcr_values->digests[i].size); j = find_nth_bit(mask, i); assert(j != UINT_MAX); log_debug("PCR %u value: %s", j, strna(h)); } if (!memeqbyte(0x00, pcr_values->digests[i].buffer, pcr_values->digests[i].size) && !memeqbyte(0xFF, pcr_values->digests[i].buffer, pcr_values->digests[i].size)) good = true; } return good; } static int tpm2_get_best_pcr_bank( ESYS_CONTEXT *c, uint32_t pcr_mask, TPMI_ALG_HASH *ret) { _cleanup_(Esys_Freep) TPMS_CAPABILITY_DATA *pcap = NULL; TPMI_ALG_HASH supported_hash = 0, hash_with_valid_pcr = 0; TPMI_YES_NO more; TSS2_RC rc; assert(c); rc = sym_Esys_GetCapability( c, ESYS_TR_NONE, ESYS_TR_NONE, ESYS_TR_NONE, TPM2_CAP_PCRS, 0, 1, &more, &pcap); if (rc != TSS2_RC_SUCCESS) return log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Failed to determine TPM2 PCR bank capabilities: %s", sym_Tss2_RC_Decode(rc)); assert(pcap->capability == TPM2_CAP_PCRS); for (size_t i = 0; i < pcap->data.assignedPCR.count; i++) { bool valid = true; int good; /* For now we are only interested in the SHA1 and SHA256 banks */ if (!IN_SET(pcap->data.assignedPCR.pcrSelections[i].hash, TPM2_ALG_SHA256, TPM2_ALG_SHA1)) continue; /* As per * https://trustedcomputinggroup.org/wp-content/uploads/TCG_PCClient_PFP_r1p05_v23_pub.pdf a * TPM2 on a Client PC must have at least 24 PCRs. If this TPM has less, just skip over * it. */ if (pcap->data.assignedPCR.pcrSelections[i].sizeofSelect < TPM2_PCRS_MAX/8) { log_debug("Skipping TPM2 PCR bank %s with fewer than 24 PCRs.", strna(tpm2_pcr_bank_to_string(pcap->data.assignedPCR.pcrSelections[i].hash))); continue; } assert_cc(TPM2_PCRS_MAX % 8 == 0); /* It's not enough to check how many PCRs there are, we also need to check that the 24 are * enabled for this bank. Otherwise this TPM doesn't qualify. */ for (size_t j = 0; j < TPM2_PCRS_MAX/8; j++) if (pcap->data.assignedPCR.pcrSelections[i].pcrSelect[j] != 0xFF) { valid = false; break; } if (!valid) { log_debug("TPM2 PCR bank %s has fewer than 24 PCR bits enabled, ignoring.", strna(tpm2_pcr_bank_to_string(pcap->data.assignedPCR.pcrSelections[i].hash))); continue; } good = tpm2_pcr_mask_good(c, pcap->data.assignedPCR.pcrSelections[i].hash, pcr_mask); if (good < 0) return good; if (pcap->data.assignedPCR.pcrSelections[i].hash == TPM2_ALG_SHA256) { supported_hash = TPM2_ALG_SHA256; if (good) { /* Great, SHA256 is supported and has initialized PCR values, we are done. */ hash_with_valid_pcr = TPM2_ALG_SHA256; break; } } else { assert(pcap->data.assignedPCR.pcrSelections[i].hash == TPM2_ALG_SHA1); if (supported_hash == 0) supported_hash = TPM2_ALG_SHA1; if (good && hash_with_valid_pcr == 0) hash_with_valid_pcr = TPM2_ALG_SHA1; } } /* We preferably pick SHA256, but only if its PCRs are initialized or neither the SHA1 nor the SHA256 * PCRs are initialized. If SHA256 is not supported but SHA1 is and its PCRs are too, we prefer * SHA1. * * We log at LOG_NOTICE level whenever we end up using the SHA1 bank or when the PCRs we bind to are * not initialized. */ if (hash_with_valid_pcr == TPM2_ALG_SHA256) { assert(supported_hash == TPM2_ALG_SHA256); log_debug("TPM2 device supports SHA256 PCR bank and SHA256 PCRs are valid, yay!"); *ret = TPM2_ALG_SHA256; } else if (hash_with_valid_pcr == TPM2_ALG_SHA1) { if (supported_hash == TPM2_ALG_SHA256) log_notice("TPM2 device supports both SHA1 and SHA256 PCR banks, but only SHA1 PCRs are valid, falling back to SHA1 bank. This reduces the security level substantially."); else { assert(supported_hash == TPM2_ALG_SHA1); log_notice("TPM2 device lacks support for SHA256 PCR bank, but SHA1 bank is supported and SHA1 PCRs are valid, falling back to SHA1 bank. This reduces the security level substantially."); } *ret = TPM2_ALG_SHA1; } else if (supported_hash == TPM2_ALG_SHA256) { log_notice("TPM2 device supports SHA256 PCR bank but none of the selected PCRs are valid! Firmware apparently did not initialize any of the selected PCRs. Proceeding anyway with SHA256 bank. PCR policy effectively unenforced!"); *ret = TPM2_ALG_SHA256; } else if (supported_hash == TPM2_ALG_SHA1) { log_notice("TPM2 device lacks support for SHA256 bank, but SHA1 bank is supported, but none of the selected PCRs are valid! Firmware apparently did not initialize any of the selected PCRs. Proceeding anyway with SHA1 bank. PCR policy effectively unenforced!"); *ret = TPM2_ALG_SHA1; } else return log_error_errno(SYNTHETIC_ERRNO(EOPNOTSUPP), "TPM2 module supports neither SHA1 nor SHA256 PCR banks, cannot operate."); return 0; } static int tpm2_make_pcr_session( ESYS_CONTEXT *c, uint32_t pcr_mask, uint16_t pcr_bank, /* If UINT16_MAX, pick best bank automatically, otherwise specify bank explicitly. */ ESYS_TR *ret_session, TPM2B_DIGEST **ret_policy_digest, TPMI_ALG_HASH *ret_pcr_bank) { static const TPMT_SYM_DEF symmetric = { .algorithm = TPM2_ALG_AES, .keyBits = { .aes = 128 }, .mode = { .aes = TPM2_ALG_CFB, } }; _cleanup_(Esys_Freep) TPM2B_DIGEST *policy_digest = NULL; TPML_PCR_SELECTION pcr_selection; ESYS_TR session = ESYS_TR_NONE; TSS2_RC rc; int r; assert(c); log_debug("Starting authentication session."); if (pcr_bank != UINT16_MAX) { r = tpm2_pcr_mask_good(c, pcr_bank, pcr_mask); if (r < 0) return r; if (r == 0) log_notice("Selected TPM2 PCRs are not initialized on this system, most likely due to a firmware issue. PCR policy is effectively not enforced. Proceeding anyway."); tpm2_pcr_mask_to_selecion(pcr_mask, pcr_bank, &pcr_selection); } else { TPMI_ALG_HASH h; /* No bank configured, pick automatically. Some TPM2 devices only can do SHA1. If we detect * that use that, but preferably use SHA256 */ r = tpm2_get_best_pcr_bank(c, pcr_mask, &h); if (r < 0) return r; tpm2_pcr_mask_to_selecion(pcr_mask, h, &pcr_selection); } rc = sym_Esys_StartAuthSession( c, ESYS_TR_NONE, ESYS_TR_NONE, ESYS_TR_NONE, ESYS_TR_NONE, ESYS_TR_NONE, NULL, TPM2_SE_POLICY, &symmetric, TPM2_ALG_SHA256, &session); if (rc != TSS2_RC_SUCCESS) return log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Failed to open session in TPM: %s", sym_Tss2_RC_Decode(rc)); log_debug("Configuring PCR policy."); rc = sym_Esys_PolicyPCR( c, session, ESYS_TR_NONE, ESYS_TR_NONE, ESYS_TR_NONE, NULL, &pcr_selection); if (rc != TSS2_RC_SUCCESS) { r = log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Failed to add PCR policy to TPM: %s", sym_Tss2_RC_Decode(rc)); goto finish; } if (DEBUG_LOGGING || ret_policy_digest) { log_debug("Acquiring policy digest."); rc = sym_Esys_PolicyGetDigest( c, session, ESYS_TR_NONE, ESYS_TR_NONE, ESYS_TR_NONE, &policy_digest); if (rc != TSS2_RC_SUCCESS) { r = log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Failed to get policy digest from TPM: %s", sym_Tss2_RC_Decode(rc)); goto finish; } if (DEBUG_LOGGING) { _cleanup_free_ char *h = NULL; h = hexmem(policy_digest->buffer, policy_digest->size); if (!h) { r = log_oom(); goto finish; } log_debug("Session policy digest: %s", h); } } if (ret_session) { *ret_session = session; session = ESYS_TR_NONE; } if (ret_policy_digest) *ret_policy_digest = TAKE_PTR(policy_digest); if (ret_pcr_bank) *ret_pcr_bank = pcr_selection.pcrSelections[0].hash; r = 0; finish: session = flush_context_verbose(c, session); return r; } int tpm2_seal( const char *device, uint32_t pcr_mask, void **ret_secret, size_t *ret_secret_size, void **ret_blob, size_t *ret_blob_size, void **ret_pcr_hash, size_t *ret_pcr_hash_size, uint16_t *ret_pcr_bank, uint16_t *ret_primary_alg) { _cleanup_(tpm2_context_destroy) struct tpm2_context c = {}; _cleanup_(Esys_Freep) TPM2B_DIGEST *policy_digest = NULL; _cleanup_(Esys_Freep) TPM2B_PRIVATE *private = NULL; _cleanup_(Esys_Freep) TPM2B_PUBLIC *public = NULL; static const TPML_PCR_SELECTION creation_pcr = {}; _cleanup_(erase_and_freep) void *secret = NULL; _cleanup_free_ void *blob = NULL, *hash = NULL; TPM2B_SENSITIVE_CREATE hmac_sensitive; ESYS_TR primary = ESYS_TR_NONE; TPMI_ALG_PUBLIC primary_alg; TPM2B_PUBLIC hmac_template; TPMI_ALG_HASH pcr_bank; size_t k, blob_size; usec_t start; TSS2_RC rc; int r; assert(ret_secret); assert(ret_secret_size); assert(ret_blob); assert(ret_blob_size); assert(ret_pcr_hash); assert(ret_pcr_hash_size); assert(ret_pcr_bank); assert(pcr_mask < (UINT32_C(1) << TPM2_PCRS_MAX)); /* Support 24 PCR banks */ /* So here's what we do here: we connect to the TPM2 chip. It persistently contains a "seed" key that * is randomized when the TPM2 is first initialized or reset and remains stable across boots. We * generate a "primary" key pair derived from that (ECC if possible, RSA as fallback). Given the seed * remains fixed this will result in the same key pair whenever we specify the exact same parameters * for it. We then create a PCR-bound policy session, which calculates a hash on the current PCR * values of the indexes we specify. We then generate a randomized key on the host (which is the key * we actually enroll in the LUKS2 keyslots), which we upload into the TPM2, where it is encrypted * with the "primary" key, taking the PCR policy session into account. We then download the encrypted * key from the TPM2 ("sealing") and marshall it into binary form, which is ultimately placed in the * LUKS2 JSON header. * * The TPM2 "seed" key and "primary" keys never leave the TPM2 chip (and cannot be extracted at * all). The random key we enroll in LUKS2 we generate on the host using the Linux random device. It * is stored in the LUKS2 JSON only in encrypted form with the "primary" key of the TPM2 chip, thus * binding the unlocking to the TPM2 chip. */ start = now(CLOCK_MONOTONIC); r = tpm2_init(device, &c); if (r < 0) return r; r = tpm2_make_primary(c.esys_context, &primary, 0, &primary_alg); if (r < 0) return r; r = tpm2_make_pcr_session(c.esys_context, pcr_mask, UINT16_MAX, NULL, &policy_digest, &pcr_bank); if (r < 0) goto finish; /* We use a keyed hash object (i.e. HMAC) to store the secret key we want to use for unlocking the * LUKS2 volume with. We don't ever use for HMAC/keyed hash operations however, we just use it * because it's a key type that is universally supported and suitable for symmetric binary blobs. */ hmac_template = (TPM2B_PUBLIC) { .size = sizeof(TPMT_PUBLIC), .publicArea = { .type = TPM2_ALG_KEYEDHASH, .nameAlg = TPM2_ALG_SHA256, .objectAttributes = TPMA_OBJECT_FIXEDTPM | TPMA_OBJECT_FIXEDPARENT, .parameters = { .keyedHashDetail = { .scheme.scheme = TPM2_ALG_NULL, }, }, .unique = { .keyedHash = { .size = 32, }, }, .authPolicy = *policy_digest, }, }; hmac_sensitive = (TPM2B_SENSITIVE_CREATE) { .size = sizeof(hmac_sensitive.sensitive), .sensitive.data.size = 32, }; assert(sizeof(hmac_sensitive.sensitive.data.buffer) >= hmac_sensitive.sensitive.data.size); (void) tpm2_credit_random(c.esys_context); log_debug("Generating secret key data."); r = genuine_random_bytes(hmac_sensitive.sensitive.data.buffer, hmac_sensitive.sensitive.data.size, RANDOM_BLOCK); if (r < 0) { log_error_errno(r, "Failed to generate secret key: %m"); goto finish; } log_debug("Creating HMAC key."); rc = sym_Esys_Create( c.esys_context, primary, ESYS_TR_PASSWORD, ESYS_TR_NONE, ESYS_TR_NONE, &hmac_sensitive, &hmac_template, NULL, &creation_pcr, &private, &public, NULL, NULL, NULL); if (rc != TSS2_RC_SUCCESS) { r = log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Failed to generate HMAC key in TPM: %s", sym_Tss2_RC_Decode(rc)); goto finish; } secret = memdup(hmac_sensitive.sensitive.data.buffer, hmac_sensitive.sensitive.data.size); explicit_bzero_safe(hmac_sensitive.sensitive.data.buffer, hmac_sensitive.sensitive.data.size); if (!secret) { r = log_oom(); goto finish; } log_debug("Marshalling private and public part of HMAC key."); k = ALIGN8(sizeof(*private)) + ALIGN8(sizeof(*public)); /* Some roughly sensible start value */ for (;;) { _cleanup_free_ void *buf = NULL; size_t offset = 0; buf = malloc(k); if (!buf) { r = log_oom(); goto finish; } rc = sym_Tss2_MU_TPM2B_PRIVATE_Marshal(private, buf, k, &offset); if (rc == TSS2_RC_SUCCESS) { rc = sym_Tss2_MU_TPM2B_PUBLIC_Marshal(public, buf, k, &offset); if (rc == TSS2_RC_SUCCESS) { blob = TAKE_PTR(buf); blob_size = offset; break; } } if (rc != TSS2_MU_RC_INSUFFICIENT_BUFFER) { r = log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Failed to marshal private/public key: %s", sym_Tss2_RC_Decode(rc)); goto finish; } if (k > SIZE_MAX / 2) { r = log_oom(); goto finish; } k *= 2; } hash = memdup(policy_digest->buffer, policy_digest->size); if (!hash) return log_oom(); if (DEBUG_LOGGING) log_debug("Completed TPM2 key sealing in %s.", FORMAT_TIMESPAN(now(CLOCK_MONOTONIC) - start, 1)); *ret_secret = TAKE_PTR(secret); *ret_secret_size = hmac_sensitive.sensitive.data.size; *ret_blob = TAKE_PTR(blob); *ret_blob_size = blob_size; *ret_pcr_hash = TAKE_PTR(hash); *ret_pcr_hash_size = policy_digest->size; *ret_pcr_bank = pcr_bank; *ret_primary_alg = primary_alg; r = 0; finish: primary = flush_context_verbose(c.esys_context, primary); return r; } int tpm2_unseal( const char *device, uint32_t pcr_mask, uint16_t pcr_bank, uint16_t primary_alg, const void *blob, size_t blob_size, const void *known_policy_hash, size_t known_policy_hash_size, void **ret_secret, size_t *ret_secret_size) { _cleanup_(tpm2_context_destroy) struct tpm2_context c = {}; ESYS_TR primary = ESYS_TR_NONE, session = ESYS_TR_NONE, hmac_key = ESYS_TR_NONE; _cleanup_(Esys_Freep) TPM2B_SENSITIVE_DATA* unsealed = NULL; _cleanup_(Esys_Freep) TPM2B_DIGEST *policy_digest = NULL; _cleanup_(erase_and_freep) char *secret = NULL; TPM2B_PRIVATE private = {}; TPM2B_PUBLIC public = {}; size_t offset = 0; TSS2_RC rc; usec_t start; int r; assert(blob); assert(blob_size > 0); assert(known_policy_hash_size == 0 || known_policy_hash); assert(ret_secret); assert(ret_secret_size); assert(pcr_mask < (UINT32_C(1) << TPM2_PCRS_MAX)); /* Support 24 PCR banks */ r = dlopen_tpm2(); if (r < 0) return log_error_errno(r, "TPM2 support is not installed."); /* So here's what we do here: We connect to the TPM2 chip. As we do when sealing we generate a * "primary" key on the TPM2 chip, with the same parameters as well as a PCR-bound policy * session. Given we pass the same parameters, this will result in the same "primary" key, and same * policy hash (the latter of course, only if the PCR values didn't change in between). We unmarshal * the encrypted key we stored in the LUKS2 JSON token header and upload it into the TPM2, where it * is decrypted if the seed and the PCR policy were right ("unsealing"). We then download the result, * and use it to unlock the LUKS2 volume. */ start = now(CLOCK_MONOTONIC); log_debug("Unmarshalling private part of HMAC key."); rc = sym_Tss2_MU_TPM2B_PRIVATE_Unmarshal(blob, blob_size, &offset, &private); if (rc != TSS2_RC_SUCCESS) return log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Failed to unmarshal private key: %s", sym_Tss2_RC_Decode(rc)); log_debug("Unmarshalling public part of HMAC key."); rc = sym_Tss2_MU_TPM2B_PUBLIC_Unmarshal(blob, blob_size, &offset, &public); if (rc != TSS2_RC_SUCCESS) return log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Failed to unmarshal public key: %s", sym_Tss2_RC_Decode(rc)); r = tpm2_init(device, &c); if (r < 0) return r; r = tpm2_make_pcr_session(c.esys_context, pcr_mask, pcr_bank, &session, &policy_digest, NULL); if (r < 0) goto finish; /* If we know the policy hash to expect, and it doesn't match, we can shortcut things here, and not * wait until the TPM2 tells us to go away. */ if (known_policy_hash_size > 0 && memcmp_nn(policy_digest->buffer, policy_digest->size, known_policy_hash, known_policy_hash_size) != 0) return log_error_errno(SYNTHETIC_ERRNO(EPERM), "Current policy digest does not match stored policy digest, cancelling TPM2 authentication attempt."); r = tpm2_make_primary(c.esys_context, &primary, primary_alg, NULL); if (r < 0) return r; log_debug("Loading HMAC key into TPM."); rc = sym_Esys_Load( c.esys_context, primary, ESYS_TR_PASSWORD, ESYS_TR_NONE, ESYS_TR_NONE, &private, &public, &hmac_key); if (rc != TSS2_RC_SUCCESS) { r = log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Failed to load HMAC key in TPM: %s", sym_Tss2_RC_Decode(rc)); goto finish; } log_debug("Unsealing HMAC key."); rc = sym_Esys_Unseal( c.esys_context, hmac_key, session, ESYS_TR_NONE, ESYS_TR_NONE, &unsealed); if (rc != TSS2_RC_SUCCESS) { r = log_error_errno(SYNTHETIC_ERRNO(ENOTRECOVERABLE), "Failed to unseal HMAC key in TPM: %s", sym_Tss2_RC_Decode(rc)); goto finish; } secret = memdup(unsealed->buffer, unsealed->size); explicit_bzero_safe(unsealed->buffer, unsealed->size); if (!secret) { r = log_oom(); goto finish; } if (DEBUG_LOGGING) log_debug("Completed TPM2 key unsealing in %s.", FORMAT_TIMESPAN(now(CLOCK_MONOTONIC) - start, 1)); *ret_secret = TAKE_PTR(secret); *ret_secret_size = unsealed->size; r = 0; finish: primary = flush_context_verbose(c.esys_context, primary); session = flush_context_verbose(c.esys_context, session); hmac_key = flush_context_verbose(c.esys_context, hmac_key); return r; } #endif int tpm2_list_devices(void) { #if HAVE_TPM2 _cleanup_(table_unrefp) Table *t = NULL; _cleanup_(closedirp) DIR *d = NULL; int r; r = dlopen_tpm2(); if (r < 0) return log_error_errno(r, "TPM2 support is not installed."); t = table_new("path", "device", "driver"); if (!t) return log_oom(); d = opendir("/sys/class/tpmrm"); if (!d) { log_full_errno(errno == ENOENT ? LOG_DEBUG : LOG_ERR, errno, "Failed to open /sys/class/tpmrm: %m"); if (errno != ENOENT) return -errno; } else { for (;;) { _cleanup_free_ char *device_path = NULL, *device = NULL, *driver_path = NULL, *driver = NULL, *node = NULL; struct dirent *de; de = readdir_no_dot(d); if (!de) break; device_path = path_join("/sys/class/tpmrm", de->d_name, "device"); if (!device_path) return log_oom(); r = readlink_malloc(device_path, &device); if (r < 0) log_debug_errno(r, "Failed to read device symlink %s, ignoring: %m", device_path); else { driver_path = path_join(device_path, "driver"); if (!driver_path) return log_oom(); r = readlink_malloc(driver_path, &driver); if (r < 0) log_debug_errno(r, "Failed to read driver symlink %s, ignoring: %m", driver_path); } node = path_join("/dev", de->d_name); if (!node) return log_oom(); r = table_add_many( t, TABLE_PATH, node, TABLE_STRING, device ? last_path_component(device) : NULL, TABLE_STRING, driver ? last_path_component(driver) : NULL); if (r < 0) return table_log_add_error(r); } } if (table_get_rows(t) <= 1) { log_info("No suitable TPM2 devices found."); return 0; } r = table_print(t, stdout); if (r < 0) return log_error_errno(r, "Failed to show device table: %m"); return 0; #else return log_error_errno(SYNTHETIC_ERRNO(EOPNOTSUPP), "TPM2 not supported on this build."); #endif } int tpm2_find_device_auto( int log_level, /* log level when no device is found */ char **ret) { #if HAVE_TPM2 _cleanup_(closedirp) DIR *d = NULL; int r; r = dlopen_tpm2(); if (r < 0) return log_error_errno(r, "TPM2 support is not installed."); d = opendir("/sys/class/tpmrm"); if (!d) { log_full_errno(errno == ENOENT ? LOG_DEBUG : LOG_ERR, errno, "Failed to open /sys/class/tpmrm: %m"); if (errno != ENOENT) return -errno; } else { _cleanup_free_ char *node = NULL; for (;;) { struct dirent *de; de = readdir_no_dot(d); if (!de) break; if (node) return log_error_errno(SYNTHETIC_ERRNO(ENOTUNIQ), "More than one TPM2 (tpmrm) device found."); node = path_join("/dev", de->d_name); if (!node) return log_oom(); } if (node) { *ret = TAKE_PTR(node); return 0; } } return log_full_errno(log_level, SYNTHETIC_ERRNO(ENODEV), "No TPM2 (tpmrm) device found."); #else return log_error_errno(SYNTHETIC_ERRNO(EOPNOTSUPP), "TPM2 not supported on this build."); #endif } int tpm2_parse_pcrs(const char *s, uint32_t *ret) { const char *p = s; uint32_t mask = 0; int r; assert(s); if (isempty(s)) { *ret = 0; return 0; } /* Parses a "," or "+" separated list of PCR indexes. We support "," since this is a list after all, * and most other tools expect comma separated PCR specifications. We also support "+" since in * /etc/crypttab the "," is already used to separate options, hence a different separator is nice to * avoid escaping. */ for (;;) { _cleanup_free_ char *pcr = NULL; unsigned n; r = extract_first_word(&p, &pcr, ",+", EXTRACT_DONT_COALESCE_SEPARATORS); if (r == 0) break; if (r < 0) return log_error_errno(r, "Failed to parse PCR list: %s", s); r = safe_atou(pcr, &n); if (r < 0) return log_error_errno(r, "Failed to parse PCR number: %s", pcr); if (n >= TPM2_PCRS_MAX) return log_error_errno(SYNTHETIC_ERRNO(ERANGE), "PCR number out of range (valid range 0…23): %u", n); mask |= UINT32_C(1) << n; } *ret = mask; return 0; } int tpm2_make_luks2_json( int keyslot, uint32_t pcr_mask, uint16_t pcr_bank, uint16_t primary_alg, const void *blob, size_t blob_size, const void *policy_hash, size_t policy_hash_size, JsonVariant **ret) { _cleanup_(json_variant_unrefp) JsonVariant *v = NULL, *a = NULL; _cleanup_free_ char *keyslot_as_string = NULL; JsonVariant* pcr_array[TPM2_PCRS_MAX]; unsigned n_pcrs = 0; int r; assert(blob || blob_size == 0); assert(policy_hash || policy_hash_size == 0); if (asprintf(&keyslot_as_string, "%i", keyslot) < 0) return -ENOMEM; for (unsigned i = 0; i < ELEMENTSOF(pcr_array); i++) { if ((pcr_mask & (UINT32_C(1) << i)) == 0) continue; r = json_variant_new_integer(pcr_array + n_pcrs, i); if (r < 0) { json_variant_unref_many(pcr_array, n_pcrs); return -ENOMEM; } n_pcrs++; } r = json_variant_new_array(&a, pcr_array, n_pcrs); json_variant_unref_many(pcr_array, n_pcrs); if (r < 0) return -ENOMEM; r = json_build(&v, JSON_BUILD_OBJECT( JSON_BUILD_PAIR("type", JSON_BUILD_STRING("systemd-tpm2")), JSON_BUILD_PAIR("keyslots", JSON_BUILD_ARRAY(JSON_BUILD_STRING(keyslot_as_string))), JSON_BUILD_PAIR("tpm2-blob", JSON_BUILD_BASE64(blob, blob_size)), JSON_BUILD_PAIR("tpm2-pcrs", JSON_BUILD_VARIANT(a)), JSON_BUILD_PAIR_CONDITION(!!tpm2_pcr_bank_to_string(pcr_bank), "tpm2-pcr-bank", JSON_BUILD_STRING(tpm2_pcr_bank_to_string(pcr_bank))), JSON_BUILD_PAIR_CONDITION(!!tpm2_primary_alg_to_string(primary_alg), "tpm2-primary-alg", JSON_BUILD_STRING(tpm2_primary_alg_to_string(primary_alg))), JSON_BUILD_PAIR("tpm2-policy-hash", JSON_BUILD_HEX(policy_hash, policy_hash_size)))); if (r < 0) return r; if (ret) *ret = TAKE_PTR(v); return keyslot; } const char *tpm2_pcr_bank_to_string(uint16_t bank) { /* For now, let's officially only support these two. We can extend this later on, should the need * arise. */ if (bank == TPM2_ALG_SHA256) return "sha256"; if (bank == TPM2_ALG_SHA1) return "sha1"; return NULL; } int tpm2_pcr_bank_from_string(const char *bank) { if (streq_ptr(bank, "sha256")) return TPM2_ALG_SHA256; if (streq_ptr(bank, "sha1")) return TPM2_ALG_SHA1; return -EINVAL; } const char *tpm2_primary_alg_to_string(uint16_t alg) { if (alg == TPM2_ALG_ECC) return "ecc"; if (alg == TPM2_ALG_RSA) return "rsa"; return NULL; } int tpm2_primary_alg_from_string(const char *alg) { if (streq_ptr(alg, "ecc")) return TPM2_ALG_ECC; if (streq_ptr(alg, "rsa")) return TPM2_ALG_RSA; return -EINVAL; }