1 /* Large capacity key type
3 * Copyright (C) 2017 Jason A. Donenfeld <Jason@zx2c4.com>. All Rights Reserved.
4 * Copyright (C) 2013 Red Hat, Inc. All Rights Reserved.
5 * Written by David Howells (dhowells@redhat.com)
7 * This program is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public Licence
9 * as published by the Free Software Foundation; either version
10 * 2 of the Licence, or (at your option) any later version.
13 #define pr_fmt(fmt) "big_key: "fmt
14 #include <linux/init.h>
15 #include <linux/seq_file.h>
16 #include <linux/file.h>
17 #include <linux/shmem_fs.h>
18 #include <linux/err.h>
19 #include <linux/scatterlist.h>
20 #include <linux/random.h>
21 #include <linux/vmalloc.h>
22 #include <keys/user-type.h>
23 #include <keys/big_key-type.h>
24 #include <crypto/aead.h>
25 #include <crypto/gcm.h>
28 unsigned int nr_pages
;
30 struct scatterlist
*sg
;
35 * Layout of key payload words.
40 big_key_path_2nd_part
,
45 * Crypto operation with big_key data
53 * If the data is under this limit, there's no point creating a shm file to
54 * hold it as the permanently resident metadata for the shmem fs will be at
55 * least as large as the data.
57 #define BIG_KEY_FILE_THRESHOLD (sizeof(struct inode) + sizeof(struct dentry))
60 * Key size for big_key data encryption
62 #define ENC_KEY_SIZE 32
65 * Authentication tag length
67 #define ENC_AUTHTAG_SIZE 16
70 * big_key defined keys take an arbitrary string as the description and an
71 * arbitrary blob of data as the payload
73 struct key_type key_type_big_key
= {
75 .preparse
= big_key_preparse
,
76 .free_preparse
= big_key_free_preparse
,
77 .instantiate
= generic_key_instantiate
,
78 .revoke
= big_key_revoke
,
79 .destroy
= big_key_destroy
,
80 .describe
= big_key_describe
,
82 /* no ->update(); don't add it without changing big_key_crypt() nonce */
86 * Crypto names for big_key data authenticated encryption
88 static const char big_key_alg_name
[] = "gcm(aes)";
89 #define BIG_KEY_IV_SIZE GCM_AES_IV_SIZE
92 * Crypto algorithms for big_key data authenticated encryption
94 static struct crypto_aead
*big_key_aead
;
97 * Since changing the key affects the entire object, we need a mutex.
99 static DEFINE_MUTEX(big_key_aead_lock
);
102 * Encrypt/decrypt big_key data
104 static int big_key_crypt(enum big_key_op op
, struct big_key_buf
*buf
, size_t datalen
, u8
*key
)
107 struct aead_request
*aead_req
;
108 /* We always use a zero nonce. The reason we can get away with this is
109 * because we're using a different randomly generated key for every
110 * different encryption. Notably, too, key_type_big_key doesn't define
111 * an .update function, so there's no chance we'll wind up reusing the
112 * key to encrypt updated data. Simply put: one key, one encryption.
114 u8 zero_nonce
[BIG_KEY_IV_SIZE
];
116 aead_req
= aead_request_alloc(big_key_aead
, GFP_KERNEL
);
120 memset(zero_nonce
, 0, sizeof(zero_nonce
));
121 aead_request_set_crypt(aead_req
, buf
->sg
, buf
->sg
, datalen
, zero_nonce
);
122 aead_request_set_callback(aead_req
, CRYPTO_TFM_REQ_MAY_SLEEP
, NULL
, NULL
);
123 aead_request_set_ad(aead_req
, 0);
125 mutex_lock(&big_key_aead_lock
);
126 if (crypto_aead_setkey(big_key_aead
, key
, ENC_KEY_SIZE
)) {
130 if (op
== BIG_KEY_ENC
)
131 ret
= crypto_aead_encrypt(aead_req
);
133 ret
= crypto_aead_decrypt(aead_req
);
135 mutex_unlock(&big_key_aead_lock
);
136 aead_request_free(aead_req
);
141 * Free up the buffer.
143 static void big_key_free_buffer(struct big_key_buf
*buf
)
148 memset(buf
->virt
, 0, buf
->nr_pages
* PAGE_SIZE
);
152 for (i
= 0; i
< buf
->nr_pages
; i
++)
154 __free_page(buf
->pages
[i
]);
160 * Allocate a buffer consisting of a set of pages with a virtual mapping
163 static void *big_key_alloc_buffer(size_t len
)
165 struct big_key_buf
*buf
;
166 unsigned int npg
= (len
+ PAGE_SIZE
- 1) >> PAGE_SHIFT
;
169 buf
= kzalloc(sizeof(struct big_key_buf
) +
170 sizeof(struct page
) * npg
+
171 sizeof(struct scatterlist
) * npg
,
177 buf
->sg
= (void *)(buf
->pages
+ npg
);
178 sg_init_table(buf
->sg
, npg
);
180 for (i
= 0; i
< buf
->nr_pages
; i
++) {
181 buf
->pages
[i
] = alloc_page(GFP_KERNEL
);
185 l
= min_t(size_t, len
, PAGE_SIZE
);
186 sg_set_page(&buf
->sg
[i
], buf
->pages
[i
], l
, 0);
190 buf
->virt
= vmap(buf
->pages
, buf
->nr_pages
, VM_MAP
, PAGE_KERNEL
);
197 big_key_free_buffer(buf
);
204 int big_key_preparse(struct key_preparsed_payload
*prep
)
206 struct big_key_buf
*buf
;
207 struct path
*path
= (struct path
*)&prep
->payload
.data
[big_key_path
];
211 size_t datalen
= prep
->datalen
, enclen
= datalen
+ ENC_AUTHTAG_SIZE
;
214 if (datalen
<= 0 || datalen
> 1024 * 1024 || !prep
->data
)
217 /* Set an arbitrary quota */
220 prep
->payload
.data
[big_key_len
] = (void *)(unsigned long)datalen
;
222 if (datalen
> BIG_KEY_FILE_THRESHOLD
) {
223 /* Create a shmem file to store the data in. This will permit the data
224 * to be swapped out if needed.
226 * File content is stored encrypted with randomly generated key.
230 buf
= big_key_alloc_buffer(enclen
);
233 memcpy(buf
->virt
, prep
->data
, datalen
);
235 /* generate random key */
236 enckey
= kmalloc(ENC_KEY_SIZE
, GFP_KERNEL
);
241 ret
= get_random_bytes_wait(enckey
, ENC_KEY_SIZE
);
245 /* encrypt aligned data */
246 ret
= big_key_crypt(BIG_KEY_ENC
, buf
, datalen
, enckey
);
250 /* save aligned data to file */
251 file
= shmem_kernel_file_setup("", enclen
, 0);
257 written
= kernel_write(file
, buf
->virt
, enclen
, &pos
);
258 if (written
!= enclen
) {
265 /* Pin the mount and dentry to the key so that we can open it again
268 prep
->payload
.data
[big_key_data
] = enckey
;
269 *path
= file
->f_path
;
272 big_key_free_buffer(buf
);
274 /* Just store the data in a buffer */
275 void *data
= kmalloc(datalen
, GFP_KERNEL
);
280 prep
->payload
.data
[big_key_data
] = data
;
281 memcpy(data
, prep
->data
, prep
->datalen
);
290 big_key_free_buffer(buf
);
295 * Clear preparsement.
297 void big_key_free_preparse(struct key_preparsed_payload
*prep
)
299 if (prep
->datalen
> BIG_KEY_FILE_THRESHOLD
) {
300 struct path
*path
= (struct path
*)&prep
->payload
.data
[big_key_path
];
304 kzfree(prep
->payload
.data
[big_key_data
]);
308 * dispose of the links from a revoked keyring
309 * - called with the key sem write-locked
311 void big_key_revoke(struct key
*key
)
313 struct path
*path
= (struct path
*)&key
->payload
.data
[big_key_path
];
315 /* clear the quota */
316 key_payload_reserve(key
, 0);
317 if (key_is_positive(key
) &&
318 (size_t)key
->payload
.data
[big_key_len
] > BIG_KEY_FILE_THRESHOLD
)
319 vfs_truncate(path
, 0);
323 * dispose of the data dangling from the corpse of a big_key key
325 void big_key_destroy(struct key
*key
)
327 size_t datalen
= (size_t)key
->payload
.data
[big_key_len
];
329 if (datalen
> BIG_KEY_FILE_THRESHOLD
) {
330 struct path
*path
= (struct path
*)&key
->payload
.data
[big_key_path
];
336 kzfree(key
->payload
.data
[big_key_data
]);
337 key
->payload
.data
[big_key_data
] = NULL
;
341 * describe the big_key key
343 void big_key_describe(const struct key
*key
, struct seq_file
*m
)
345 size_t datalen
= (size_t)key
->payload
.data
[big_key_len
];
347 seq_puts(m
, key
->description
);
349 if (key_is_positive(key
))
350 seq_printf(m
, ": %zu [%s]",
352 datalen
> BIG_KEY_FILE_THRESHOLD
? "file" : "buff");
357 * - the key's semaphore is read-locked
359 long big_key_read(const struct key
*key
, char __user
*buffer
, size_t buflen
)
361 size_t datalen
= (size_t)key
->payload
.data
[big_key_len
];
364 if (!buffer
|| buflen
< datalen
)
367 if (datalen
> BIG_KEY_FILE_THRESHOLD
) {
368 struct big_key_buf
*buf
;
369 struct path
*path
= (struct path
*)&key
->payload
.data
[big_key_path
];
371 u8
*enckey
= (u8
*)key
->payload
.data
[big_key_data
];
372 size_t enclen
= datalen
+ ENC_AUTHTAG_SIZE
;
375 buf
= big_key_alloc_buffer(enclen
);
379 file
= dentry_open(path
, O_RDONLY
, current_cred());
385 /* read file to kernel and decrypt */
386 ret
= kernel_read(file
, buf
->virt
, enclen
, &pos
);
387 if (ret
>= 0 && ret
!= enclen
) {
392 ret
= big_key_crypt(BIG_KEY_DEC
, buf
, enclen
, enckey
);
398 /* copy decrypted data to user */
399 if (copy_to_user(buffer
, buf
->virt
, datalen
) != 0)
405 big_key_free_buffer(buf
);
408 if (copy_to_user(buffer
, key
->payload
.data
[big_key_data
],
419 static int __init
big_key_init(void)
423 /* init block cipher */
424 big_key_aead
= crypto_alloc_aead(big_key_alg_name
, 0, CRYPTO_ALG_ASYNC
);
425 if (IS_ERR(big_key_aead
)) {
426 ret
= PTR_ERR(big_key_aead
);
427 pr_err("Can't alloc crypto: %d\n", ret
);
431 if (unlikely(crypto_aead_ivsize(big_key_aead
) != BIG_KEY_IV_SIZE
)) {
432 WARN(1, "big key algorithm changed?");
437 ret
= crypto_aead_setauthsize(big_key_aead
, ENC_AUTHTAG_SIZE
);
439 pr_err("Can't set crypto auth tag len: %d\n", ret
);
443 ret
= register_key_type(&key_type_big_key
);
445 pr_err("Can't register type: %d\n", ret
);
452 crypto_free_aead(big_key_aead
);
456 late_initcall(big_key_init
);