xref: /linux/security/keys/encrypted-keys/encrypted.c (revision 8697c431e297eb0d0ab13dda6bc172b48a34f05c)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  * Copyright (C) 2010 IBM Corporation
4  * Copyright (C) 2010 Politecnico di Torino, Italy
5  *                    TORSEC group -- https://security.polito.it
6  *
7  * Authors:
8  * Mimi Zohar <zohar@us.ibm.com>
9  * Roberto Sassu <roberto.sassu@polito.it>
10  *
11  * See Documentation/security/keys/trusted-encrypted.rst
12  */
13 
14 #include <linux/uaccess.h>
15 #include <linux/module.h>
16 #include <linux/hex.h>
17 #include <linux/init.h>
18 #include <linux/slab.h>
19 #include <linux/parser.h>
20 #include <linux/string.h>
21 #include <linux/err.h>
22 #include <linux/overflow.h>
23 #include <keys/user-type.h>
24 #include <keys/trusted-type.h>
25 #include <keys/encrypted-type.h>
26 #include <linux/key-type.h>
27 #include <linux/random.h>
28 #include <linux/rcupdate.h>
29 #include <linux/scatterlist.h>
30 #include <linux/ctype.h>
31 #include <crypto/aes.h>
32 #include <crypto/sha2.h>
33 #include <crypto/skcipher.h>
34 #include <crypto/utils.h>
35 
36 #include "encrypted.h"
37 #include "ecryptfs_format.h"
38 
39 static const char KEY_TRUSTED_PREFIX[] = "trusted:";
40 static const char KEY_USER_PREFIX[] = "user:";
41 static const char blkcipher_alg[] = "cbc(aes)";
42 static const char key_format_default[] = "default";
43 static const char key_format_ecryptfs[] = "ecryptfs";
44 static const char key_format_enc32[] = "enc32";
45 static unsigned int ivsize;
46 static int blksize;
47 
48 #define KEY_TRUSTED_PREFIX_LEN (sizeof (KEY_TRUSTED_PREFIX) - 1)
49 #define KEY_USER_PREFIX_LEN (sizeof (KEY_USER_PREFIX) - 1)
50 #define KEY_ECRYPTFS_DESC_LEN 16
51 #define HASH_SIZE SHA256_DIGEST_SIZE
52 #define MAX_DATA_SIZE 4096
53 #define MIN_DATA_SIZE  20
54 #define KEY_ENC32_PAYLOAD_LEN 32
55 
56 enum {
57 	Opt_new, Opt_load, Opt_update, Opt_err
58 };
59 
60 enum {
61 	Opt_default, Opt_ecryptfs, Opt_enc32, Opt_error
62 };
63 
64 static const match_table_t key_format_tokens = {
65 	{Opt_default, "default"},
66 	{Opt_ecryptfs, "ecryptfs"},
67 	{Opt_enc32, "enc32"},
68 	{Opt_error, NULL}
69 };
70 
71 static const match_table_t key_tokens = {
72 	{Opt_new, "new"},
73 	{Opt_load, "load"},
74 	{Opt_update, "update"},
75 	{Opt_err, NULL}
76 };
77 
78 static bool user_decrypted_data = IS_ENABLED(CONFIG_USER_DECRYPTED_DATA);
79 module_param(user_decrypted_data, bool, 0);
80 MODULE_PARM_DESC(user_decrypted_data,
81 	"Allow instantiation of encrypted keys using provided decrypted data");
82 
83 static int aes_get_sizes(void)
84 {
85 	struct crypto_skcipher *tfm;
86 
87 	tfm = crypto_alloc_skcipher(blkcipher_alg, 0, CRYPTO_ALG_ASYNC);
88 	if (IS_ERR(tfm)) {
89 		pr_err("encrypted_key: failed to alloc_cipher (%ld)\n",
90 		       PTR_ERR(tfm));
91 		return PTR_ERR(tfm);
92 	}
93 	ivsize = crypto_skcipher_ivsize(tfm);
94 	blksize = crypto_skcipher_blocksize(tfm);
95 	crypto_free_skcipher(tfm);
96 	return 0;
97 }
98 
99 /*
100  * valid_ecryptfs_desc - verify the description of a new/loaded encrypted key
101  *
102  * The description of a encrypted key with format 'ecryptfs' must contain
103  * exactly 16 hexadecimal characters.
104  *
105  */
106 static int valid_ecryptfs_desc(const char *ecryptfs_desc)
107 {
108 	int i;
109 
110 	if (strlen(ecryptfs_desc) != KEY_ECRYPTFS_DESC_LEN) {
111 		pr_err("encrypted_key: key description must be %d hexadecimal "
112 		       "characters long\n", KEY_ECRYPTFS_DESC_LEN);
113 		return -EINVAL;
114 	}
115 
116 	for (i = 0; i < KEY_ECRYPTFS_DESC_LEN; i++) {
117 		if (!isxdigit(ecryptfs_desc[i])) {
118 			pr_err("encrypted_key: key description must contain "
119 			       "only hexadecimal characters\n");
120 			return -EINVAL;
121 		}
122 	}
123 
124 	return 0;
125 }
126 
127 /*
128  * valid_master_desc - verify the 'key-type:desc' of a new/updated master-key
129  *
130  * key-type:= "trusted:" | "user:"
131  * desc:= master-key description
132  *
133  * Verify that 'key-type' is valid and that 'desc' exists. On key update,
134  * only the master key description is permitted to change, not the key-type.
135  * The key-type remains constant.
136  *
137  * On success returns 0, otherwise -EINVAL.
138  */
139 static int valid_master_desc(const char *new_desc, const char *orig_desc)
140 {
141 	int prefix_len;
142 
143 	if (!strncmp(new_desc, KEY_TRUSTED_PREFIX, KEY_TRUSTED_PREFIX_LEN))
144 		prefix_len = KEY_TRUSTED_PREFIX_LEN;
145 	else if (!strncmp(new_desc, KEY_USER_PREFIX, KEY_USER_PREFIX_LEN))
146 		prefix_len = KEY_USER_PREFIX_LEN;
147 	else
148 		return -EINVAL;
149 
150 	if (!new_desc[prefix_len])
151 		return -EINVAL;
152 
153 	if (orig_desc && strncmp(new_desc, orig_desc, prefix_len))
154 		return -EINVAL;
155 
156 	return 0;
157 }
158 
159 /*
160  * datablob_parse - parse the keyctl data
161  *
162  * datablob format:
163  * new [<format>] <master-key name> <decrypted data length> [<decrypted data>]
164  * load [<format>] <master-key name> <decrypted data length>
165  *     <encrypted iv + data>
166  * update <new-master-key name>
167  *
168  * Tokenizes a copy of the keyctl data, returning a pointer to each token,
169  * which is null terminated.
170  *
171  * On success returns 0, otherwise -EINVAL.
172  */
173 static int datablob_parse(char *datablob, const char **format,
174 			  char **master_desc, char **decrypted_datalen,
175 			  char **hex_encoded_iv, char **decrypted_data)
176 {
177 	substring_t args[MAX_OPT_ARGS];
178 	int ret = -EINVAL;
179 	int key_cmd;
180 	int key_format;
181 	char *p, *keyword;
182 
183 	keyword = strsep(&datablob, " \t");
184 	if (!keyword) {
185 		pr_info("encrypted_key: insufficient parameters specified\n");
186 		return ret;
187 	}
188 	key_cmd = match_token(keyword, key_tokens, args);
189 
190 	/* Get optional format: default | ecryptfs */
191 	p = strsep(&datablob, " \t");
192 	if (!p) {
193 		pr_err("encrypted_key: insufficient parameters specified\n");
194 		return ret;
195 	}
196 
197 	key_format = match_token(p, key_format_tokens, args);
198 	switch (key_format) {
199 	case Opt_ecryptfs:
200 	case Opt_enc32:
201 	case Opt_default:
202 		*format = p;
203 		*master_desc = strsep(&datablob, " \t");
204 		break;
205 	case Opt_error:
206 		*master_desc = p;
207 		break;
208 	}
209 
210 	if (!*master_desc) {
211 		pr_info("encrypted_key: master key parameter is missing\n");
212 		goto out;
213 	}
214 
215 	if (valid_master_desc(*master_desc, NULL) < 0) {
216 		pr_info("encrypted_key: master key parameter \'%s\' "
217 			"is invalid\n", *master_desc);
218 		goto out;
219 	}
220 
221 	if (decrypted_datalen) {
222 		*decrypted_datalen = strsep(&datablob, " \t");
223 		if (!*decrypted_datalen) {
224 			pr_info("encrypted_key: keylen parameter is missing\n");
225 			goto out;
226 		}
227 	}
228 
229 	switch (key_cmd) {
230 	case Opt_new:
231 		if (!decrypted_datalen) {
232 			pr_info("encrypted_key: keyword \'%s\' not allowed "
233 				"when called from .update method\n", keyword);
234 			break;
235 		}
236 		*decrypted_data = strsep(&datablob, " \t");
237 		ret = 0;
238 		break;
239 	case Opt_load:
240 		if (!decrypted_datalen) {
241 			pr_info("encrypted_key: keyword \'%s\' not allowed "
242 				"when called from .update method\n", keyword);
243 			break;
244 		}
245 		*hex_encoded_iv = strsep(&datablob, " \t");
246 		if (!*hex_encoded_iv) {
247 			pr_info("encrypted_key: hex blob is missing\n");
248 			break;
249 		}
250 		ret = 0;
251 		break;
252 	case Opt_update:
253 		if (decrypted_datalen) {
254 			pr_info("encrypted_key: keyword \'%s\' not allowed "
255 				"when called from .instantiate method\n",
256 				keyword);
257 			break;
258 		}
259 		ret = 0;
260 		break;
261 	case Opt_err:
262 		pr_info("encrypted_key: keyword \'%s\' not recognized\n",
263 			keyword);
264 		break;
265 	}
266 out:
267 	return ret;
268 }
269 
270 /*
271  * datablob_format - format as an ascii string, before copying to userspace
272  */
273 static char *datablob_format(struct encrypted_key_payload *epayload,
274 			     size_t asciiblob_len)
275 {
276 	char *ascii_buf, *bufp;
277 	u8 *iv = epayload->iv;
278 	int len;
279 	int i;
280 
281 	ascii_buf = kmalloc(asciiblob_len + 1, GFP_KERNEL);
282 	if (!ascii_buf)
283 		goto out;
284 
285 	ascii_buf[asciiblob_len] = '\0';
286 
287 	/* copy datablob master_desc and datalen strings */
288 	len = sprintf(ascii_buf, "%s %s %s ", epayload->format,
289 		      epayload->master_desc, epayload->datalen);
290 
291 	/* convert the hex encoded iv, encrypted-data and HMAC to ascii */
292 	bufp = &ascii_buf[len];
293 	for (i = 0; i < (asciiblob_len - len) / 2; i++)
294 		bufp = hex_byte_pack(bufp, iv[i]);
295 out:
296 	return ascii_buf;
297 }
298 
299 /*
300  * request_user_key - request the user key
301  *
302  * Use a user provided key to encrypt/decrypt an encrypted-key.
303  */
304 static struct key *request_user_key(const char *master_desc, const u8 **master_key,
305 				    size_t *master_keylen)
306 {
307 	const struct user_key_payload *upayload;
308 	struct key *ukey;
309 
310 	ukey = request_key(&key_type_user, master_desc, NULL);
311 	if (IS_ERR(ukey))
312 		goto error;
313 
314 	down_read(&ukey->sem);
315 	upayload = user_key_payload_locked(ukey);
316 	if (!upayload) {
317 		/* key was revoked before we acquired its semaphore */
318 		up_read(&ukey->sem);
319 		key_put(ukey);
320 		ukey = ERR_PTR(-EKEYREVOKED);
321 		goto error;
322 	}
323 	*master_key = upayload->data;
324 	*master_keylen = upayload->datalen;
325 error:
326 	return ukey;
327 }
328 
329 enum derived_key_type { ENC_KEY, AUTH_KEY };
330 
331 /* Derive authentication/encryption key from trusted key */
332 static int get_derived_key(u8 *derived_key, enum derived_key_type key_type,
333 			   const u8 *master_key, size_t master_keylen)
334 {
335 	u8 *derived_buf;
336 	unsigned int derived_buf_len;
337 
338 	derived_buf_len = strlen("AUTH_KEY") + 1 + master_keylen;
339 	if (derived_buf_len < HASH_SIZE)
340 		derived_buf_len = HASH_SIZE;
341 
342 	derived_buf = kzalloc(derived_buf_len, GFP_KERNEL);
343 	if (!derived_buf)
344 		return -ENOMEM;
345 
346 	if (key_type)
347 		strscpy(derived_buf, "AUTH_KEY", HASH_SIZE);
348 	else
349 		strscpy(derived_buf, "ENC_KEY", HASH_SIZE);
350 
351 	memcpy(derived_buf + strlen(derived_buf) + 1, master_key,
352 	       master_keylen);
353 	sha256(derived_buf, derived_buf_len, derived_key);
354 	kfree_sensitive(derived_buf);
355 	return 0;
356 }
357 
358 static struct skcipher_request *init_skcipher_req(const u8 *key,
359 						  unsigned int key_len)
360 {
361 	struct skcipher_request *req;
362 	struct crypto_skcipher *tfm;
363 	int ret;
364 
365 	tfm = crypto_alloc_skcipher(blkcipher_alg, 0, CRYPTO_ALG_ASYNC);
366 	if (IS_ERR(tfm)) {
367 		pr_err("encrypted_key: failed to load %s transform (%ld)\n",
368 		       blkcipher_alg, PTR_ERR(tfm));
369 		return ERR_CAST(tfm);
370 	}
371 
372 	ret = crypto_skcipher_setkey(tfm, key, key_len);
373 	if (ret < 0) {
374 		pr_err("encrypted_key: failed to setkey (%d)\n", ret);
375 		crypto_free_skcipher(tfm);
376 		return ERR_PTR(ret);
377 	}
378 
379 	req = skcipher_request_alloc(tfm, GFP_KERNEL);
380 	if (!req) {
381 		pr_err("encrypted_key: failed to allocate request for %s\n",
382 		       blkcipher_alg);
383 		crypto_free_skcipher(tfm);
384 		return ERR_PTR(-ENOMEM);
385 	}
386 
387 	skcipher_request_set_callback(req, 0, NULL, NULL);
388 	return req;
389 }
390 
391 static struct key *request_master_key(struct encrypted_key_payload *epayload,
392 				      const u8 **master_key, size_t *master_keylen)
393 {
394 	struct key *mkey = ERR_PTR(-EINVAL);
395 
396 	if (!strncmp(epayload->master_desc, KEY_TRUSTED_PREFIX,
397 		     KEY_TRUSTED_PREFIX_LEN)) {
398 		mkey = request_trusted_key(epayload->master_desc +
399 					   KEY_TRUSTED_PREFIX_LEN,
400 					   master_key, master_keylen);
401 	} else if (!strncmp(epayload->master_desc, KEY_USER_PREFIX,
402 			    KEY_USER_PREFIX_LEN)) {
403 		mkey = request_user_key(epayload->master_desc +
404 					KEY_USER_PREFIX_LEN,
405 					master_key, master_keylen);
406 	} else
407 		goto out;
408 
409 	if (IS_ERR(mkey)) {
410 		int ret = PTR_ERR(mkey);
411 
412 		if (ret == -ENOTSUPP)
413 			pr_info("encrypted_key: key %s not supported",
414 				epayload->master_desc);
415 		else
416 			pr_info("encrypted_key: key %s not found",
417 				epayload->master_desc);
418 		goto out;
419 	}
420 
421 	dump_master_key(*master_key, *master_keylen);
422 out:
423 	return mkey;
424 }
425 
426 /* Before returning data to userspace, encrypt decrypted data. */
427 static int derived_key_encrypt(struct encrypted_key_payload *epayload,
428 			       const u8 *derived_key,
429 			       unsigned int derived_keylen)
430 {
431 	struct scatterlist sg_in[2];
432 	struct scatterlist sg_out[1];
433 	struct crypto_skcipher *tfm;
434 	struct skcipher_request *req;
435 	unsigned int encrypted_datalen;
436 	u8 iv[AES_BLOCK_SIZE];
437 	int ret;
438 
439 	encrypted_datalen = roundup(epayload->decrypted_datalen, blksize);
440 
441 	req = init_skcipher_req(derived_key, derived_keylen);
442 	ret = PTR_ERR(req);
443 	if (IS_ERR(req))
444 		goto out;
445 	dump_decrypted_data(epayload);
446 
447 	sg_init_table(sg_in, 2);
448 	sg_set_buf(&sg_in[0], epayload->decrypted_data,
449 		   epayload->decrypted_datalen);
450 	sg_set_page(&sg_in[1], ZERO_PAGE(0), AES_BLOCK_SIZE, 0);
451 
452 	sg_init_table(sg_out, 1);
453 	sg_set_buf(sg_out, epayload->encrypted_data, encrypted_datalen);
454 
455 	memcpy(iv, epayload->iv, sizeof(iv));
456 	skcipher_request_set_crypt(req, sg_in, sg_out, encrypted_datalen, iv);
457 	ret = crypto_skcipher_encrypt(req);
458 	tfm = crypto_skcipher_reqtfm(req);
459 	skcipher_request_free(req);
460 	crypto_free_skcipher(tfm);
461 	if (ret < 0)
462 		pr_err("encrypted_key: failed to encrypt (%d)\n", ret);
463 	else
464 		dump_encrypted_data(epayload, encrypted_datalen);
465 out:
466 	return ret;
467 }
468 
469 static int datablob_hmac_append(struct encrypted_key_payload *epayload,
470 				const u8 *master_key, size_t master_keylen)
471 {
472 	u8 derived_key[HASH_SIZE];
473 	u8 *digest;
474 	int ret;
475 
476 	ret = get_derived_key(derived_key, AUTH_KEY, master_key, master_keylen);
477 	if (ret < 0)
478 		goto out;
479 
480 	digest = epayload->format + epayload->datablob_len;
481 	hmac_sha256_usingrawkey(derived_key, sizeof(derived_key),
482 				epayload->format, epayload->datablob_len,
483 				digest);
484 	dump_hmac(NULL, digest, HASH_SIZE);
485 out:
486 	memzero_explicit(derived_key, sizeof(derived_key));
487 	return ret;
488 }
489 
490 /* verify HMAC before decrypting encrypted key */
491 static int datablob_hmac_verify(struct encrypted_key_payload *epayload,
492 				const u8 *format, const u8 *master_key,
493 				size_t master_keylen)
494 {
495 	u8 derived_key[HASH_SIZE];
496 	u8 digest[HASH_SIZE];
497 	int ret;
498 	char *p;
499 	unsigned short len;
500 
501 	ret = get_derived_key(derived_key, AUTH_KEY, master_key, master_keylen);
502 	if (ret < 0)
503 		goto out;
504 
505 	len = epayload->datablob_len;
506 	if (!format) {
507 		p = epayload->master_desc;
508 		len -= strlen(epayload->format) + 1;
509 	} else
510 		p = epayload->format;
511 
512 	hmac_sha256_usingrawkey(derived_key, sizeof(derived_key), p, len,
513 				digest);
514 	ret = crypto_memneq(digest, epayload->format + epayload->datablob_len,
515 			    sizeof(digest));
516 	if (ret) {
517 		ret = -EINVAL;
518 		dump_hmac("datablob",
519 			  epayload->format + epayload->datablob_len,
520 			  HASH_SIZE);
521 		dump_hmac("calc", digest, HASH_SIZE);
522 	}
523 out:
524 	memzero_explicit(derived_key, sizeof(derived_key));
525 	return ret;
526 }
527 
528 static int derived_key_decrypt(struct encrypted_key_payload *epayload,
529 			       const u8 *derived_key,
530 			       unsigned int derived_keylen)
531 {
532 	struct scatterlist sg_in[1];
533 	struct scatterlist sg_out[2];
534 	struct crypto_skcipher *tfm;
535 	struct skcipher_request *req;
536 	unsigned int encrypted_datalen;
537 	u8 iv[AES_BLOCK_SIZE];
538 	u8 *pad;
539 	int ret;
540 
541 	/* Throwaway buffer to hold the unused zero padding at the end */
542 	pad = kmalloc(AES_BLOCK_SIZE, GFP_KERNEL);
543 	if (!pad)
544 		return -ENOMEM;
545 
546 	encrypted_datalen = roundup(epayload->decrypted_datalen, blksize);
547 	req = init_skcipher_req(derived_key, derived_keylen);
548 	ret = PTR_ERR(req);
549 	if (IS_ERR(req))
550 		goto out;
551 	dump_encrypted_data(epayload, encrypted_datalen);
552 
553 	sg_init_table(sg_in, 1);
554 	sg_init_table(sg_out, 2);
555 	sg_set_buf(sg_in, epayload->encrypted_data, encrypted_datalen);
556 	sg_set_buf(&sg_out[0], epayload->decrypted_data,
557 		   epayload->decrypted_datalen);
558 	sg_set_buf(&sg_out[1], pad, AES_BLOCK_SIZE);
559 
560 	memcpy(iv, epayload->iv, sizeof(iv));
561 	skcipher_request_set_crypt(req, sg_in, sg_out, encrypted_datalen, iv);
562 	ret = crypto_skcipher_decrypt(req);
563 	tfm = crypto_skcipher_reqtfm(req);
564 	skcipher_request_free(req);
565 	crypto_free_skcipher(tfm);
566 	if (ret < 0)
567 		goto out;
568 	dump_decrypted_data(epayload);
569 out:
570 	kfree(pad);
571 	return ret;
572 }
573 
574 /* Allocate memory for decrypted key and datablob. */
575 static struct encrypted_key_payload *encrypted_key_alloc(struct key *key,
576 							 const char *format,
577 							 const char *master_desc,
578 							 const char *datalen,
579 							 const char *decrypted_data)
580 {
581 	struct encrypted_key_payload *epayload = NULL;
582 	unsigned short datablob_len;
583 	unsigned short payload_totallen;
584 	unsigned short decrypted_datalen;
585 	unsigned short payload_datalen;
586 	unsigned int encrypted_datalen;
587 	unsigned int format_len;
588 	long dlen;
589 	int i;
590 	int ret;
591 
592 	ret = kstrtol(datalen, 10, &dlen);
593 	if (ret < 0 || dlen < MIN_DATA_SIZE || dlen > MAX_DATA_SIZE)
594 		return ERR_PTR(-EINVAL);
595 
596 	format_len = (!format) ? strlen(key_format_default) : strlen(format);
597 	decrypted_datalen = dlen;
598 	payload_datalen = decrypted_datalen;
599 
600 	if (decrypted_data) {
601 		if (!user_decrypted_data) {
602 			pr_err("encrypted key: instantiation of keys using provided decrypted data is disabled since CONFIG_USER_DECRYPTED_DATA is set to false\n");
603 			return ERR_PTR(-EINVAL);
604 		}
605 		if (strlen(decrypted_data) != decrypted_datalen * 2) {
606 			pr_err("encrypted key: decrypted data provided does not match decrypted data length provided\n");
607 			return ERR_PTR(-EINVAL);
608 		}
609 		for (i = 0; i < strlen(decrypted_data); i++) {
610 			if (!isxdigit(decrypted_data[i])) {
611 				pr_err("encrypted key: decrypted data provided must contain only hexadecimal characters\n");
612 				return ERR_PTR(-EINVAL);
613 			}
614 		}
615 	}
616 
617 	if (format) {
618 		if (!strcmp(format, key_format_ecryptfs)) {
619 			if (dlen != ECRYPTFS_MAX_KEY_BYTES) {
620 				pr_err("encrypted_key: keylen for the ecryptfs format must be equal to %d bytes\n",
621 					ECRYPTFS_MAX_KEY_BYTES);
622 				return ERR_PTR(-EINVAL);
623 			}
624 			decrypted_datalen = ECRYPTFS_MAX_KEY_BYTES;
625 			payload_datalen = sizeof(struct ecryptfs_auth_tok);
626 		} else if (!strcmp(format, key_format_enc32)) {
627 			if (decrypted_datalen != KEY_ENC32_PAYLOAD_LEN) {
628 				pr_err("encrypted_key: enc32 key payload incorrect length: %d\n",
629 						decrypted_datalen);
630 				return ERR_PTR(-EINVAL);
631 			}
632 		}
633 	}
634 
635 	encrypted_datalen = roundup(decrypted_datalen, blksize);
636 
637 	if (check_add_overflow(format_len + 1 + strlen(master_desc) + 1
638 			       + strlen(datalen) + 1 + ivsize + 1,
639 			       encrypted_datalen, &datablob_len))
640 		return ERR_PTR(-EINVAL);
641 
642 	if (check_add_overflow(datablob_len,
643 			       payload_datalen + HASH_SIZE + 1,
644 			       &payload_totallen))
645 		return ERR_PTR(-EINVAL);
646 
647 	ret = key_payload_reserve(key, payload_totallen);
648 	if (ret < 0)
649 		return ERR_PTR(ret);
650 
651 	epayload = kzalloc_flex(*epayload, payload_data, payload_totallen,
652 				GFP_KERNEL);
653 	if (!epayload)
654 		return ERR_PTR(-ENOMEM);
655 
656 	epayload->payload_datalen = payload_datalen;
657 	epayload->decrypted_datalen = decrypted_datalen;
658 	epayload->datablob_len = datablob_len;
659 	return epayload;
660 }
661 
662 static int encrypted_key_decrypt(struct encrypted_key_payload *epayload,
663 				 const char *format, const char *hex_encoded_iv)
664 {
665 	struct key *mkey;
666 	u8 derived_key[HASH_SIZE];
667 	const u8 *master_key;
668 	u8 *hmac;
669 	const char *hex_encoded_data;
670 	unsigned int encrypted_datalen;
671 	size_t master_keylen;
672 	size_t asciilen;
673 	int ret;
674 
675 	encrypted_datalen = roundup(epayload->decrypted_datalen, blksize);
676 	asciilen = (ivsize + 1 + encrypted_datalen + HASH_SIZE) * 2;
677 	if (strlen(hex_encoded_iv) != asciilen)
678 		return -EINVAL;
679 
680 	hex_encoded_data = hex_encoded_iv + (2 * ivsize) + 2;
681 	ret = hex2bin(epayload->iv, hex_encoded_iv, ivsize);
682 	if (ret < 0)
683 		return -EINVAL;
684 	ret = hex2bin(epayload->encrypted_data, hex_encoded_data,
685 		      encrypted_datalen);
686 	if (ret < 0)
687 		return -EINVAL;
688 
689 	hmac = epayload->format + epayload->datablob_len;
690 	ret = hex2bin(hmac, hex_encoded_data + (encrypted_datalen * 2),
691 		      HASH_SIZE);
692 	if (ret < 0)
693 		return -EINVAL;
694 
695 	mkey = request_master_key(epayload, &master_key, &master_keylen);
696 	if (IS_ERR(mkey))
697 		return PTR_ERR(mkey);
698 
699 	ret = datablob_hmac_verify(epayload, format, master_key, master_keylen);
700 	if (ret < 0) {
701 		pr_err("encrypted_key: bad hmac (%d)\n", ret);
702 		goto out;
703 	}
704 
705 	ret = get_derived_key(derived_key, ENC_KEY, master_key, master_keylen);
706 	if (ret < 0)
707 		goto out;
708 
709 	ret = derived_key_decrypt(epayload, derived_key, sizeof derived_key);
710 	if (ret < 0)
711 		pr_err("encrypted_key: failed to decrypt key (%d)\n", ret);
712 out:
713 	up_read(&mkey->sem);
714 	key_put(mkey);
715 	memzero_explicit(derived_key, sizeof(derived_key));
716 	return ret;
717 }
718 
719 static void __ekey_init(struct encrypted_key_payload *epayload,
720 			const char *format, const char *master_desc,
721 			const char *datalen)
722 {
723 	unsigned int format_len;
724 
725 	format_len = (!format) ? strlen(key_format_default) : strlen(format);
726 	epayload->format = epayload->payload_data + epayload->payload_datalen;
727 	epayload->master_desc = epayload->format + format_len + 1;
728 	epayload->datalen = epayload->master_desc + strlen(master_desc) + 1;
729 	epayload->iv = epayload->datalen + strlen(datalen) + 1;
730 	epayload->encrypted_data = epayload->iv + ivsize + 1;
731 	epayload->decrypted_data = epayload->payload_data;
732 
733 	if (!format)
734 		memcpy(epayload->format, key_format_default, format_len);
735 	else {
736 		if (!strcmp(format, key_format_ecryptfs))
737 			epayload->decrypted_data =
738 				ecryptfs_get_auth_tok_key((struct ecryptfs_auth_tok *)epayload->payload_data);
739 
740 		memcpy(epayload->format, format, format_len);
741 	}
742 
743 	memcpy(epayload->master_desc, master_desc, strlen(master_desc));
744 	memcpy(epayload->datalen, datalen, strlen(datalen));
745 }
746 
747 /*
748  * encrypted_init - initialize an encrypted key
749  *
750  * For a new key, use either a random number or user-provided decrypted data in
751  * case it is provided. A random number is used for the iv in both cases. For
752  * an old key, decrypt the hex encoded data.
753  */
754 static int encrypted_init(struct encrypted_key_payload *epayload,
755 			  const char *key_desc, const char *format,
756 			  const char *master_desc, const char *datalen,
757 			  const char *hex_encoded_iv, const char *decrypted_data)
758 {
759 	int ret = 0;
760 
761 	if (format && !strcmp(format, key_format_ecryptfs)) {
762 		ret = valid_ecryptfs_desc(key_desc);
763 		if (ret < 0)
764 			return ret;
765 
766 		ecryptfs_fill_auth_tok((struct ecryptfs_auth_tok *)epayload->payload_data,
767 				       key_desc);
768 	}
769 
770 	__ekey_init(epayload, format, master_desc, datalen);
771 	if (hex_encoded_iv) {
772 		ret = encrypted_key_decrypt(epayload, format, hex_encoded_iv);
773 	} else if (decrypted_data) {
774 		get_random_bytes(epayload->iv, ivsize);
775 		ret = hex2bin(epayload->decrypted_data, decrypted_data,
776 			      epayload->decrypted_datalen);
777 	} else {
778 		get_random_bytes(epayload->iv, ivsize);
779 		get_random_bytes(epayload->decrypted_data, epayload->decrypted_datalen);
780 	}
781 	return ret;
782 }
783 
784 /*
785  * encrypted_instantiate - instantiate an encrypted key
786  *
787  * Instantiates the key:
788  * - by decrypting an existing encrypted datablob, or
789  * - by creating a new encrypted key based on a kernel random number, or
790  * - using provided decrypted data.
791  *
792  * On success, return 0. Otherwise return errno.
793  */
794 static int encrypted_instantiate(struct key *key,
795 				 struct key_preparsed_payload *prep)
796 {
797 	struct encrypted_key_payload *epayload = NULL;
798 	char *datablob = NULL;
799 	const char *format = NULL;
800 	char *master_desc = NULL;
801 	char *decrypted_datalen = NULL;
802 	char *hex_encoded_iv = NULL;
803 	char *decrypted_data = NULL;
804 	size_t datalen = prep->datalen;
805 	int ret;
806 
807 	if (datalen == 0 || datalen > 32767 || !prep->data)
808 		return -EINVAL;
809 
810 	datablob = kmalloc(datalen + 1, GFP_KERNEL);
811 	if (!datablob)
812 		return -ENOMEM;
813 	datablob[datalen] = 0;
814 	memcpy(datablob, prep->data, datalen);
815 	ret = datablob_parse(datablob, &format, &master_desc,
816 			     &decrypted_datalen, &hex_encoded_iv, &decrypted_data);
817 	if (ret < 0)
818 		goto out;
819 
820 	epayload = encrypted_key_alloc(key, format, master_desc,
821 				       decrypted_datalen, decrypted_data);
822 	if (IS_ERR(epayload)) {
823 		ret = PTR_ERR(epayload);
824 		goto out;
825 	}
826 	ret = encrypted_init(epayload, key->description, format, master_desc,
827 			     decrypted_datalen, hex_encoded_iv, decrypted_data);
828 	if (ret < 0) {
829 		kfree_sensitive(epayload);
830 		goto out;
831 	}
832 
833 	rcu_assign_keypointer(key, epayload);
834 out:
835 	kfree_sensitive(datablob);
836 	return ret;
837 }
838 
839 static void encrypted_rcu_free(struct rcu_head *rcu)
840 {
841 	struct encrypted_key_payload *epayload;
842 
843 	epayload = container_of(rcu, struct encrypted_key_payload, rcu);
844 	kfree_sensitive(epayload);
845 }
846 
847 /*
848  * encrypted_update - update the master key description
849  *
850  * Change the master key description for an existing encrypted key.
851  * The next read will return an encrypted datablob using the new
852  * master key description.
853  *
854  * On success, return 0. Otherwise return errno.
855  */
856 static int encrypted_update(struct key *key, struct key_preparsed_payload *prep)
857 {
858 	struct encrypted_key_payload *epayload = key->payload.data[0];
859 	struct encrypted_key_payload *new_epayload;
860 	char *buf;
861 	char *new_master_desc = NULL;
862 	const char *format = NULL;
863 	size_t datalen = prep->datalen;
864 	int ret = 0;
865 
866 	if (key_is_negative(key))
867 		return -ENOKEY;
868 	if (datalen == 0 || datalen > 32767 || !prep->data)
869 		return -EINVAL;
870 
871 	buf = kmalloc(datalen + 1, GFP_KERNEL);
872 	if (!buf)
873 		return -ENOMEM;
874 
875 	buf[datalen] = 0;
876 	memcpy(buf, prep->data, datalen);
877 	ret = datablob_parse(buf, &format, &new_master_desc, NULL, NULL, NULL);
878 	if (ret < 0)
879 		goto out;
880 
881 	ret = valid_master_desc(new_master_desc, epayload->master_desc);
882 	if (ret < 0)
883 		goto out;
884 
885 	new_epayload = encrypted_key_alloc(key, epayload->format,
886 					   new_master_desc, epayload->datalen, NULL);
887 	if (IS_ERR(new_epayload)) {
888 		ret = PTR_ERR(new_epayload);
889 		goto out;
890 	}
891 
892 	__ekey_init(new_epayload, epayload->format, new_master_desc,
893 		    epayload->datalen);
894 
895 	memcpy(new_epayload->iv, epayload->iv, ivsize);
896 	memcpy(new_epayload->payload_data, epayload->payload_data,
897 	       epayload->payload_datalen);
898 
899 	rcu_assign_keypointer(key, new_epayload);
900 	call_rcu(&epayload->rcu, encrypted_rcu_free);
901 out:
902 	kfree_sensitive(buf);
903 	return ret;
904 }
905 
906 /*
907  * encrypted_read - format and copy out the encrypted data
908  *
909  * The resulting datablob format is:
910  * <master-key name> <decrypted data length> <encrypted iv> <encrypted data>
911  *
912  * On success, return to userspace the encrypted key datablob size.
913  */
914 static long encrypted_read(const struct key *key, char *buffer,
915 			   size_t buflen)
916 {
917 	struct encrypted_key_payload *epayload;
918 	struct key *mkey;
919 	const u8 *master_key;
920 	size_t master_keylen;
921 	char derived_key[HASH_SIZE];
922 	char *ascii_buf;
923 	size_t asciiblob_len;
924 	int ret;
925 
926 	epayload = dereference_key_locked(key);
927 
928 	/* returns the hex encoded iv, encrypted-data, and hmac as ascii */
929 	asciiblob_len = epayload->datablob_len + ivsize + 1
930 	    + roundup(epayload->decrypted_datalen, blksize)
931 	    + (HASH_SIZE * 2);
932 
933 	if (!buffer || buflen < asciiblob_len)
934 		return asciiblob_len;
935 
936 	mkey = request_master_key(epayload, &master_key, &master_keylen);
937 	if (IS_ERR(mkey))
938 		return PTR_ERR(mkey);
939 
940 	ret = get_derived_key(derived_key, ENC_KEY, master_key, master_keylen);
941 	if (ret < 0)
942 		goto out;
943 
944 	ret = derived_key_encrypt(epayload, derived_key, sizeof derived_key);
945 	if (ret < 0)
946 		goto out;
947 
948 	ret = datablob_hmac_append(epayload, master_key, master_keylen);
949 	if (ret < 0)
950 		goto out;
951 
952 	ascii_buf = datablob_format(epayload, asciiblob_len);
953 	if (!ascii_buf) {
954 		ret = -ENOMEM;
955 		goto out;
956 	}
957 
958 	up_read(&mkey->sem);
959 	key_put(mkey);
960 	memzero_explicit(derived_key, sizeof(derived_key));
961 
962 	memcpy(buffer, ascii_buf, asciiblob_len);
963 	kfree_sensitive(ascii_buf);
964 
965 	return asciiblob_len;
966 out:
967 	up_read(&mkey->sem);
968 	key_put(mkey);
969 	memzero_explicit(derived_key, sizeof(derived_key));
970 	return ret;
971 }
972 
973 /*
974  * encrypted_destroy - clear and free the key's payload
975  */
976 static void encrypted_destroy(struct key *key)
977 {
978 	kfree_sensitive(key->payload.data[0]);
979 }
980 
981 struct key_type key_type_encrypted = {
982 	.name = "encrypted",
983 	.instantiate = encrypted_instantiate,
984 	.update = encrypted_update,
985 	.destroy = encrypted_destroy,
986 	.describe = user_describe,
987 	.read = encrypted_read,
988 };
989 EXPORT_SYMBOL_GPL(key_type_encrypted);
990 
991 static int __init init_encrypted(void)
992 {
993 	int ret;
994 
995 	ret = aes_get_sizes();
996 	if (ret < 0)
997 		return ret;
998 	return register_key_type(&key_type_encrypted);
999 }
1000 
1001 static void __exit cleanup_encrypted(void)
1002 {
1003 	unregister_key_type(&key_type_encrypted);
1004 }
1005 
1006 late_initcall(init_encrypted);
1007 module_exit(cleanup_encrypted);
1008 
1009 MODULE_DESCRIPTION("Encrypted key type");
1010 MODULE_LICENSE("GPL");
1011