]> git.proxmox.com Git - mirror_zfs.git/blob - module/os/linux/zfs/zio_crypt.c
Remove bcopy(), bzero(), bcmp()
[mirror_zfs.git] / module / os / linux / zfs / zio_crypt.c
1 /*
2 * CDDL HEADER START
3 *
4 * This file and its contents are supplied under the terms of the
5 * Common Development and Distribution License ("CDDL"), version 1.0.
6 * You may only use this file in accordance with the terms of version
7 * 1.0 of the CDDL.
8 *
9 * A full copy of the text of the CDDL should have accompanied this
10 * source. A copy of the CDDL is also available via the Internet at
11 * http://www.illumos.org/license/CDDL.
12 *
13 * CDDL HEADER END
14 */
15
16 /*
17 * Copyright (c) 2017, Datto, Inc. All rights reserved.
18 */
19
20 #include <sys/zio_crypt.h>
21 #include <sys/dmu.h>
22 #include <sys/dmu_objset.h>
23 #include <sys/dnode.h>
24 #include <sys/fs/zfs.h>
25 #include <sys/zio.h>
26 #include <sys/zil.h>
27 #include <sys/sha2.h>
28 #include <sys/hkdf.h>
29 #include <sys/qat.h>
30
31 /*
32 * This file is responsible for handling all of the details of generating
33 * encryption parameters and performing encryption and authentication.
34 *
35 * BLOCK ENCRYPTION PARAMETERS:
36 * Encryption /Authentication Algorithm Suite (crypt):
37 * The encryption algorithm, mode, and key length we are going to use. We
38 * currently support AES in either GCM or CCM modes with 128, 192, and 256 bit
39 * keys. All authentication is currently done with SHA512-HMAC.
40 *
41 * Plaintext:
42 * The unencrypted data that we want to encrypt.
43 *
44 * Initialization Vector (IV):
45 * An initialization vector for the encryption algorithms. This is used to
46 * "tweak" the encryption algorithms so that two blocks of the same data are
47 * encrypted into different ciphertext outputs, thus obfuscating block patterns.
48 * The supported encryption modes (AES-GCM and AES-CCM) require that an IV is
49 * never reused with the same encryption key. This value is stored unencrypted
50 * and must simply be provided to the decryption function. We use a 96 bit IV
51 * (as recommended by NIST) for all block encryption. For non-dedup blocks we
52 * derive the IV randomly. The first 64 bits of the IV are stored in the second
53 * word of DVA[2] and the remaining 32 bits are stored in the upper 32 bits of
54 * blk_fill. This is safe because encrypted blocks can't use the upper 32 bits
55 * of blk_fill. We only encrypt level 0 blocks, which normally have a fill count
56 * of 1. The only exception is for DMU_OT_DNODE objects, where the fill count of
57 * level 0 blocks is the number of allocated dnodes in that block. The on-disk
58 * format supports at most 2^15 slots per L0 dnode block, because the maximum
59 * block size is 16MB (2^24). In either case, for level 0 blocks this number
60 * will still be smaller than UINT32_MAX so it is safe to store the IV in the
61 * top 32 bits of blk_fill, while leaving the bottom 32 bits of the fill count
62 * for the dnode code.
63 *
64 * Master key:
65 * This is the most important secret data of an encrypted dataset. It is used
66 * along with the salt to generate that actual encryption keys via HKDF. We
67 * do not use the master key to directly encrypt any data because there are
68 * theoretical limits on how much data can actually be safely encrypted with
69 * any encryption mode. The master key is stored encrypted on disk with the
70 * user's wrapping key. Its length is determined by the encryption algorithm.
71 * For details on how this is stored see the block comment in dsl_crypt.c
72 *
73 * Salt:
74 * Used as an input to the HKDF function, along with the master key. We use a
75 * 64 bit salt, stored unencrypted in the first word of DVA[2]. Any given salt
76 * can be used for encrypting many blocks, so we cache the current salt and the
77 * associated derived key in zio_crypt_t so we do not need to derive it again
78 * needlessly.
79 *
80 * Encryption Key:
81 * A secret binary key, generated from an HKDF function used to encrypt and
82 * decrypt data.
83 *
84 * Message Authentication Code (MAC)
85 * The MAC is an output of authenticated encryption modes such as AES-GCM and
86 * AES-CCM. Its purpose is to ensure that an attacker cannot modify encrypted
87 * data on disk and return garbage to the application. Effectively, it is a
88 * checksum that can not be reproduced by an attacker. We store the MAC in the
89 * second 128 bits of blk_cksum, leaving the first 128 bits for a truncated
90 * regular checksum of the ciphertext which can be used for scrubbing.
91 *
92 * OBJECT AUTHENTICATION:
93 * Some object types, such as DMU_OT_MASTER_NODE cannot be encrypted because
94 * they contain some info that always needs to be readable. To prevent this
95 * data from being altered, we authenticate this data using SHA512-HMAC. This
96 * will produce a MAC (similar to the one produced via encryption) which can
97 * be used to verify the object was not modified. HMACs do not require key
98 * rotation or IVs, so we can keep up to the full 3 copies of authenticated
99 * data.
100 *
101 * ZIL ENCRYPTION:
102 * ZIL blocks have their bp written to disk ahead of the associated data, so we
103 * cannot store the MAC there as we normally do. For these blocks the MAC is
104 * stored in the embedded checksum within the zil_chain_t header. The salt and
105 * IV are generated for the block on bp allocation instead of at encryption
106 * time. In addition, ZIL blocks have some pieces that must be left in plaintext
107 * for claiming even though all of the sensitive user data still needs to be
108 * encrypted. The function zio_crypt_init_uios_zil() handles parsing which
109 * pieces of the block need to be encrypted. All data that is not encrypted is
110 * authenticated using the AAD mechanisms that the supported encryption modes
111 * provide for. In order to preserve the semantics of the ZIL for encrypted
112 * datasets, the ZIL is not protected at the objset level as described below.
113 *
114 * DNODE ENCRYPTION:
115 * Similarly to ZIL blocks, the core part of each dnode_phys_t needs to be left
116 * in plaintext for scrubbing and claiming, but the bonus buffers might contain
117 * sensitive user data. The function zio_crypt_init_uios_dnode() handles parsing
118 * which pieces of the block need to be encrypted. For more details about
119 * dnode authentication and encryption, see zio_crypt_init_uios_dnode().
120 *
121 * OBJECT SET AUTHENTICATION:
122 * Up to this point, everything we have encrypted and authenticated has been
123 * at level 0 (or -2 for the ZIL). If we did not do any further work the
124 * on-disk format would be susceptible to attacks that deleted or rearranged
125 * the order of level 0 blocks. Ideally, the cleanest solution would be to
126 * maintain a tree of authentication MACs going up the bp tree. However, this
127 * presents a problem for raw sends. Send files do not send information about
128 * indirect blocks so there would be no convenient way to transfer the MACs and
129 * they cannot be recalculated on the receive side without the master key which
130 * would defeat one of the purposes of raw sends in the first place. Instead,
131 * for the indirect levels of the bp tree, we use a regular SHA512 of the MACs
132 * from the level below. We also include some portable fields from blk_prop such
133 * as the lsize and compression algorithm to prevent the data from being
134 * misinterpreted.
135 *
136 * At the objset level, we maintain 2 separate 256 bit MACs in the
137 * objset_phys_t. The first one is "portable" and is the logical root of the
138 * MAC tree maintained in the metadnode's bps. The second, is "local" and is
139 * used as the root MAC for the user accounting objects, which are also not
140 * transferred via "zfs send". The portable MAC is sent in the DRR_BEGIN payload
141 * of the send file. The useraccounting code ensures that the useraccounting
142 * info is not present upon a receive, so the local MAC can simply be cleared
143 * out at that time. For more info about objset_phys_t authentication, see
144 * zio_crypt_do_objset_hmacs().
145 *
146 * CONSIDERATIONS FOR DEDUP:
147 * In order for dedup to work, blocks that we want to dedup with one another
148 * need to use the same IV and encryption key, so that they will have the same
149 * ciphertext. Normally, one should never reuse an IV with the same encryption
150 * key or else AES-GCM and AES-CCM can both actually leak the plaintext of both
151 * blocks. In this case, however, since we are using the same plaintext as
152 * well all that we end up with is a duplicate of the original ciphertext we
153 * already had. As a result, an attacker with read access to the raw disk will
154 * be able to tell which blocks are the same but this information is given away
155 * by dedup anyway. In order to get the same IVs and encryption keys for
156 * equivalent blocks of data we use an HMAC of the plaintext. We use an HMAC
157 * here so that a reproducible checksum of the plaintext is never available to
158 * the attacker. The HMAC key is kept alongside the master key, encrypted on
159 * disk. The first 64 bits of the HMAC are used in place of the random salt, and
160 * the next 96 bits are used as the IV. As a result of this mechanism, dedup
161 * will only work within a clone family since encrypted dedup requires use of
162 * the same master and HMAC keys.
163 */
164
165 /*
166 * After encrypting many blocks with the same key we may start to run up
167 * against the theoretical limits of how much data can securely be encrypted
168 * with a single key using the supported encryption modes. The most obvious
169 * limitation is that our risk of generating 2 equivalent 96 bit IVs increases
170 * the more IVs we generate (which both GCM and CCM modes strictly forbid).
171 * This risk actually grows surprisingly quickly over time according to the
172 * Birthday Problem. With a total IV space of 2^(96 bits), and assuming we have
173 * generated n IVs with a cryptographically secure RNG, the approximate
174 * probability p(n) of a collision is given as:
175 *
176 * p(n) ~= e^(-n*(n-1)/(2*(2^96)))
177 *
178 * [http://www.math.cornell.edu/~mec/2008-2009/TianyiZheng/Birthday.html]
179 *
180 * Assuming that we want to ensure that p(n) never goes over 1 / 1 trillion
181 * we must not write more than 398,065,730 blocks with the same encryption key.
182 * Therefore, we rotate our keys after 400,000,000 blocks have been written by
183 * generating a new random 64 bit salt for our HKDF encryption key generation
184 * function.
185 */
186 #define ZFS_KEY_MAX_SALT_USES_DEFAULT 400000000
187 #define ZFS_CURRENT_MAX_SALT_USES \
188 (MIN(zfs_key_max_salt_uses, ZFS_KEY_MAX_SALT_USES_DEFAULT))
189 static unsigned long zfs_key_max_salt_uses = ZFS_KEY_MAX_SALT_USES_DEFAULT;
190
191 typedef struct blkptr_auth_buf {
192 uint64_t bab_prop; /* blk_prop - portable mask */
193 uint8_t bab_mac[ZIO_DATA_MAC_LEN]; /* MAC from blk_cksum */
194 uint64_t bab_pad; /* reserved for future use */
195 } blkptr_auth_buf_t;
196
197 const zio_crypt_info_t zio_crypt_table[ZIO_CRYPT_FUNCTIONS] = {
198 {"", ZC_TYPE_NONE, 0, "inherit"},
199 {"", ZC_TYPE_NONE, 0, "on"},
200 {"", ZC_TYPE_NONE, 0, "off"},
201 {SUN_CKM_AES_CCM, ZC_TYPE_CCM, 16, "aes-128-ccm"},
202 {SUN_CKM_AES_CCM, ZC_TYPE_CCM, 24, "aes-192-ccm"},
203 {SUN_CKM_AES_CCM, ZC_TYPE_CCM, 32, "aes-256-ccm"},
204 {SUN_CKM_AES_GCM, ZC_TYPE_GCM, 16, "aes-128-gcm"},
205 {SUN_CKM_AES_GCM, ZC_TYPE_GCM, 24, "aes-192-gcm"},
206 {SUN_CKM_AES_GCM, ZC_TYPE_GCM, 32, "aes-256-gcm"}
207 };
208
209 void
210 zio_crypt_key_destroy(zio_crypt_key_t *key)
211 {
212 rw_destroy(&key->zk_salt_lock);
213
214 /* free crypto templates */
215 crypto_destroy_ctx_template(key->zk_current_tmpl);
216 crypto_destroy_ctx_template(key->zk_hmac_tmpl);
217
218 /* zero out sensitive data */
219 memset(key, 0, sizeof (zio_crypt_key_t));
220 }
221
222 int
223 zio_crypt_key_init(uint64_t crypt, zio_crypt_key_t *key)
224 {
225 int ret;
226 crypto_mechanism_t mech;
227 uint_t keydata_len;
228
229 ASSERT(key != NULL);
230 ASSERT3U(crypt, <, ZIO_CRYPT_FUNCTIONS);
231
232 keydata_len = zio_crypt_table[crypt].ci_keylen;
233 memset(key, 0, sizeof (zio_crypt_key_t));
234
235 /* fill keydata buffers and salt with random data */
236 ret = random_get_bytes((uint8_t *)&key->zk_guid, sizeof (uint64_t));
237 if (ret != 0)
238 goto error;
239
240 ret = random_get_bytes(key->zk_master_keydata, keydata_len);
241 if (ret != 0)
242 goto error;
243
244 ret = random_get_bytes(key->zk_hmac_keydata, SHA512_HMAC_KEYLEN);
245 if (ret != 0)
246 goto error;
247
248 ret = random_get_bytes(key->zk_salt, ZIO_DATA_SALT_LEN);
249 if (ret != 0)
250 goto error;
251
252 /* derive the current key from the master key */
253 ret = hkdf_sha512(key->zk_master_keydata, keydata_len, NULL, 0,
254 key->zk_salt, ZIO_DATA_SALT_LEN, key->zk_current_keydata,
255 keydata_len);
256 if (ret != 0)
257 goto error;
258
259 /* initialize keys for the ICP */
260 key->zk_current_key.ck_data = key->zk_current_keydata;
261 key->zk_current_key.ck_length = CRYPTO_BYTES2BITS(keydata_len);
262
263 key->zk_hmac_key.ck_data = &key->zk_hmac_key;
264 key->zk_hmac_key.ck_length = CRYPTO_BYTES2BITS(SHA512_HMAC_KEYLEN);
265
266 /*
267 * Initialize the crypto templates. It's ok if this fails because
268 * this is just an optimization.
269 */
270 mech.cm_type = crypto_mech2id(zio_crypt_table[crypt].ci_mechname);
271 ret = crypto_create_ctx_template(&mech, &key->zk_current_key,
272 &key->zk_current_tmpl);
273 if (ret != CRYPTO_SUCCESS)
274 key->zk_current_tmpl = NULL;
275
276 mech.cm_type = crypto_mech2id(SUN_CKM_SHA512_HMAC);
277 ret = crypto_create_ctx_template(&mech, &key->zk_hmac_key,
278 &key->zk_hmac_tmpl);
279 if (ret != CRYPTO_SUCCESS)
280 key->zk_hmac_tmpl = NULL;
281
282 key->zk_crypt = crypt;
283 key->zk_version = ZIO_CRYPT_KEY_CURRENT_VERSION;
284 key->zk_salt_count = 0;
285 rw_init(&key->zk_salt_lock, NULL, RW_DEFAULT, NULL);
286
287 return (0);
288
289 error:
290 zio_crypt_key_destroy(key);
291 return (ret);
292 }
293
294 static int
295 zio_crypt_key_change_salt(zio_crypt_key_t *key)
296 {
297 int ret = 0;
298 uint8_t salt[ZIO_DATA_SALT_LEN];
299 crypto_mechanism_t mech;
300 uint_t keydata_len = zio_crypt_table[key->zk_crypt].ci_keylen;
301
302 /* generate a new salt */
303 ret = random_get_bytes(salt, ZIO_DATA_SALT_LEN);
304 if (ret != 0)
305 goto error;
306
307 rw_enter(&key->zk_salt_lock, RW_WRITER);
308
309 /* someone beat us to the salt rotation, just unlock and return */
310 if (key->zk_salt_count < ZFS_CURRENT_MAX_SALT_USES)
311 goto out_unlock;
312
313 /* derive the current key from the master key and the new salt */
314 ret = hkdf_sha512(key->zk_master_keydata, keydata_len, NULL, 0,
315 salt, ZIO_DATA_SALT_LEN, key->zk_current_keydata, keydata_len);
316 if (ret != 0)
317 goto out_unlock;
318
319 /* assign the salt and reset the usage count */
320 memcpy(key->zk_salt, salt, ZIO_DATA_SALT_LEN);
321 key->zk_salt_count = 0;
322
323 /* destroy the old context template and create the new one */
324 crypto_destroy_ctx_template(key->zk_current_tmpl);
325 ret = crypto_create_ctx_template(&mech, &key->zk_current_key,
326 &key->zk_current_tmpl);
327 if (ret != CRYPTO_SUCCESS)
328 key->zk_current_tmpl = NULL;
329
330 rw_exit(&key->zk_salt_lock);
331
332 return (0);
333
334 out_unlock:
335 rw_exit(&key->zk_salt_lock);
336 error:
337 return (ret);
338 }
339
340 /* See comment above zfs_key_max_salt_uses definition for details */
341 int
342 zio_crypt_key_get_salt(zio_crypt_key_t *key, uint8_t *salt)
343 {
344 int ret;
345 boolean_t salt_change;
346
347 rw_enter(&key->zk_salt_lock, RW_READER);
348
349 memcpy(salt, key->zk_salt, ZIO_DATA_SALT_LEN);
350 salt_change = (atomic_inc_64_nv(&key->zk_salt_count) >=
351 ZFS_CURRENT_MAX_SALT_USES);
352
353 rw_exit(&key->zk_salt_lock);
354
355 if (salt_change) {
356 ret = zio_crypt_key_change_salt(key);
357 if (ret != 0)
358 goto error;
359 }
360
361 return (0);
362
363 error:
364 return (ret);
365 }
366
367 /*
368 * This function handles all encryption and decryption in zfs. When
369 * encrypting it expects puio to reference the plaintext and cuio to
370 * reference the ciphertext. cuio must have enough space for the
371 * ciphertext + room for a MAC. datalen should be the length of the
372 * plaintext / ciphertext alone.
373 */
374 static int
375 zio_do_crypt_uio(boolean_t encrypt, uint64_t crypt, crypto_key_t *key,
376 crypto_ctx_template_t tmpl, uint8_t *ivbuf, uint_t datalen,
377 zfs_uio_t *puio, zfs_uio_t *cuio, uint8_t *authbuf, uint_t auth_len)
378 {
379 int ret;
380 crypto_data_t plaindata, cipherdata;
381 CK_AES_CCM_PARAMS ccmp;
382 CK_AES_GCM_PARAMS gcmp;
383 crypto_mechanism_t mech;
384 zio_crypt_info_t crypt_info;
385 uint_t plain_full_len, maclen;
386
387 ASSERT3U(crypt, <, ZIO_CRYPT_FUNCTIONS);
388
389 /* lookup the encryption info */
390 crypt_info = zio_crypt_table[crypt];
391
392 /* the mac will always be the last iovec_t in the cipher uio */
393 maclen = cuio->uio_iov[cuio->uio_iovcnt - 1].iov_len;
394
395 ASSERT(maclen <= ZIO_DATA_MAC_LEN);
396
397 /* setup encryption mechanism (same as crypt) */
398 mech.cm_type = crypto_mech2id(crypt_info.ci_mechname);
399
400 /*
401 * Strangely, the ICP requires that plain_full_len must include
402 * the MAC length when decrypting, even though the UIO does not
403 * need to have the extra space allocated.
404 */
405 if (encrypt) {
406 plain_full_len = datalen;
407 } else {
408 plain_full_len = datalen + maclen;
409 }
410
411 /*
412 * setup encryption params (currently only AES CCM and AES GCM
413 * are supported)
414 */
415 if (crypt_info.ci_crypt_type == ZC_TYPE_CCM) {
416 ccmp.ulNonceSize = ZIO_DATA_IV_LEN;
417 ccmp.ulAuthDataSize = auth_len;
418 ccmp.authData = authbuf;
419 ccmp.ulMACSize = maclen;
420 ccmp.nonce = ivbuf;
421 ccmp.ulDataSize = plain_full_len;
422
423 mech.cm_param = (char *)(&ccmp);
424 mech.cm_param_len = sizeof (CK_AES_CCM_PARAMS);
425 } else {
426 gcmp.ulIvLen = ZIO_DATA_IV_LEN;
427 gcmp.ulIvBits = CRYPTO_BYTES2BITS(ZIO_DATA_IV_LEN);
428 gcmp.ulAADLen = auth_len;
429 gcmp.pAAD = authbuf;
430 gcmp.ulTagBits = CRYPTO_BYTES2BITS(maclen);
431 gcmp.pIv = ivbuf;
432
433 mech.cm_param = (char *)(&gcmp);
434 mech.cm_param_len = sizeof (CK_AES_GCM_PARAMS);
435 }
436
437 /* populate the cipher and plain data structs. */
438 plaindata.cd_format = CRYPTO_DATA_UIO;
439 plaindata.cd_offset = 0;
440 plaindata.cd_uio = puio;
441 plaindata.cd_length = plain_full_len;
442
443 cipherdata.cd_format = CRYPTO_DATA_UIO;
444 cipherdata.cd_offset = 0;
445 cipherdata.cd_uio = cuio;
446 cipherdata.cd_length = datalen + maclen;
447
448 /* perform the actual encryption */
449 if (encrypt) {
450 ret = crypto_encrypt(&mech, &plaindata, key, tmpl, &cipherdata);
451 if (ret != CRYPTO_SUCCESS) {
452 ret = SET_ERROR(EIO);
453 goto error;
454 }
455 } else {
456 ret = crypto_decrypt(&mech, &cipherdata, key, tmpl, &plaindata);
457 if (ret != CRYPTO_SUCCESS) {
458 ASSERT3U(ret, ==, CRYPTO_INVALID_MAC);
459 ret = SET_ERROR(ECKSUM);
460 goto error;
461 }
462 }
463
464 return (0);
465
466 error:
467 return (ret);
468 }
469
470 int
471 zio_crypt_key_wrap(crypto_key_t *cwkey, zio_crypt_key_t *key, uint8_t *iv,
472 uint8_t *mac, uint8_t *keydata_out, uint8_t *hmac_keydata_out)
473 {
474 int ret;
475 zfs_uio_t puio, cuio;
476 uint64_t aad[3];
477 iovec_t plain_iovecs[2], cipher_iovecs[3];
478 uint64_t crypt = key->zk_crypt;
479 uint_t enc_len, keydata_len, aad_len;
480
481 ASSERT3U(crypt, <, ZIO_CRYPT_FUNCTIONS);
482
483 keydata_len = zio_crypt_table[crypt].ci_keylen;
484
485 /* generate iv for wrapping the master and hmac key */
486 ret = random_get_pseudo_bytes(iv, WRAPPING_IV_LEN);
487 if (ret != 0)
488 goto error;
489
490 /* initialize zfs_uio_ts */
491 plain_iovecs[0].iov_base = key->zk_master_keydata;
492 plain_iovecs[0].iov_len = keydata_len;
493 plain_iovecs[1].iov_base = key->zk_hmac_keydata;
494 plain_iovecs[1].iov_len = SHA512_HMAC_KEYLEN;
495
496 cipher_iovecs[0].iov_base = keydata_out;
497 cipher_iovecs[0].iov_len = keydata_len;
498 cipher_iovecs[1].iov_base = hmac_keydata_out;
499 cipher_iovecs[1].iov_len = SHA512_HMAC_KEYLEN;
500 cipher_iovecs[2].iov_base = mac;
501 cipher_iovecs[2].iov_len = WRAPPING_MAC_LEN;
502
503 /*
504 * Although we don't support writing to the old format, we do
505 * support rewrapping the key so that the user can move and
506 * quarantine datasets on the old format.
507 */
508 if (key->zk_version == 0) {
509 aad_len = sizeof (uint64_t);
510 aad[0] = LE_64(key->zk_guid);
511 } else {
512 ASSERT3U(key->zk_version, ==, ZIO_CRYPT_KEY_CURRENT_VERSION);
513 aad_len = sizeof (uint64_t) * 3;
514 aad[0] = LE_64(key->zk_guid);
515 aad[1] = LE_64(crypt);
516 aad[2] = LE_64(key->zk_version);
517 }
518
519 enc_len = zio_crypt_table[crypt].ci_keylen + SHA512_HMAC_KEYLEN;
520 puio.uio_iov = plain_iovecs;
521 puio.uio_iovcnt = 2;
522 puio.uio_segflg = UIO_SYSSPACE;
523 cuio.uio_iov = cipher_iovecs;
524 cuio.uio_iovcnt = 3;
525 cuio.uio_segflg = UIO_SYSSPACE;
526
527 /* encrypt the keys and store the resulting ciphertext and mac */
528 ret = zio_do_crypt_uio(B_TRUE, crypt, cwkey, NULL, iv, enc_len,
529 &puio, &cuio, (uint8_t *)aad, aad_len);
530 if (ret != 0)
531 goto error;
532
533 return (0);
534
535 error:
536 return (ret);
537 }
538
539 int
540 zio_crypt_key_unwrap(crypto_key_t *cwkey, uint64_t crypt, uint64_t version,
541 uint64_t guid, uint8_t *keydata, uint8_t *hmac_keydata, uint8_t *iv,
542 uint8_t *mac, zio_crypt_key_t *key)
543 {
544 crypto_mechanism_t mech;
545 zfs_uio_t puio, cuio;
546 uint64_t aad[3];
547 iovec_t plain_iovecs[2], cipher_iovecs[3];
548 uint_t enc_len, keydata_len, aad_len;
549 int ret;
550
551 ASSERT3U(crypt, <, ZIO_CRYPT_FUNCTIONS);
552
553 rw_init(&key->zk_salt_lock, NULL, RW_DEFAULT, NULL);
554
555 keydata_len = zio_crypt_table[crypt].ci_keylen;
556
557 /* initialize zfs_uio_ts */
558 plain_iovecs[0].iov_base = key->zk_master_keydata;
559 plain_iovecs[0].iov_len = keydata_len;
560 plain_iovecs[1].iov_base = key->zk_hmac_keydata;
561 plain_iovecs[1].iov_len = SHA512_HMAC_KEYLEN;
562
563 cipher_iovecs[0].iov_base = keydata;
564 cipher_iovecs[0].iov_len = keydata_len;
565 cipher_iovecs[1].iov_base = hmac_keydata;
566 cipher_iovecs[1].iov_len = SHA512_HMAC_KEYLEN;
567 cipher_iovecs[2].iov_base = mac;
568 cipher_iovecs[2].iov_len = WRAPPING_MAC_LEN;
569
570 if (version == 0) {
571 aad_len = sizeof (uint64_t);
572 aad[0] = LE_64(guid);
573 } else {
574 ASSERT3U(version, ==, ZIO_CRYPT_KEY_CURRENT_VERSION);
575 aad_len = sizeof (uint64_t) * 3;
576 aad[0] = LE_64(guid);
577 aad[1] = LE_64(crypt);
578 aad[2] = LE_64(version);
579 }
580
581 enc_len = keydata_len + SHA512_HMAC_KEYLEN;
582 puio.uio_iov = plain_iovecs;
583 puio.uio_segflg = UIO_SYSSPACE;
584 puio.uio_iovcnt = 2;
585 cuio.uio_iov = cipher_iovecs;
586 cuio.uio_iovcnt = 3;
587 cuio.uio_segflg = UIO_SYSSPACE;
588
589 /* decrypt the keys and store the result in the output buffers */
590 ret = zio_do_crypt_uio(B_FALSE, crypt, cwkey, NULL, iv, enc_len,
591 &puio, &cuio, (uint8_t *)aad, aad_len);
592 if (ret != 0)
593 goto error;
594
595 /* generate a fresh salt */
596 ret = random_get_bytes(key->zk_salt, ZIO_DATA_SALT_LEN);
597 if (ret != 0)
598 goto error;
599
600 /* derive the current key from the master key */
601 ret = hkdf_sha512(key->zk_master_keydata, keydata_len, NULL, 0,
602 key->zk_salt, ZIO_DATA_SALT_LEN, key->zk_current_keydata,
603 keydata_len);
604 if (ret != 0)
605 goto error;
606
607 /* initialize keys for ICP */
608 key->zk_current_key.ck_data = key->zk_current_keydata;
609 key->zk_current_key.ck_length = CRYPTO_BYTES2BITS(keydata_len);
610
611 key->zk_hmac_key.ck_data = key->zk_hmac_keydata;
612 key->zk_hmac_key.ck_length = CRYPTO_BYTES2BITS(SHA512_HMAC_KEYLEN);
613
614 /*
615 * Initialize the crypto templates. It's ok if this fails because
616 * this is just an optimization.
617 */
618 mech.cm_type = crypto_mech2id(zio_crypt_table[crypt].ci_mechname);
619 ret = crypto_create_ctx_template(&mech, &key->zk_current_key,
620 &key->zk_current_tmpl);
621 if (ret != CRYPTO_SUCCESS)
622 key->zk_current_tmpl = NULL;
623
624 mech.cm_type = crypto_mech2id(SUN_CKM_SHA512_HMAC);
625 ret = crypto_create_ctx_template(&mech, &key->zk_hmac_key,
626 &key->zk_hmac_tmpl);
627 if (ret != CRYPTO_SUCCESS)
628 key->zk_hmac_tmpl = NULL;
629
630 key->zk_crypt = crypt;
631 key->zk_version = version;
632 key->zk_guid = guid;
633 key->zk_salt_count = 0;
634
635 return (0);
636
637 error:
638 zio_crypt_key_destroy(key);
639 return (ret);
640 }
641
642 int
643 zio_crypt_generate_iv(uint8_t *ivbuf)
644 {
645 int ret;
646
647 /* randomly generate the IV */
648 ret = random_get_pseudo_bytes(ivbuf, ZIO_DATA_IV_LEN);
649 if (ret != 0)
650 goto error;
651
652 return (0);
653
654 error:
655 memset(ivbuf, 0, ZIO_DATA_IV_LEN);
656 return (ret);
657 }
658
659 int
660 zio_crypt_do_hmac(zio_crypt_key_t *key, uint8_t *data, uint_t datalen,
661 uint8_t *digestbuf, uint_t digestlen)
662 {
663 int ret;
664 crypto_mechanism_t mech;
665 crypto_data_t in_data, digest_data;
666 uint8_t raw_digestbuf[SHA512_DIGEST_LENGTH];
667
668 ASSERT3U(digestlen, <=, SHA512_DIGEST_LENGTH);
669
670 /* initialize sha512-hmac mechanism and crypto data */
671 mech.cm_type = crypto_mech2id(SUN_CKM_SHA512_HMAC);
672 mech.cm_param = NULL;
673 mech.cm_param_len = 0;
674
675 /* initialize the crypto data */
676 in_data.cd_format = CRYPTO_DATA_RAW;
677 in_data.cd_offset = 0;
678 in_data.cd_length = datalen;
679 in_data.cd_raw.iov_base = (char *)data;
680 in_data.cd_raw.iov_len = in_data.cd_length;
681
682 digest_data.cd_format = CRYPTO_DATA_RAW;
683 digest_data.cd_offset = 0;
684 digest_data.cd_length = SHA512_DIGEST_LENGTH;
685 digest_data.cd_raw.iov_base = (char *)raw_digestbuf;
686 digest_data.cd_raw.iov_len = digest_data.cd_length;
687
688 /* generate the hmac */
689 ret = crypto_mac(&mech, &in_data, &key->zk_hmac_key, key->zk_hmac_tmpl,
690 &digest_data);
691 if (ret != CRYPTO_SUCCESS) {
692 ret = SET_ERROR(EIO);
693 goto error;
694 }
695
696 memcpy(digestbuf, raw_digestbuf, digestlen);
697
698 return (0);
699
700 error:
701 memset(digestbuf, 0, digestlen);
702 return (ret);
703 }
704
705 int
706 zio_crypt_generate_iv_salt_dedup(zio_crypt_key_t *key, uint8_t *data,
707 uint_t datalen, uint8_t *ivbuf, uint8_t *salt)
708 {
709 int ret;
710 uint8_t digestbuf[SHA512_DIGEST_LENGTH];
711
712 ret = zio_crypt_do_hmac(key, data, datalen,
713 digestbuf, SHA512_DIGEST_LENGTH);
714 if (ret != 0)
715 return (ret);
716
717 memcpy(salt, digestbuf, ZIO_DATA_SALT_LEN);
718 memcpy(ivbuf, digestbuf + ZIO_DATA_SALT_LEN, ZIO_DATA_IV_LEN);
719
720 return (0);
721 }
722
723 /*
724 * The following functions are used to encode and decode encryption parameters
725 * into blkptr_t and zil_header_t. The ICP wants to use these parameters as
726 * byte strings, which normally means that these strings would not need to deal
727 * with byteswapping at all. However, both blkptr_t and zil_header_t may be
728 * byteswapped by lower layers and so we must "undo" that byteswap here upon
729 * decoding and encoding in a non-native byteorder. These functions require
730 * that the byteorder bit is correct before being called.
731 */
732 void
733 zio_crypt_encode_params_bp(blkptr_t *bp, uint8_t *salt, uint8_t *iv)
734 {
735 uint64_t val64;
736 uint32_t val32;
737
738 ASSERT(BP_IS_ENCRYPTED(bp));
739
740 if (!BP_SHOULD_BYTESWAP(bp)) {
741 memcpy(&bp->blk_dva[2].dva_word[0], salt, sizeof (uint64_t));
742 memcpy(&bp->blk_dva[2].dva_word[1], iv, sizeof (uint64_t));
743 memcpy(&val32, iv + sizeof (uint64_t), sizeof (uint32_t));
744 BP_SET_IV2(bp, val32);
745 } else {
746 memcpy(&val64, salt, sizeof (uint64_t));
747 bp->blk_dva[2].dva_word[0] = BSWAP_64(val64);
748
749 memcpy(&val64, iv, sizeof (uint64_t));
750 bp->blk_dva[2].dva_word[1] = BSWAP_64(val64);
751
752 memcpy(&val32, iv + sizeof (uint64_t), sizeof (uint32_t));
753 BP_SET_IV2(bp, BSWAP_32(val32));
754 }
755 }
756
757 void
758 zio_crypt_decode_params_bp(const blkptr_t *bp, uint8_t *salt, uint8_t *iv)
759 {
760 uint64_t val64;
761 uint32_t val32;
762
763 ASSERT(BP_IS_PROTECTED(bp));
764
765 /* for convenience, so callers don't need to check */
766 if (BP_IS_AUTHENTICATED(bp)) {
767 memset(salt, 0, ZIO_DATA_SALT_LEN);
768 memset(iv, 0, ZIO_DATA_IV_LEN);
769 return;
770 }
771
772 if (!BP_SHOULD_BYTESWAP(bp)) {
773 memcpy(salt, &bp->blk_dva[2].dva_word[0], sizeof (uint64_t));
774 memcpy(iv, &bp->blk_dva[2].dva_word[1], sizeof (uint64_t));
775
776 val32 = (uint32_t)BP_GET_IV2(bp);
777 memcpy(iv + sizeof (uint64_t), &val32, sizeof (uint32_t));
778 } else {
779 val64 = BSWAP_64(bp->blk_dva[2].dva_word[0]);
780 memcpy(salt, &val64, sizeof (uint64_t));
781
782 val64 = BSWAP_64(bp->blk_dva[2].dva_word[1]);
783 memcpy(iv, &val64, sizeof (uint64_t));
784
785 val32 = BSWAP_32((uint32_t)BP_GET_IV2(bp));
786 memcpy(iv + sizeof (uint64_t), &val32, sizeof (uint32_t));
787 }
788 }
789
790 void
791 zio_crypt_encode_mac_bp(blkptr_t *bp, uint8_t *mac)
792 {
793 uint64_t val64;
794
795 ASSERT(BP_USES_CRYPT(bp));
796 ASSERT3U(BP_GET_TYPE(bp), !=, DMU_OT_OBJSET);
797
798 if (!BP_SHOULD_BYTESWAP(bp)) {
799 memcpy(&bp->blk_cksum.zc_word[2], mac, sizeof (uint64_t));
800 memcpy(&bp->blk_cksum.zc_word[3], mac + sizeof (uint64_t),
801 sizeof (uint64_t));
802 } else {
803 memcpy(&val64, mac, sizeof (uint64_t));
804 bp->blk_cksum.zc_word[2] = BSWAP_64(val64);
805
806 memcpy(&val64, mac + sizeof (uint64_t), sizeof (uint64_t));
807 bp->blk_cksum.zc_word[3] = BSWAP_64(val64);
808 }
809 }
810
811 void
812 zio_crypt_decode_mac_bp(const blkptr_t *bp, uint8_t *mac)
813 {
814 uint64_t val64;
815
816 ASSERT(BP_USES_CRYPT(bp) || BP_IS_HOLE(bp));
817
818 /* for convenience, so callers don't need to check */
819 if (BP_GET_TYPE(bp) == DMU_OT_OBJSET) {
820 memset(mac, 0, ZIO_DATA_MAC_LEN);
821 return;
822 }
823
824 if (!BP_SHOULD_BYTESWAP(bp)) {
825 memcpy(mac, &bp->blk_cksum.zc_word[2], sizeof (uint64_t));
826 memcpy(mac + sizeof (uint64_t), &bp->blk_cksum.zc_word[3],
827 sizeof (uint64_t));
828 } else {
829 val64 = BSWAP_64(bp->blk_cksum.zc_word[2]);
830 memcpy(mac, &val64, sizeof (uint64_t));
831
832 val64 = BSWAP_64(bp->blk_cksum.zc_word[3]);
833 memcpy(mac + sizeof (uint64_t), &val64, sizeof (uint64_t));
834 }
835 }
836
837 void
838 zio_crypt_encode_mac_zil(void *data, uint8_t *mac)
839 {
840 zil_chain_t *zilc = data;
841
842 memcpy(&zilc->zc_eck.zec_cksum.zc_word[2], mac, sizeof (uint64_t));
843 memcpy(&zilc->zc_eck.zec_cksum.zc_word[3], mac + sizeof (uint64_t),
844 sizeof (uint64_t));
845 }
846
847 void
848 zio_crypt_decode_mac_zil(const void *data, uint8_t *mac)
849 {
850 /*
851 * The ZIL MAC is embedded in the block it protects, which will
852 * not have been byteswapped by the time this function has been called.
853 * As a result, we don't need to worry about byteswapping the MAC.
854 */
855 const zil_chain_t *zilc = data;
856
857 memcpy(mac, &zilc->zc_eck.zec_cksum.zc_word[2], sizeof (uint64_t));
858 memcpy(mac + sizeof (uint64_t), &zilc->zc_eck.zec_cksum.zc_word[3],
859 sizeof (uint64_t));
860 }
861
862 /*
863 * This routine takes a block of dnodes (src_abd) and copies only the bonus
864 * buffers to the same offsets in the dst buffer. datalen should be the size
865 * of both the src_abd and the dst buffer (not just the length of the bonus
866 * buffers).
867 */
868 void
869 zio_crypt_copy_dnode_bonus(abd_t *src_abd, uint8_t *dst, uint_t datalen)
870 {
871 uint_t i, max_dnp = datalen >> DNODE_SHIFT;
872 uint8_t *src;
873 dnode_phys_t *dnp, *sdnp, *ddnp;
874
875 src = abd_borrow_buf_copy(src_abd, datalen);
876
877 sdnp = (dnode_phys_t *)src;
878 ddnp = (dnode_phys_t *)dst;
879
880 for (i = 0; i < max_dnp; i += sdnp[i].dn_extra_slots + 1) {
881 dnp = &sdnp[i];
882 if (dnp->dn_type != DMU_OT_NONE &&
883 DMU_OT_IS_ENCRYPTED(dnp->dn_bonustype) &&
884 dnp->dn_bonuslen != 0) {
885 memcpy(DN_BONUS(&ddnp[i]), DN_BONUS(dnp),
886 DN_MAX_BONUS_LEN(dnp));
887 }
888 }
889
890 abd_return_buf(src_abd, src, datalen);
891 }
892
893 /*
894 * This function decides what fields from blk_prop are included in
895 * the on-disk various MAC algorithms.
896 */
897 static void
898 zio_crypt_bp_zero_nonportable_blkprop(blkptr_t *bp, uint64_t version)
899 {
900 /*
901 * Version 0 did not properly zero out all non-portable fields
902 * as it should have done. We maintain this code so that we can
903 * do read-only imports of pools on this version.
904 */
905 if (version == 0) {
906 BP_SET_DEDUP(bp, 0);
907 BP_SET_CHECKSUM(bp, 0);
908 BP_SET_PSIZE(bp, SPA_MINBLOCKSIZE);
909 return;
910 }
911
912 ASSERT3U(version, ==, ZIO_CRYPT_KEY_CURRENT_VERSION);
913
914 /*
915 * The hole_birth feature might set these fields even if this bp
916 * is a hole. We zero them out here to guarantee that raw sends
917 * will function with or without the feature.
918 */
919 if (BP_IS_HOLE(bp)) {
920 bp->blk_prop = 0ULL;
921 return;
922 }
923
924 /*
925 * At L0 we want to verify these fields to ensure that data blocks
926 * can not be reinterpreted. For instance, we do not want an attacker
927 * to trick us into returning raw lz4 compressed data to the user
928 * by modifying the compression bits. At higher levels, we cannot
929 * enforce this policy since raw sends do not convey any information
930 * about indirect blocks, so these values might be different on the
931 * receive side. Fortunately, this does not open any new attack
932 * vectors, since any alterations that can be made to a higher level
933 * bp must still verify the correct order of the layer below it.
934 */
935 if (BP_GET_LEVEL(bp) != 0) {
936 BP_SET_BYTEORDER(bp, 0);
937 BP_SET_COMPRESS(bp, 0);
938
939 /*
940 * psize cannot be set to zero or it will trigger
941 * asserts, but the value doesn't really matter as
942 * long as it is constant.
943 */
944 BP_SET_PSIZE(bp, SPA_MINBLOCKSIZE);
945 }
946
947 BP_SET_DEDUP(bp, 0);
948 BP_SET_CHECKSUM(bp, 0);
949 }
950
951 static void
952 zio_crypt_bp_auth_init(uint64_t version, boolean_t should_bswap, blkptr_t *bp,
953 blkptr_auth_buf_t *bab, uint_t *bab_len)
954 {
955 blkptr_t tmpbp = *bp;
956
957 if (should_bswap)
958 byteswap_uint64_array(&tmpbp, sizeof (blkptr_t));
959
960 ASSERT(BP_USES_CRYPT(&tmpbp) || BP_IS_HOLE(&tmpbp));
961 ASSERT0(BP_IS_EMBEDDED(&tmpbp));
962
963 zio_crypt_decode_mac_bp(&tmpbp, bab->bab_mac);
964
965 /*
966 * We always MAC blk_prop in LE to ensure portability. This
967 * must be done after decoding the mac, since the endianness
968 * will get zero'd out here.
969 */
970 zio_crypt_bp_zero_nonportable_blkprop(&tmpbp, version);
971 bab->bab_prop = LE_64(tmpbp.blk_prop);
972 bab->bab_pad = 0ULL;
973
974 /* version 0 did not include the padding */
975 *bab_len = sizeof (blkptr_auth_buf_t);
976 if (version == 0)
977 *bab_len -= sizeof (uint64_t);
978 }
979
980 static int
981 zio_crypt_bp_do_hmac_updates(crypto_context_t ctx, uint64_t version,
982 boolean_t should_bswap, blkptr_t *bp)
983 {
984 int ret;
985 uint_t bab_len;
986 blkptr_auth_buf_t bab;
987 crypto_data_t cd;
988
989 zio_crypt_bp_auth_init(version, should_bswap, bp, &bab, &bab_len);
990 cd.cd_format = CRYPTO_DATA_RAW;
991 cd.cd_offset = 0;
992 cd.cd_length = bab_len;
993 cd.cd_raw.iov_base = (char *)&bab;
994 cd.cd_raw.iov_len = cd.cd_length;
995
996 ret = crypto_mac_update(ctx, &cd);
997 if (ret != CRYPTO_SUCCESS) {
998 ret = SET_ERROR(EIO);
999 goto error;
1000 }
1001
1002 return (0);
1003
1004 error:
1005 return (ret);
1006 }
1007
1008 static void
1009 zio_crypt_bp_do_indrect_checksum_updates(SHA2_CTX *ctx, uint64_t version,
1010 boolean_t should_bswap, blkptr_t *bp)
1011 {
1012 uint_t bab_len;
1013 blkptr_auth_buf_t bab;
1014
1015 zio_crypt_bp_auth_init(version, should_bswap, bp, &bab, &bab_len);
1016 SHA2Update(ctx, &bab, bab_len);
1017 }
1018
1019 static void
1020 zio_crypt_bp_do_aad_updates(uint8_t **aadp, uint_t *aad_len, uint64_t version,
1021 boolean_t should_bswap, blkptr_t *bp)
1022 {
1023 uint_t bab_len;
1024 blkptr_auth_buf_t bab;
1025
1026 zio_crypt_bp_auth_init(version, should_bswap, bp, &bab, &bab_len);
1027 memcpy(*aadp, &bab, bab_len);
1028 *aadp += bab_len;
1029 *aad_len += bab_len;
1030 }
1031
1032 static int
1033 zio_crypt_do_dnode_hmac_updates(crypto_context_t ctx, uint64_t version,
1034 boolean_t should_bswap, dnode_phys_t *dnp)
1035 {
1036 int ret, i;
1037 dnode_phys_t *adnp, tmp_dncore;
1038 size_t dn_core_size = offsetof(dnode_phys_t, dn_blkptr);
1039 boolean_t le_bswap = (should_bswap == ZFS_HOST_BYTEORDER);
1040 crypto_data_t cd;
1041
1042 cd.cd_format = CRYPTO_DATA_RAW;
1043 cd.cd_offset = 0;
1044
1045 /*
1046 * Authenticate the core dnode (masking out non-portable bits).
1047 * We only copy the first 64 bytes we operate on to avoid the overhead
1048 * of copying 512-64 unneeded bytes. The compiler seems to be fine
1049 * with that.
1050 */
1051 memcpy(&tmp_dncore, dnp, dn_core_size);
1052 adnp = &tmp_dncore;
1053
1054 if (le_bswap) {
1055 adnp->dn_datablkszsec = BSWAP_16(adnp->dn_datablkszsec);
1056 adnp->dn_bonuslen = BSWAP_16(adnp->dn_bonuslen);
1057 adnp->dn_maxblkid = BSWAP_64(adnp->dn_maxblkid);
1058 adnp->dn_used = BSWAP_64(adnp->dn_used);
1059 }
1060 adnp->dn_flags &= DNODE_CRYPT_PORTABLE_FLAGS_MASK;
1061 adnp->dn_used = 0;
1062
1063 cd.cd_length = dn_core_size;
1064 cd.cd_raw.iov_base = (char *)adnp;
1065 cd.cd_raw.iov_len = cd.cd_length;
1066
1067 ret = crypto_mac_update(ctx, &cd);
1068 if (ret != CRYPTO_SUCCESS) {
1069 ret = SET_ERROR(EIO);
1070 goto error;
1071 }
1072
1073 for (i = 0; i < dnp->dn_nblkptr; i++) {
1074 ret = zio_crypt_bp_do_hmac_updates(ctx, version,
1075 should_bswap, &dnp->dn_blkptr[i]);
1076 if (ret != 0)
1077 goto error;
1078 }
1079
1080 if (dnp->dn_flags & DNODE_FLAG_SPILL_BLKPTR) {
1081 ret = zio_crypt_bp_do_hmac_updates(ctx, version,
1082 should_bswap, DN_SPILL_BLKPTR(dnp));
1083 if (ret != 0)
1084 goto error;
1085 }
1086
1087 return (0);
1088
1089 error:
1090 return (ret);
1091 }
1092
1093 /*
1094 * objset_phys_t blocks introduce a number of exceptions to the normal
1095 * authentication process. objset_phys_t's contain 2 separate HMACS for
1096 * protecting the integrity of their data. The portable_mac protects the
1097 * metadnode. This MAC can be sent with a raw send and protects against
1098 * reordering of data within the metadnode. The local_mac protects the user
1099 * accounting objects which are not sent from one system to another.
1100 *
1101 * In addition, objset blocks are the only blocks that can be modified and
1102 * written to disk without the key loaded under certain circumstances. During
1103 * zil_claim() we need to be able to update the zil_header_t to complete
1104 * claiming log blocks and during raw receives we need to write out the
1105 * portable_mac from the send file. Both of these actions are possible
1106 * because these fields are not protected by either MAC so neither one will
1107 * need to modify the MACs without the key. However, when the modified blocks
1108 * are written out they will be byteswapped into the host machine's native
1109 * endianness which will modify fields protected by the MAC. As a result, MAC
1110 * calculation for objset blocks works slightly differently from other block
1111 * types. Where other block types MAC the data in whatever endianness is
1112 * written to disk, objset blocks always MAC little endian version of their
1113 * values. In the code, should_bswap is the value from BP_SHOULD_BYTESWAP()
1114 * and le_bswap indicates whether a byteswap is needed to get this block
1115 * into little endian format.
1116 */
1117 int
1118 zio_crypt_do_objset_hmacs(zio_crypt_key_t *key, void *data, uint_t datalen,
1119 boolean_t should_bswap, uint8_t *portable_mac, uint8_t *local_mac)
1120 {
1121 int ret;
1122 crypto_mechanism_t mech;
1123 crypto_context_t ctx;
1124 crypto_data_t cd;
1125 objset_phys_t *osp = data;
1126 uint64_t intval;
1127 boolean_t le_bswap = (should_bswap == ZFS_HOST_BYTEORDER);
1128 uint8_t raw_portable_mac[SHA512_DIGEST_LENGTH];
1129 uint8_t raw_local_mac[SHA512_DIGEST_LENGTH];
1130
1131 /* initialize HMAC mechanism */
1132 mech.cm_type = crypto_mech2id(SUN_CKM_SHA512_HMAC);
1133 mech.cm_param = NULL;
1134 mech.cm_param_len = 0;
1135
1136 cd.cd_format = CRYPTO_DATA_RAW;
1137 cd.cd_offset = 0;
1138
1139 /* calculate the portable MAC from the portable fields and metadnode */
1140 ret = crypto_mac_init(&mech, &key->zk_hmac_key, NULL, &ctx);
1141 if (ret != CRYPTO_SUCCESS) {
1142 ret = SET_ERROR(EIO);
1143 goto error;
1144 }
1145
1146 /* add in the os_type */
1147 intval = (le_bswap) ? osp->os_type : BSWAP_64(osp->os_type);
1148 cd.cd_length = sizeof (uint64_t);
1149 cd.cd_raw.iov_base = (char *)&intval;
1150 cd.cd_raw.iov_len = cd.cd_length;
1151
1152 ret = crypto_mac_update(ctx, &cd);
1153 if (ret != CRYPTO_SUCCESS) {
1154 ret = SET_ERROR(EIO);
1155 goto error;
1156 }
1157
1158 /* add in the portable os_flags */
1159 intval = osp->os_flags;
1160 if (should_bswap)
1161 intval = BSWAP_64(intval);
1162 intval &= OBJSET_CRYPT_PORTABLE_FLAGS_MASK;
1163 if (!ZFS_HOST_BYTEORDER)
1164 intval = BSWAP_64(intval);
1165
1166 cd.cd_length = sizeof (uint64_t);
1167 cd.cd_raw.iov_base = (char *)&intval;
1168 cd.cd_raw.iov_len = cd.cd_length;
1169
1170 ret = crypto_mac_update(ctx, &cd);
1171 if (ret != CRYPTO_SUCCESS) {
1172 ret = SET_ERROR(EIO);
1173 goto error;
1174 }
1175
1176 /* add in fields from the metadnode */
1177 ret = zio_crypt_do_dnode_hmac_updates(ctx, key->zk_version,
1178 should_bswap, &osp->os_meta_dnode);
1179 if (ret)
1180 goto error;
1181
1182 /* store the final digest in a temporary buffer and copy what we need */
1183 cd.cd_length = SHA512_DIGEST_LENGTH;
1184 cd.cd_raw.iov_base = (char *)raw_portable_mac;
1185 cd.cd_raw.iov_len = cd.cd_length;
1186
1187 ret = crypto_mac_final(ctx, &cd);
1188 if (ret != CRYPTO_SUCCESS) {
1189 ret = SET_ERROR(EIO);
1190 goto error;
1191 }
1192
1193 memcpy(portable_mac, raw_portable_mac, ZIO_OBJSET_MAC_LEN);
1194
1195 /*
1196 * This is necessary here as we check next whether
1197 * OBJSET_FLAG_USERACCOUNTING_COMPLETE is set in order to
1198 * decide if the local_mac should be zeroed out. That flag will always
1199 * be set by dmu_objset_id_quota_upgrade_cb() and
1200 * dmu_objset_userspace_upgrade_cb() if useraccounting has been
1201 * completed.
1202 */
1203 intval = osp->os_flags;
1204 if (should_bswap)
1205 intval = BSWAP_64(intval);
1206 boolean_t uacct_incomplete =
1207 !(intval & OBJSET_FLAG_USERACCOUNTING_COMPLETE);
1208
1209 /*
1210 * The local MAC protects the user, group and project accounting.
1211 * If these objects are not present, the local MAC is zeroed out.
1212 */
1213 if (uacct_incomplete ||
1214 (datalen >= OBJSET_PHYS_SIZE_V3 &&
1215 osp->os_userused_dnode.dn_type == DMU_OT_NONE &&
1216 osp->os_groupused_dnode.dn_type == DMU_OT_NONE &&
1217 osp->os_projectused_dnode.dn_type == DMU_OT_NONE) ||
1218 (datalen >= OBJSET_PHYS_SIZE_V2 &&
1219 osp->os_userused_dnode.dn_type == DMU_OT_NONE &&
1220 osp->os_groupused_dnode.dn_type == DMU_OT_NONE) ||
1221 (datalen <= OBJSET_PHYS_SIZE_V1)) {
1222 memset(local_mac, 0, ZIO_OBJSET_MAC_LEN);
1223 return (0);
1224 }
1225
1226 /* calculate the local MAC from the userused and groupused dnodes */
1227 ret = crypto_mac_init(&mech, &key->zk_hmac_key, NULL, &ctx);
1228 if (ret != CRYPTO_SUCCESS) {
1229 ret = SET_ERROR(EIO);
1230 goto error;
1231 }
1232
1233 /* add in the non-portable os_flags */
1234 intval = osp->os_flags;
1235 if (should_bswap)
1236 intval = BSWAP_64(intval);
1237 intval &= ~OBJSET_CRYPT_PORTABLE_FLAGS_MASK;
1238 if (!ZFS_HOST_BYTEORDER)
1239 intval = BSWAP_64(intval);
1240
1241 cd.cd_length = sizeof (uint64_t);
1242 cd.cd_raw.iov_base = (char *)&intval;
1243 cd.cd_raw.iov_len = cd.cd_length;
1244
1245 ret = crypto_mac_update(ctx, &cd);
1246 if (ret != CRYPTO_SUCCESS) {
1247 ret = SET_ERROR(EIO);
1248 goto error;
1249 }
1250
1251 /* add in fields from the user accounting dnodes */
1252 if (osp->os_userused_dnode.dn_type != DMU_OT_NONE) {
1253 ret = zio_crypt_do_dnode_hmac_updates(ctx, key->zk_version,
1254 should_bswap, &osp->os_userused_dnode);
1255 if (ret)
1256 goto error;
1257 }
1258
1259 if (osp->os_groupused_dnode.dn_type != DMU_OT_NONE) {
1260 ret = zio_crypt_do_dnode_hmac_updates(ctx, key->zk_version,
1261 should_bswap, &osp->os_groupused_dnode);
1262 if (ret)
1263 goto error;
1264 }
1265
1266 if (osp->os_projectused_dnode.dn_type != DMU_OT_NONE &&
1267 datalen >= OBJSET_PHYS_SIZE_V3) {
1268 ret = zio_crypt_do_dnode_hmac_updates(ctx, key->zk_version,
1269 should_bswap, &osp->os_projectused_dnode);
1270 if (ret)
1271 goto error;
1272 }
1273
1274 /* store the final digest in a temporary buffer and copy what we need */
1275 cd.cd_length = SHA512_DIGEST_LENGTH;
1276 cd.cd_raw.iov_base = (char *)raw_local_mac;
1277 cd.cd_raw.iov_len = cd.cd_length;
1278
1279 ret = crypto_mac_final(ctx, &cd);
1280 if (ret != CRYPTO_SUCCESS) {
1281 ret = SET_ERROR(EIO);
1282 goto error;
1283 }
1284
1285 memcpy(local_mac, raw_local_mac, ZIO_OBJSET_MAC_LEN);
1286
1287 return (0);
1288
1289 error:
1290 memset(portable_mac, 0, ZIO_OBJSET_MAC_LEN);
1291 memset(local_mac, 0, ZIO_OBJSET_MAC_LEN);
1292 return (ret);
1293 }
1294
1295 static void
1296 zio_crypt_destroy_uio(zfs_uio_t *uio)
1297 {
1298 if (uio->uio_iov)
1299 kmem_free(uio->uio_iov, uio->uio_iovcnt * sizeof (iovec_t));
1300 }
1301
1302 /*
1303 * This function parses an uncompressed indirect block and returns a checksum
1304 * of all the portable fields from all of the contained bps. The portable
1305 * fields are the MAC and all of the fields from blk_prop except for the dedup,
1306 * checksum, and psize bits. For an explanation of the purpose of this, see
1307 * the comment block on object set authentication.
1308 */
1309 static int
1310 zio_crypt_do_indirect_mac_checksum_impl(boolean_t generate, void *buf,
1311 uint_t datalen, uint64_t version, boolean_t byteswap, uint8_t *cksum)
1312 {
1313 blkptr_t *bp;
1314 int i, epb = datalen >> SPA_BLKPTRSHIFT;
1315 SHA2_CTX ctx;
1316 uint8_t digestbuf[SHA512_DIGEST_LENGTH];
1317
1318 /* checksum all of the MACs from the layer below */
1319 SHA2Init(SHA512, &ctx);
1320 for (i = 0, bp = buf; i < epb; i++, bp++) {
1321 zio_crypt_bp_do_indrect_checksum_updates(&ctx, version,
1322 byteswap, bp);
1323 }
1324 SHA2Final(digestbuf, &ctx);
1325
1326 if (generate) {
1327 memcpy(cksum, digestbuf, ZIO_DATA_MAC_LEN);
1328 return (0);
1329 }
1330
1331 if (memcmp(digestbuf, cksum, ZIO_DATA_MAC_LEN) != 0)
1332 return (SET_ERROR(ECKSUM));
1333
1334 return (0);
1335 }
1336
1337 int
1338 zio_crypt_do_indirect_mac_checksum(boolean_t generate, void *buf,
1339 uint_t datalen, boolean_t byteswap, uint8_t *cksum)
1340 {
1341 int ret;
1342
1343 /*
1344 * Unfortunately, callers of this function will not always have
1345 * easy access to the on-disk format version. This info is
1346 * normally found in the DSL Crypto Key, but the checksum-of-MACs
1347 * is expected to be verifiable even when the key isn't loaded.
1348 * Here, instead of doing a ZAP lookup for the version for each
1349 * zio, we simply try both existing formats.
1350 */
1351 ret = zio_crypt_do_indirect_mac_checksum_impl(generate, buf,
1352 datalen, ZIO_CRYPT_KEY_CURRENT_VERSION, byteswap, cksum);
1353 if (ret == ECKSUM) {
1354 ASSERT(!generate);
1355 ret = zio_crypt_do_indirect_mac_checksum_impl(generate,
1356 buf, datalen, 0, byteswap, cksum);
1357 }
1358
1359 return (ret);
1360 }
1361
1362 int
1363 zio_crypt_do_indirect_mac_checksum_abd(boolean_t generate, abd_t *abd,
1364 uint_t datalen, boolean_t byteswap, uint8_t *cksum)
1365 {
1366 int ret;
1367 void *buf;
1368
1369 buf = abd_borrow_buf_copy(abd, datalen);
1370 ret = zio_crypt_do_indirect_mac_checksum(generate, buf, datalen,
1371 byteswap, cksum);
1372 abd_return_buf(abd, buf, datalen);
1373
1374 return (ret);
1375 }
1376
1377 /*
1378 * Special case handling routine for encrypting / decrypting ZIL blocks.
1379 * We do not check for the older ZIL chain because the encryption feature
1380 * was not available before the newer ZIL chain was introduced. The goal
1381 * here is to encrypt everything except the blkptr_t of a lr_write_t and
1382 * the zil_chain_t header. Everything that is not encrypted is authenticated.
1383 */
1384 static int
1385 zio_crypt_init_uios_zil(boolean_t encrypt, uint8_t *plainbuf,
1386 uint8_t *cipherbuf, uint_t datalen, boolean_t byteswap, zfs_uio_t *puio,
1387 zfs_uio_t *cuio, uint_t *enc_len, uint8_t **authbuf, uint_t *auth_len,
1388 boolean_t *no_crypt)
1389 {
1390 int ret;
1391 uint64_t txtype, lr_len;
1392 uint_t nr_src, nr_dst, crypt_len;
1393 uint_t aad_len = 0, nr_iovecs = 0, total_len = 0;
1394 iovec_t *src_iovecs = NULL, *dst_iovecs = NULL;
1395 uint8_t *src, *dst, *slrp, *dlrp, *blkend, *aadp;
1396 zil_chain_t *zilc;
1397 lr_t *lr;
1398 uint8_t *aadbuf = zio_buf_alloc(datalen);
1399
1400 /* cipherbuf always needs an extra iovec for the MAC */
1401 if (encrypt) {
1402 src = plainbuf;
1403 dst = cipherbuf;
1404 nr_src = 0;
1405 nr_dst = 1;
1406 } else {
1407 src = cipherbuf;
1408 dst = plainbuf;
1409 nr_src = 1;
1410 nr_dst = 0;
1411 }
1412 memset(dst, 0, datalen);
1413
1414 /* find the start and end record of the log block */
1415 zilc = (zil_chain_t *)src;
1416 slrp = src + sizeof (zil_chain_t);
1417 aadp = aadbuf;
1418 blkend = src + ((byteswap) ? BSWAP_64(zilc->zc_nused) : zilc->zc_nused);
1419
1420 /* calculate the number of encrypted iovecs we will need */
1421 for (; slrp < blkend; slrp += lr_len) {
1422 lr = (lr_t *)slrp;
1423
1424 if (!byteswap) {
1425 txtype = lr->lrc_txtype;
1426 lr_len = lr->lrc_reclen;
1427 } else {
1428 txtype = BSWAP_64(lr->lrc_txtype);
1429 lr_len = BSWAP_64(lr->lrc_reclen);
1430 }
1431
1432 nr_iovecs++;
1433 if (txtype == TX_WRITE && lr_len != sizeof (lr_write_t))
1434 nr_iovecs++;
1435 }
1436
1437 nr_src += nr_iovecs;
1438 nr_dst += nr_iovecs;
1439
1440 /* allocate the iovec arrays */
1441 if (nr_src != 0) {
1442 src_iovecs = kmem_alloc(nr_src * sizeof (iovec_t), KM_SLEEP);
1443 if (src_iovecs == NULL) {
1444 ret = SET_ERROR(ENOMEM);
1445 goto error;
1446 }
1447 }
1448
1449 if (nr_dst != 0) {
1450 dst_iovecs = kmem_alloc(nr_dst * sizeof (iovec_t), KM_SLEEP);
1451 if (dst_iovecs == NULL) {
1452 ret = SET_ERROR(ENOMEM);
1453 goto error;
1454 }
1455 }
1456
1457 /*
1458 * Copy the plain zil header over and authenticate everything except
1459 * the checksum that will store our MAC. If we are writing the data
1460 * the embedded checksum will not have been calculated yet, so we don't
1461 * authenticate that.
1462 */
1463 memcpy(dst, src, sizeof (zil_chain_t));
1464 memcpy(aadp, src, sizeof (zil_chain_t) - sizeof (zio_eck_t));
1465 aadp += sizeof (zil_chain_t) - sizeof (zio_eck_t);
1466 aad_len += sizeof (zil_chain_t) - sizeof (zio_eck_t);
1467
1468 /* loop over records again, filling in iovecs */
1469 nr_iovecs = 0;
1470 slrp = src + sizeof (zil_chain_t);
1471 dlrp = dst + sizeof (zil_chain_t);
1472
1473 for (; slrp < blkend; slrp += lr_len, dlrp += lr_len) {
1474 lr = (lr_t *)slrp;
1475
1476 if (!byteswap) {
1477 txtype = lr->lrc_txtype;
1478 lr_len = lr->lrc_reclen;
1479 } else {
1480 txtype = BSWAP_64(lr->lrc_txtype);
1481 lr_len = BSWAP_64(lr->lrc_reclen);
1482 }
1483
1484 /* copy the common lr_t */
1485 memcpy(dlrp, slrp, sizeof (lr_t));
1486 memcpy(aadp, slrp, sizeof (lr_t));
1487 aadp += sizeof (lr_t);
1488 aad_len += sizeof (lr_t);
1489
1490 ASSERT3P(src_iovecs, !=, NULL);
1491 ASSERT3P(dst_iovecs, !=, NULL);
1492
1493 /*
1494 * If this is a TX_WRITE record we want to encrypt everything
1495 * except the bp if exists. If the bp does exist we want to
1496 * authenticate it.
1497 */
1498 if (txtype == TX_WRITE) {
1499 crypt_len = sizeof (lr_write_t) -
1500 sizeof (lr_t) - sizeof (blkptr_t);
1501 src_iovecs[nr_iovecs].iov_base = slrp + sizeof (lr_t);
1502 src_iovecs[nr_iovecs].iov_len = crypt_len;
1503 dst_iovecs[nr_iovecs].iov_base = dlrp + sizeof (lr_t);
1504 dst_iovecs[nr_iovecs].iov_len = crypt_len;
1505
1506 /* copy the bp now since it will not be encrypted */
1507 memcpy(dlrp + sizeof (lr_write_t) - sizeof (blkptr_t),
1508 slrp + sizeof (lr_write_t) - sizeof (blkptr_t),
1509 sizeof (blkptr_t));
1510 memcpy(aadp,
1511 slrp + sizeof (lr_write_t) - sizeof (blkptr_t),
1512 sizeof (blkptr_t));
1513 aadp += sizeof (blkptr_t);
1514 aad_len += sizeof (blkptr_t);
1515 nr_iovecs++;
1516 total_len += crypt_len;
1517
1518 if (lr_len != sizeof (lr_write_t)) {
1519 crypt_len = lr_len - sizeof (lr_write_t);
1520 src_iovecs[nr_iovecs].iov_base =
1521 slrp + sizeof (lr_write_t);
1522 src_iovecs[nr_iovecs].iov_len = crypt_len;
1523 dst_iovecs[nr_iovecs].iov_base =
1524 dlrp + sizeof (lr_write_t);
1525 dst_iovecs[nr_iovecs].iov_len = crypt_len;
1526 nr_iovecs++;
1527 total_len += crypt_len;
1528 }
1529 } else {
1530 crypt_len = lr_len - sizeof (lr_t);
1531 src_iovecs[nr_iovecs].iov_base = slrp + sizeof (lr_t);
1532 src_iovecs[nr_iovecs].iov_len = crypt_len;
1533 dst_iovecs[nr_iovecs].iov_base = dlrp + sizeof (lr_t);
1534 dst_iovecs[nr_iovecs].iov_len = crypt_len;
1535 nr_iovecs++;
1536 total_len += crypt_len;
1537 }
1538 }
1539
1540 *no_crypt = (nr_iovecs == 0);
1541 *enc_len = total_len;
1542 *authbuf = aadbuf;
1543 *auth_len = aad_len;
1544
1545 if (encrypt) {
1546 puio->uio_iov = src_iovecs;
1547 puio->uio_iovcnt = nr_src;
1548 cuio->uio_iov = dst_iovecs;
1549 cuio->uio_iovcnt = nr_dst;
1550 } else {
1551 puio->uio_iov = dst_iovecs;
1552 puio->uio_iovcnt = nr_dst;
1553 cuio->uio_iov = src_iovecs;
1554 cuio->uio_iovcnt = nr_src;
1555 }
1556
1557 return (0);
1558
1559 error:
1560 zio_buf_free(aadbuf, datalen);
1561 if (src_iovecs != NULL)
1562 kmem_free(src_iovecs, nr_src * sizeof (iovec_t));
1563 if (dst_iovecs != NULL)
1564 kmem_free(dst_iovecs, nr_dst * sizeof (iovec_t));
1565
1566 *enc_len = 0;
1567 *authbuf = NULL;
1568 *auth_len = 0;
1569 *no_crypt = B_FALSE;
1570 puio->uio_iov = NULL;
1571 puio->uio_iovcnt = 0;
1572 cuio->uio_iov = NULL;
1573 cuio->uio_iovcnt = 0;
1574 return (ret);
1575 }
1576
1577 /*
1578 * Special case handling routine for encrypting / decrypting dnode blocks.
1579 */
1580 static int
1581 zio_crypt_init_uios_dnode(boolean_t encrypt, uint64_t version,
1582 uint8_t *plainbuf, uint8_t *cipherbuf, uint_t datalen, boolean_t byteswap,
1583 zfs_uio_t *puio, zfs_uio_t *cuio, uint_t *enc_len, uint8_t **authbuf,
1584 uint_t *auth_len, boolean_t *no_crypt)
1585 {
1586 int ret;
1587 uint_t nr_src, nr_dst, crypt_len;
1588 uint_t aad_len = 0, nr_iovecs = 0, total_len = 0;
1589 uint_t i, j, max_dnp = datalen >> DNODE_SHIFT;
1590 iovec_t *src_iovecs = NULL, *dst_iovecs = NULL;
1591 uint8_t *src, *dst, *aadp;
1592 dnode_phys_t *dnp, *adnp, *sdnp, *ddnp;
1593 uint8_t *aadbuf = zio_buf_alloc(datalen);
1594
1595 if (encrypt) {
1596 src = plainbuf;
1597 dst = cipherbuf;
1598 nr_src = 0;
1599 nr_dst = 1;
1600 } else {
1601 src = cipherbuf;
1602 dst = plainbuf;
1603 nr_src = 1;
1604 nr_dst = 0;
1605 }
1606
1607 sdnp = (dnode_phys_t *)src;
1608 ddnp = (dnode_phys_t *)dst;
1609 aadp = aadbuf;
1610
1611 /*
1612 * Count the number of iovecs we will need to do the encryption by
1613 * counting the number of bonus buffers that need to be encrypted.
1614 */
1615 for (i = 0; i < max_dnp; i += sdnp[i].dn_extra_slots + 1) {
1616 /*
1617 * This block may still be byteswapped. However, all of the
1618 * values we use are either uint8_t's (for which byteswapping
1619 * is a noop) or a * != 0 check, which will work regardless
1620 * of whether or not we byteswap.
1621 */
1622 if (sdnp[i].dn_type != DMU_OT_NONE &&
1623 DMU_OT_IS_ENCRYPTED(sdnp[i].dn_bonustype) &&
1624 sdnp[i].dn_bonuslen != 0) {
1625 nr_iovecs++;
1626 }
1627 }
1628
1629 nr_src += nr_iovecs;
1630 nr_dst += nr_iovecs;
1631
1632 if (nr_src != 0) {
1633 src_iovecs = kmem_alloc(nr_src * sizeof (iovec_t), KM_SLEEP);
1634 if (src_iovecs == NULL) {
1635 ret = SET_ERROR(ENOMEM);
1636 goto error;
1637 }
1638 }
1639
1640 if (nr_dst != 0) {
1641 dst_iovecs = kmem_alloc(nr_dst * sizeof (iovec_t), KM_SLEEP);
1642 if (dst_iovecs == NULL) {
1643 ret = SET_ERROR(ENOMEM);
1644 goto error;
1645 }
1646 }
1647
1648 nr_iovecs = 0;
1649
1650 /*
1651 * Iterate through the dnodes again, this time filling in the uios
1652 * we allocated earlier. We also concatenate any data we want to
1653 * authenticate onto aadbuf.
1654 */
1655 for (i = 0; i < max_dnp; i += sdnp[i].dn_extra_slots + 1) {
1656 dnp = &sdnp[i];
1657
1658 /* copy over the core fields and blkptrs (kept as plaintext) */
1659 memcpy(&ddnp[i], dnp,
1660 (uint8_t *)DN_BONUS(dnp) - (uint8_t *)dnp);
1661
1662 if (dnp->dn_flags & DNODE_FLAG_SPILL_BLKPTR) {
1663 memcpy(DN_SPILL_BLKPTR(&ddnp[i]), DN_SPILL_BLKPTR(dnp),
1664 sizeof (blkptr_t));
1665 }
1666
1667 /*
1668 * Handle authenticated data. We authenticate everything in
1669 * the dnode that can be brought over when we do a raw send.
1670 * This includes all of the core fields as well as the MACs
1671 * stored in the bp checksums and all of the portable bits
1672 * from blk_prop. We include the dnode padding here in case it
1673 * ever gets used in the future. Some dn_flags and dn_used are
1674 * not portable so we mask those out values out of the
1675 * authenticated data.
1676 */
1677 crypt_len = offsetof(dnode_phys_t, dn_blkptr);
1678 memcpy(aadp, dnp, crypt_len);
1679 adnp = (dnode_phys_t *)aadp;
1680 adnp->dn_flags &= DNODE_CRYPT_PORTABLE_FLAGS_MASK;
1681 adnp->dn_used = 0;
1682 aadp += crypt_len;
1683 aad_len += crypt_len;
1684
1685 for (j = 0; j < dnp->dn_nblkptr; j++) {
1686 zio_crypt_bp_do_aad_updates(&aadp, &aad_len,
1687 version, byteswap, &dnp->dn_blkptr[j]);
1688 }
1689
1690 if (dnp->dn_flags & DNODE_FLAG_SPILL_BLKPTR) {
1691 zio_crypt_bp_do_aad_updates(&aadp, &aad_len,
1692 version, byteswap, DN_SPILL_BLKPTR(dnp));
1693 }
1694
1695 /*
1696 * If this bonus buffer needs to be encrypted, we prepare an
1697 * iovec_t. The encryption / decryption functions will fill
1698 * this in for us with the encrypted or decrypted data.
1699 * Otherwise we add the bonus buffer to the authenticated
1700 * data buffer and copy it over to the destination. The
1701 * encrypted iovec extends to DN_MAX_BONUS_LEN(dnp) so that
1702 * we can guarantee alignment with the AES block size
1703 * (128 bits).
1704 */
1705 crypt_len = DN_MAX_BONUS_LEN(dnp);
1706 if (dnp->dn_type != DMU_OT_NONE &&
1707 DMU_OT_IS_ENCRYPTED(dnp->dn_bonustype) &&
1708 dnp->dn_bonuslen != 0) {
1709 ASSERT3U(nr_iovecs, <, nr_src);
1710 ASSERT3U(nr_iovecs, <, nr_dst);
1711 ASSERT3P(src_iovecs, !=, NULL);
1712 ASSERT3P(dst_iovecs, !=, NULL);
1713 src_iovecs[nr_iovecs].iov_base = DN_BONUS(dnp);
1714 src_iovecs[nr_iovecs].iov_len = crypt_len;
1715 dst_iovecs[nr_iovecs].iov_base = DN_BONUS(&ddnp[i]);
1716 dst_iovecs[nr_iovecs].iov_len = crypt_len;
1717
1718 nr_iovecs++;
1719 total_len += crypt_len;
1720 } else {
1721 memcpy(DN_BONUS(&ddnp[i]), DN_BONUS(dnp), crypt_len);
1722 memcpy(aadp, DN_BONUS(dnp), crypt_len);
1723 aadp += crypt_len;
1724 aad_len += crypt_len;
1725 }
1726 }
1727
1728 *no_crypt = (nr_iovecs == 0);
1729 *enc_len = total_len;
1730 *authbuf = aadbuf;
1731 *auth_len = aad_len;
1732
1733 if (encrypt) {
1734 puio->uio_iov = src_iovecs;
1735 puio->uio_iovcnt = nr_src;
1736 cuio->uio_iov = dst_iovecs;
1737 cuio->uio_iovcnt = nr_dst;
1738 } else {
1739 puio->uio_iov = dst_iovecs;
1740 puio->uio_iovcnt = nr_dst;
1741 cuio->uio_iov = src_iovecs;
1742 cuio->uio_iovcnt = nr_src;
1743 }
1744
1745 return (0);
1746
1747 error:
1748 zio_buf_free(aadbuf, datalen);
1749 if (src_iovecs != NULL)
1750 kmem_free(src_iovecs, nr_src * sizeof (iovec_t));
1751 if (dst_iovecs != NULL)
1752 kmem_free(dst_iovecs, nr_dst * sizeof (iovec_t));
1753
1754 *enc_len = 0;
1755 *authbuf = NULL;
1756 *auth_len = 0;
1757 *no_crypt = B_FALSE;
1758 puio->uio_iov = NULL;
1759 puio->uio_iovcnt = 0;
1760 cuio->uio_iov = NULL;
1761 cuio->uio_iovcnt = 0;
1762 return (ret);
1763 }
1764
1765 static int
1766 zio_crypt_init_uios_normal(boolean_t encrypt, uint8_t *plainbuf,
1767 uint8_t *cipherbuf, uint_t datalen, zfs_uio_t *puio, zfs_uio_t *cuio,
1768 uint_t *enc_len)
1769 {
1770 (void) encrypt;
1771 int ret;
1772 uint_t nr_plain = 1, nr_cipher = 2;
1773 iovec_t *plain_iovecs = NULL, *cipher_iovecs = NULL;
1774
1775 /* allocate the iovecs for the plain and cipher data */
1776 plain_iovecs = kmem_alloc(nr_plain * sizeof (iovec_t),
1777 KM_SLEEP);
1778 if (!plain_iovecs) {
1779 ret = SET_ERROR(ENOMEM);
1780 goto error;
1781 }
1782
1783 cipher_iovecs = kmem_alloc(nr_cipher * sizeof (iovec_t),
1784 KM_SLEEP);
1785 if (!cipher_iovecs) {
1786 ret = SET_ERROR(ENOMEM);
1787 goto error;
1788 }
1789
1790 plain_iovecs[0].iov_base = plainbuf;
1791 plain_iovecs[0].iov_len = datalen;
1792 cipher_iovecs[0].iov_base = cipherbuf;
1793 cipher_iovecs[0].iov_len = datalen;
1794
1795 *enc_len = datalen;
1796 puio->uio_iov = plain_iovecs;
1797 puio->uio_iovcnt = nr_plain;
1798 cuio->uio_iov = cipher_iovecs;
1799 cuio->uio_iovcnt = nr_cipher;
1800
1801 return (0);
1802
1803 error:
1804 if (plain_iovecs != NULL)
1805 kmem_free(plain_iovecs, nr_plain * sizeof (iovec_t));
1806 if (cipher_iovecs != NULL)
1807 kmem_free(cipher_iovecs, nr_cipher * sizeof (iovec_t));
1808
1809 *enc_len = 0;
1810 puio->uio_iov = NULL;
1811 puio->uio_iovcnt = 0;
1812 cuio->uio_iov = NULL;
1813 cuio->uio_iovcnt = 0;
1814 return (ret);
1815 }
1816
1817 /*
1818 * This function builds up the plaintext (puio) and ciphertext (cuio) uios so
1819 * that they can be used for encryption and decryption by zio_do_crypt_uio().
1820 * Most blocks will use zio_crypt_init_uios_normal(), with ZIL and dnode blocks
1821 * requiring special handling to parse out pieces that are to be encrypted. The
1822 * authbuf is used by these special cases to store additional authenticated
1823 * data (AAD) for the encryption modes.
1824 */
1825 static int
1826 zio_crypt_init_uios(boolean_t encrypt, uint64_t version, dmu_object_type_t ot,
1827 uint8_t *plainbuf, uint8_t *cipherbuf, uint_t datalen, boolean_t byteswap,
1828 uint8_t *mac, zfs_uio_t *puio, zfs_uio_t *cuio, uint_t *enc_len,
1829 uint8_t **authbuf, uint_t *auth_len, boolean_t *no_crypt)
1830 {
1831 int ret;
1832 iovec_t *mac_iov;
1833
1834 ASSERT(DMU_OT_IS_ENCRYPTED(ot) || ot == DMU_OT_NONE);
1835
1836 /* route to handler */
1837 switch (ot) {
1838 case DMU_OT_INTENT_LOG:
1839 ret = zio_crypt_init_uios_zil(encrypt, plainbuf, cipherbuf,
1840 datalen, byteswap, puio, cuio, enc_len, authbuf, auth_len,
1841 no_crypt);
1842 break;
1843 case DMU_OT_DNODE:
1844 ret = zio_crypt_init_uios_dnode(encrypt, version, plainbuf,
1845 cipherbuf, datalen, byteswap, puio, cuio, enc_len, authbuf,
1846 auth_len, no_crypt);
1847 break;
1848 default:
1849 ret = zio_crypt_init_uios_normal(encrypt, plainbuf, cipherbuf,
1850 datalen, puio, cuio, enc_len);
1851 *authbuf = NULL;
1852 *auth_len = 0;
1853 *no_crypt = B_FALSE;
1854 break;
1855 }
1856
1857 if (ret != 0)
1858 goto error;
1859
1860 /* populate the uios */
1861 puio->uio_segflg = UIO_SYSSPACE;
1862 cuio->uio_segflg = UIO_SYSSPACE;
1863
1864 mac_iov = ((iovec_t *)&cuio->uio_iov[cuio->uio_iovcnt - 1]);
1865 mac_iov->iov_base = mac;
1866 mac_iov->iov_len = ZIO_DATA_MAC_LEN;
1867
1868 return (0);
1869
1870 error:
1871 return (ret);
1872 }
1873
1874 /*
1875 * Primary encryption / decryption entrypoint for zio data.
1876 */
1877 int
1878 zio_do_crypt_data(boolean_t encrypt, zio_crypt_key_t *key,
1879 dmu_object_type_t ot, boolean_t byteswap, uint8_t *salt, uint8_t *iv,
1880 uint8_t *mac, uint_t datalen, uint8_t *plainbuf, uint8_t *cipherbuf,
1881 boolean_t *no_crypt)
1882 {
1883 int ret;
1884 boolean_t locked = B_FALSE;
1885 uint64_t crypt = key->zk_crypt;
1886 uint_t keydata_len = zio_crypt_table[crypt].ci_keylen;
1887 uint_t enc_len, auth_len;
1888 zfs_uio_t puio, cuio;
1889 uint8_t enc_keydata[MASTER_KEY_MAX_LEN];
1890 crypto_key_t tmp_ckey, *ckey = NULL;
1891 crypto_ctx_template_t tmpl;
1892 uint8_t *authbuf = NULL;
1893
1894 /*
1895 * If the needed key is the current one, just use it. Otherwise we
1896 * need to generate a temporary one from the given salt + master key.
1897 * If we are encrypting, we must return a copy of the current salt
1898 * so that it can be stored in the blkptr_t.
1899 */
1900 rw_enter(&key->zk_salt_lock, RW_READER);
1901 locked = B_TRUE;
1902
1903 if (memcmp(salt, key->zk_salt, ZIO_DATA_SALT_LEN) == 0) {
1904 ckey = &key->zk_current_key;
1905 tmpl = key->zk_current_tmpl;
1906 } else {
1907 rw_exit(&key->zk_salt_lock);
1908 locked = B_FALSE;
1909
1910 ret = hkdf_sha512(key->zk_master_keydata, keydata_len, NULL, 0,
1911 salt, ZIO_DATA_SALT_LEN, enc_keydata, keydata_len);
1912 if (ret != 0)
1913 goto error;
1914
1915 tmp_ckey.ck_data = enc_keydata;
1916 tmp_ckey.ck_length = CRYPTO_BYTES2BITS(keydata_len);
1917
1918 ckey = &tmp_ckey;
1919 tmpl = NULL;
1920 }
1921
1922 /*
1923 * Attempt to use QAT acceleration if we can. We currently don't
1924 * do this for metadnode and ZIL blocks, since they have a much
1925 * more involved buffer layout and the qat_crypt() function only
1926 * works in-place.
1927 */
1928 if (qat_crypt_use_accel(datalen) &&
1929 ot != DMU_OT_INTENT_LOG && ot != DMU_OT_DNODE) {
1930 uint8_t *srcbuf, *dstbuf;
1931
1932 if (encrypt) {
1933 srcbuf = plainbuf;
1934 dstbuf = cipherbuf;
1935 } else {
1936 srcbuf = cipherbuf;
1937 dstbuf = plainbuf;
1938 }
1939
1940 ret = qat_crypt((encrypt) ? QAT_ENCRYPT : QAT_DECRYPT, srcbuf,
1941 dstbuf, NULL, 0, iv, mac, ckey, key->zk_crypt, datalen);
1942 if (ret == CPA_STATUS_SUCCESS) {
1943 if (locked) {
1944 rw_exit(&key->zk_salt_lock);
1945 locked = B_FALSE;
1946 }
1947
1948 return (0);
1949 }
1950 /* If the hardware implementation fails fall back to software */
1951 }
1952
1953 memset(&puio, 0, sizeof (puio));
1954 memset(&cuio, 0, sizeof (cuio));
1955
1956 /* create uios for encryption */
1957 ret = zio_crypt_init_uios(encrypt, key->zk_version, ot, plainbuf,
1958 cipherbuf, datalen, byteswap, mac, &puio, &cuio, &enc_len,
1959 &authbuf, &auth_len, no_crypt);
1960 if (ret != 0)
1961 goto error;
1962
1963 /* perform the encryption / decryption in software */
1964 ret = zio_do_crypt_uio(encrypt, key->zk_crypt, ckey, tmpl, iv, enc_len,
1965 &puio, &cuio, authbuf, auth_len);
1966 if (ret != 0)
1967 goto error;
1968
1969 if (locked) {
1970 rw_exit(&key->zk_salt_lock);
1971 locked = B_FALSE;
1972 }
1973
1974 if (authbuf != NULL)
1975 zio_buf_free(authbuf, datalen);
1976 if (ckey == &tmp_ckey)
1977 memset(enc_keydata, 0, keydata_len);
1978 zio_crypt_destroy_uio(&puio);
1979 zio_crypt_destroy_uio(&cuio);
1980
1981 return (0);
1982
1983 error:
1984 if (locked)
1985 rw_exit(&key->zk_salt_lock);
1986 if (authbuf != NULL)
1987 zio_buf_free(authbuf, datalen);
1988 if (ckey == &tmp_ckey)
1989 memset(enc_keydata, 0, keydata_len);
1990 zio_crypt_destroy_uio(&puio);
1991 zio_crypt_destroy_uio(&cuio);
1992
1993 return (ret);
1994 }
1995
1996 /*
1997 * Simple wrapper around zio_do_crypt_data() to work with abd's instead of
1998 * linear buffers.
1999 */
2000 int
2001 zio_do_crypt_abd(boolean_t encrypt, zio_crypt_key_t *key, dmu_object_type_t ot,
2002 boolean_t byteswap, uint8_t *salt, uint8_t *iv, uint8_t *mac,
2003 uint_t datalen, abd_t *pabd, abd_t *cabd, boolean_t *no_crypt)
2004 {
2005 int ret;
2006 void *ptmp, *ctmp;
2007
2008 if (encrypt) {
2009 ptmp = abd_borrow_buf_copy(pabd, datalen);
2010 ctmp = abd_borrow_buf(cabd, datalen);
2011 } else {
2012 ptmp = abd_borrow_buf(pabd, datalen);
2013 ctmp = abd_borrow_buf_copy(cabd, datalen);
2014 }
2015
2016 ret = zio_do_crypt_data(encrypt, key, ot, byteswap, salt, iv, mac,
2017 datalen, ptmp, ctmp, no_crypt);
2018 if (ret != 0)
2019 goto error;
2020
2021 if (encrypt) {
2022 abd_return_buf(pabd, ptmp, datalen);
2023 abd_return_buf_copy(cabd, ctmp, datalen);
2024 } else {
2025 abd_return_buf_copy(pabd, ptmp, datalen);
2026 abd_return_buf(cabd, ctmp, datalen);
2027 }
2028
2029 return (0);
2030
2031 error:
2032 if (encrypt) {
2033 abd_return_buf(pabd, ptmp, datalen);
2034 abd_return_buf_copy(cabd, ctmp, datalen);
2035 } else {
2036 abd_return_buf_copy(pabd, ptmp, datalen);
2037 abd_return_buf(cabd, ctmp, datalen);
2038 }
2039
2040 return (ret);
2041 }
2042
2043 #if defined(_KERNEL)
2044 /* CSTYLED */
2045 module_param(zfs_key_max_salt_uses, ulong, 0644);
2046 MODULE_PARM_DESC(zfs_key_max_salt_uses, "Max number of times a salt value "
2047 "can be used for generating encryption keys before it is rotated");
2048 #endif