/** * DOC: dcp blob format * * The Data Co-Processor (DCP) provides hardware-bound AES keys using its * AES encryption engine only. It does not provide direct key sealing/unsealing. * To make DCP hardware encryption keys usable as trust source, we define * our own custom format that uses a hardware-bound key to secure the sealing * key stored in the key blob. * * Whenever a new trusted key using DCP is generated, we generate a random 128-bit * blob encryption key (BEK) and 128-bit nonce. The BEK and nonce are used to * encrypt the trusted key payload using AES-128-GCM. * * The BEK itself is encrypted using the hardware-bound key using the DCP's AES * encryption engine with AES-128-ECB. The encrypted BEK, generated nonce, * BEK-encrypted payload and authentication tag make up the blob format together * with a version number, payload length and authentication tag.
*/
/** * struct dcp_blob_fmt - DCP BLOB format. * * @fmt_version: Format version, currently being %1. * @blob_key: Random AES 128 key which is used to encrypt @payload, * @blob_key itself is encrypted with OTP or UNIQUE device key in * AES-128-ECB mode by DCP. * @nonce: Random nonce used for @payload encryption. * @payload_len: Length of the plain text @payload. * @payload: The payload itself, encrypted using AES-128-GCM and @blob_key, * GCM auth tag of size DCP_BLOB_AUTHLEN is attached at the end of it. * * The total size of a DCP BLOB is sizeof(struct dcp_blob_fmt) + @payload_len + * DCP_BLOB_AUTHLEN.
*/ struct dcp_blob_fmt {
__u8 fmt_version;
__u8 blob_key[AES_KEYSIZE_128];
__u8 nonce[AES_KEYSIZE_128];
__le32 payload_len;
__u8 payload[];
} __packed;
staticbool use_otp_key;
module_param_named(dcp_use_otp_key, use_otp_key, bool, 0);
MODULE_PARM_DESC(dcp_use_otp_key, "Use OTP instead of UNIQUE key for sealing");
staticbool skip_zk_test;
module_param_named(dcp_skip_zk_test, skip_zk_test, bool, 0);
MODULE_PARM_DESC(dcp_skip_zk_test, "Don't test whether device keys are zero'ed");
aead = crypto_alloc_aead("gcm(aes)", 0, CRYPTO_ALG_ASYNC); if (IS_ERR(aead)) {
ret = PTR_ERR(aead); goto out;
}
ret = crypto_aead_setauthsize(aead, DCP_BLOB_AUTHLEN); if (ret < 0) {
pr_err("Can't set crypto auth tag len: %d\n", ret); goto free_aead;
}
aead_req = aead_request_alloc(aead, GFP_KERNEL); if (!aead_req) {
ret = -ENOMEM; goto free_aead;
}
sg_init_one(&src_sg, in, len); if (do_encrypt) { /* * If we encrypt our buffer has extra space for the auth tag.
*/
sg_init_one(&dst_sg, out, len + DCP_BLOB_AUTHLEN);
} else {
sg_init_one(&dst_sg, out, len);
}
if (b->fmt_version != DCP_BLOB_VERSION) {
pr_err("DCP blob has bad version: %i, expected %i\n",
b->fmt_version, DCP_BLOB_VERSION);
ret = -EINVAL; goto out;
}
p->key_len = le32_to_cpu(b->payload_len);
blen = calc_blob_len(p->key_len); if (blen != p->blob_len) {
pr_err("DCP blob has bad length: %i != %i\n", blen,
p->blob_len);
ret = -EINVAL; goto out;
}
plain_blob_key = kmalloc(AES_KEYSIZE_128, GFP_KERNEL); if (!plain_blob_key) {
ret = -ENOMEM; goto out;
}
ret = decrypt_blob_key(b->blob_key, plain_blob_key); if (ret) {
pr_err("Unable to decrypt blob key: %i\n", ret); goto out;
}
ret = do_aead_crypto(b->payload, p->key, p->key_len + DCP_BLOB_AUTHLEN,
plain_blob_key, b->nonce, false); if (ret) {
pr_err("Unwrap of DCP payload failed: %i\n", ret); goto out;
}
ret = 0;
out: if (plain_blob_key) {
memzero_explicit(plain_blob_key, AES_KEYSIZE_128);
kfree(plain_blob_key);
}
return ret;
}
staticint test_for_zero_key(void)
{ /* * Encrypting a plaintext of all 0x55 bytes will yield * this ciphertext in case the DCP test key is used.
*/ staticconst u8 bad[] = {0x9a, 0xda, 0xe0, 0x54, 0xf6, 0x3d, 0xfa, 0xff,
0x5e, 0xa1, 0x8e, 0x45, 0xed, 0xf6, 0xea, 0x6f}; void *buf = NULL; int ret = 0;
if (skip_zk_test) goto out;
buf = kmalloc(AES_BLOCK_SIZE, GFP_KERNEL); if (!buf) {
ret = -ENOMEM; goto out;
}
memset(buf, 0x55, AES_BLOCK_SIZE);
ret = do_dcp_crypto(buf, buf, true); if (ret) goto out;
if (memcmp(buf, bad, AES_BLOCK_SIZE) == 0) {
pr_warn("Device neither in secure nor trusted mode!\n");
ret = -EINVAL;
}
out:
kfree(buf); return ret;
}
staticint trusted_dcp_init(void)
{ int ret;
if (use_otp_key)
pr_info("Using DCP OTP key\n");
ret = test_for_zero_key(); if (ret) {
pr_warn("Test for zero'ed keys failed: %i\n", ret);
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung und die Messung sind noch experimentell.