/***************************************************************************** Copyright (C) 2013, 2015, Google Inc. All Rights Reserved. Copyright (C) 2014, 2021, MariaDB Corporation. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1335 USA *****************************************************************************/ /**************************************************//** @file log0crypt.cc Innodb log encrypt/decrypt Created 11/25/2013 Minli Zhu Google Modified Jan Lindström jan.lindstrom@mariadb.com MDEV-11782: Rewritten for MariaDB 10.2 by Marko Mäkelä, MariaDB Corporation. *******************************************************/ #include #include "log0crypt.h" #include #include "assume_aligned.h" #include "log0crypt.h" #include "log0recv.h" // for recv_sys /** innodb_encrypt_log: whether to encrypt the redo log */ my_bool srv_encrypt_log; /** Redo log encryption key ID */ #define LOG_DEFAULT_ENCRYPTION_KEY 1 struct crypt_info_t { ulint checkpoint_no; /*!< checkpoint no; 32 bits */ uint key_version; /*!< mysqld key version */ /** random string for encrypting the key */ alignas(8) byte crypt_msg[MY_AES_BLOCK_SIZE]; /** the secret key */ alignas(8) byte crypt_key[MY_AES_BLOCK_SIZE]; /** a random string for the per-block initialization vector */ alignas(4) byte crypt_nonce[4]; }; /** The crypt info */ static crypt_info_t info; /** Initialization vector used for temporary files/tablespace */ static byte tmp_iv[MY_AES_BLOCK_SIZE]; /** Crypt info when upgrading from 10.1 */ static crypt_info_t infos[5 * 2]; /** First unused slot in infos[] */ static size_t infos_used; /*********************************************************************//** Get a log block's start lsn. @return a log block's start lsn */ static inline lsn_t log_block_get_start_lsn( /*====================*/ lsn_t lsn, /*!< in: checkpoint lsn */ ulint log_block_no) /*!< in: log block number */ { lsn_t start_lsn = (lsn & (lsn_t)0xffffffff00000000ULL) | (((log_block_no - 1) & (lsn_t)0x3fffffff) << 9); return start_lsn; } /** Generate crypt key from crypt msg. @param[in,out] info encryption key @param[in] upgrade whether to use the key in MariaDB 10.1 format @return whether the operation was successful */ static bool init_crypt_key(crypt_info_t* info, bool upgrade = false) { byte mysqld_key[MY_AES_MAX_KEY_LENGTH]; uint keylen = sizeof mysqld_key; compile_time_assert(16 == sizeof info->crypt_key); compile_time_assert(16 == MY_AES_BLOCK_SIZE); if (uint rc = encryption_key_get(LOG_DEFAULT_ENCRYPTION_KEY, info->key_version, mysqld_key, &keylen)) { ib::error() << "Obtaining redo log encryption key version " << info->key_version << " failed (" << rc << "). Maybe the key or the required encryption " "key management plugin was not found."; info->key_version = ENCRYPTION_KEY_VERSION_INVALID; return false; } if (upgrade) { while (keylen < sizeof mysqld_key) { mysqld_key[keylen++] = 0; } } uint dst_len; int err= my_aes_crypt(MY_AES_ECB, ENCRYPTION_FLAG_NOPAD | ENCRYPTION_FLAG_ENCRYPT, info->crypt_msg, MY_AES_BLOCK_SIZE, info->crypt_key, &dst_len, mysqld_key, keylen, NULL, 0); if (err != MY_AES_OK || dst_len != MY_AES_BLOCK_SIZE) { ib::error() << "Getting redo log crypto key failed: err = " << err << ", len = " << dst_len; info->key_version = ENCRYPTION_KEY_VERSION_INVALID; return false; } return true; } /** Encrypt or decrypt log blocks. @param[in,out] buf log blocks to encrypt or decrypt @param[in] lsn log sequence number of the start of the buffer @param[in] size size of the buffer, in bytes @param[in] op whether to decrypt, encrypt, or rotate key and encrypt @return whether the operation succeeded (encrypt always does) */ bool log_crypt(byte* buf, lsn_t lsn, ulint size, log_crypt_t op) { ut_ad(size % OS_FILE_LOG_BLOCK_SIZE == 0); ut_ad(ulint(buf) % OS_FILE_LOG_BLOCK_SIZE == 0); ut_a(info.key_version); alignas(8) byte aes_ctr_iv[MY_AES_BLOCK_SIZE]; #define LOG_CRYPT_HDR_SIZE 4 lsn &= ~lsn_t(OS_FILE_LOG_BLOCK_SIZE - 1); for (const byte* const end = buf + size; buf != end; buf += OS_FILE_LOG_BLOCK_SIZE, lsn += OS_FILE_LOG_BLOCK_SIZE) { alignas(4) byte dst[OS_FILE_LOG_BLOCK_SIZE - LOG_CRYPT_HDR_SIZE - LOG_BLOCK_CHECKSUM]; /* The log block number is not encrypted. */ memcpy_aligned<4>(dst, buf + LOG_BLOCK_HDR_NO, 4); memcpy_aligned<4>(aes_ctr_iv, buf + LOG_BLOCK_HDR_NO, 4); *aes_ctr_iv &= byte(~(LOG_BLOCK_FLUSH_BIT_MASK >> 24)); static_assert(LOG_BLOCK_HDR_NO + 4 == LOG_CRYPT_HDR_SIZE, "compatibility"); memcpy_aligned<4>(aes_ctr_iv + 4, info.crypt_nonce, 4); mach_write_to_8(my_assume_aligned<8>(aes_ctr_iv + 8), lsn); ut_ad(log_block_get_start_lsn(lsn, log_block_get_hdr_no(buf)) == lsn); byte* key_ver = &buf[OS_FILE_LOG_BLOCK_SIZE - LOG_BLOCK_KEY - LOG_BLOCK_CHECKSUM]; const size_t dst_size = log_sys.has_encryption_key_rotation() ? sizeof dst - LOG_BLOCK_KEY : sizeof dst; if (log_sys.has_encryption_key_rotation()) { const uint key_version = info.key_version; switch (op) { case LOG_ENCRYPT_ROTATE_KEY: info.key_version = encryption_key_get_latest_version( LOG_DEFAULT_ENCRYPTION_KEY); if (key_version != info.key_version && !init_crypt_key(&info)) { info.key_version = key_version; } /* fall through */ case LOG_ENCRYPT: mach_write_to_4(key_ver, info.key_version); break; case LOG_DECRYPT: info.key_version = mach_read_from_4(key_ver); if (key_version != info.key_version && !init_crypt_key(&info)) { return false; } } #ifndef DBUG_OFF if (key_version != info.key_version) { DBUG_PRINT("ib_log", ("key_version: %x -> %x", key_version, info.key_version)); } #endif /* !DBUG_OFF */ } ut_ad(LOG_CRYPT_HDR_SIZE + dst_size == log_sys.trailer_offset()); uint dst_len; int rc = encryption_crypt( buf + LOG_CRYPT_HDR_SIZE, static_cast(dst_size), reinterpret_cast(dst), &dst_len, const_cast(info.crypt_key), MY_AES_BLOCK_SIZE, aes_ctr_iv, sizeof aes_ctr_iv, op == LOG_DECRYPT ? ENCRYPTION_FLAG_DECRYPT | ENCRYPTION_FLAG_NOPAD : ENCRYPTION_FLAG_ENCRYPT | ENCRYPTION_FLAG_NOPAD, LOG_DEFAULT_ENCRYPTION_KEY, info.key_version); ut_a(rc == MY_AES_OK); ut_a(dst_len == dst_size); memcpy(buf + LOG_CRYPT_HDR_SIZE, dst, dst_size); } return true; } /** Initialize the redo log encryption key and random parameters when creating a new redo log. The random parameters will be persisted in the log checkpoint pages. @see log_crypt_write_checkpoint_buf() @see log_crypt_read_checkpoint_buf() @return whether the operation succeeded */ bool log_crypt_init() { info.key_version= encryption_key_get_latest_version(LOG_DEFAULT_ENCRYPTION_KEY); if (info.key_version == ENCRYPTION_KEY_VERSION_INVALID) ib::error() << "log_crypt_init(): cannot get key version"; else if (my_random_bytes(tmp_iv, MY_AES_BLOCK_SIZE) != MY_AES_OK || my_random_bytes(info.crypt_msg, sizeof info.crypt_msg) != MY_AES_OK || my_random_bytes(info.crypt_nonce, sizeof info.crypt_nonce) != MY_AES_OK) ib::error() << "log_crypt_init(): my_random_bytes() failed"; else if (init_crypt_key(&info)) goto func_exit; info.key_version= 0; func_exit: return info.key_version != 0; } /** Read the MariaDB 10.1 checkpoint crypto (version, msg and iv) info. @param[in] buf checkpoint buffer @return whether the operation was successful */ ATTRIBUTE_COLD bool log_crypt_101_read_checkpoint(const byte* buf) { buf += 20 + 32 * 9; const size_t n = *buf++ == 2 ? std::min(unsigned(*buf++), 5U) : 0; for (size_t i = 0; i < n; i++) { struct crypt_info_t& info = infos[infos_used]; unsigned checkpoint_no = mach_read_from_4(buf); for (size_t j = 0; j < infos_used; j++) { if (infos[j].checkpoint_no == checkpoint_no) { /* Do not overwrite an existing slot. */ goto next_slot; } } if (infos_used >= UT_ARR_SIZE(infos)) { ut_ad("too many checkpoint pages" == 0); goto next_slot; } infos_used++; info.checkpoint_no = checkpoint_no; info.key_version = mach_read_from_4(buf + 4); memcpy(info.crypt_msg, buf + 8, MY_AES_BLOCK_SIZE); memcpy(info.crypt_nonce, buf + 24, sizeof info.crypt_nonce); if (!init_crypt_key(&info, true)) { return false; } next_slot: buf += 4 + 4 + 2 * MY_AES_BLOCK_SIZE; } return true; } /** Decrypt a MariaDB 10.1 redo log block. @param[in,out] buf log block @param[in] start_lsn server start LSN @return whether the decryption was successful */ ATTRIBUTE_COLD bool log_crypt_101_read_block(byte* buf, lsn_t start_lsn) { const uint32_t checkpoint_no = uint32_t(log_block_get_checkpoint_no(buf)); const crypt_info_t* info = infos; for (const crypt_info_t* const end = info + infos_used; info < end; info++) { if (info->key_version && info->key_version != ENCRYPTION_KEY_VERSION_INVALID && info->checkpoint_no == checkpoint_no) { goto found; } } if (infos_used == 0) { return false; } /* MariaDB Server 10.1 would use the first key if it fails to find a key for the current checkpoint. */ info = infos; if (info->key_version == ENCRYPTION_KEY_VERSION_INVALID) { return false; } found: byte dst[OS_FILE_LOG_BLOCK_SIZE]; uint dst_len; byte aes_ctr_iv[MY_AES_BLOCK_SIZE]; const uint src_len = OS_FILE_LOG_BLOCK_SIZE - LOG_BLOCK_HDR_SIZE; ulint log_block_no = log_block_get_hdr_no(buf); /* The log block header is not encrypted. */ memcpy(dst, buf, LOG_BLOCK_HDR_SIZE); memcpy(aes_ctr_iv, info->crypt_nonce, 3); mach_write_to_8(aes_ctr_iv + 3, log_block_get_start_lsn(start_lsn, log_block_no)); memcpy(aes_ctr_iv + 11, buf, 4); aes_ctr_iv[11] &= byte(~(LOG_BLOCK_FLUSH_BIT_MASK >> 24)); aes_ctr_iv[15] = 0; int rc = encryption_crypt(buf + LOG_BLOCK_HDR_SIZE, src_len, dst + LOG_BLOCK_HDR_SIZE, &dst_len, const_cast(info->crypt_key), MY_AES_BLOCK_SIZE, aes_ctr_iv, MY_AES_BLOCK_SIZE, ENCRYPTION_FLAG_DECRYPT | ENCRYPTION_FLAG_NOPAD, LOG_DEFAULT_ENCRYPTION_KEY, info->key_version); if (rc != MY_AES_OK || dst_len != src_len) { return false; } memcpy(buf, dst, sizeof dst); return true; } /** Add the encryption information to a redo log checkpoint buffer. @param[in,out] buf checkpoint buffer */ UNIV_INTERN void log_crypt_write_checkpoint_buf(byte* buf) { ut_ad(info.key_version); compile_time_assert(16 == sizeof info.crypt_msg); compile_time_assert(16 == MY_AES_BLOCK_SIZE); compile_time_assert(LOG_CHECKPOINT_CRYPT_MESSAGE - LOG_CHECKPOINT_CRYPT_NONCE == sizeof info.crypt_nonce); memcpy(buf + LOG_CHECKPOINT_CRYPT_MESSAGE, info.crypt_msg, MY_AES_BLOCK_SIZE); memcpy(buf + LOG_CHECKPOINT_CRYPT_NONCE, info.crypt_nonce, sizeof info.crypt_nonce); mach_write_to_4(buf + LOG_CHECKPOINT_CRYPT_KEY, info.key_version); } /** Read the checkpoint crypto (version, msg and iv) info. @param[in] buf checkpoint buffer @return whether the operation was successful */ bool log_crypt_read_checkpoint_buf(const byte* buf) { info.checkpoint_no = mach_read_from_4(buf + (LOG_CHECKPOINT_NO + 4)); info.key_version = mach_read_from_4(buf + LOG_CHECKPOINT_CRYPT_KEY); #if MY_AES_BLOCK_SIZE != 16 # error "MY_AES_BLOCK_SIZE != 16; redo log checkpoint format affected" #endif compile_time_assert(16 == sizeof info.crypt_msg); compile_time_assert(16 == MY_AES_BLOCK_SIZE); compile_time_assert(LOG_CHECKPOINT_CRYPT_MESSAGE - LOG_CHECKPOINT_CRYPT_NONCE == sizeof info.crypt_nonce); memcpy(info.crypt_msg, buf + LOG_CHECKPOINT_CRYPT_MESSAGE, MY_AES_BLOCK_SIZE); memcpy(info.crypt_nonce, buf + LOG_CHECKPOINT_CRYPT_NONCE, sizeof info.crypt_nonce); return init_crypt_key(&info); } /** Encrypt or decrypt a temporary file block. @param[in] src block to encrypt or decrypt @param[in] size size of the block @param[out] dst destination block @param[in] offs offset to block @param[in] encrypt true=encrypt; false=decrypt @return whether the operation succeeded */ UNIV_INTERN bool log_tmp_block_encrypt( const byte* src, ulint size, byte* dst, uint64_t offs, bool encrypt) { uint dst_len; uint64_t iv[MY_AES_BLOCK_SIZE / sizeof(uint64_t)]; iv[0] = offs; memcpy(iv + 1, tmp_iv, sizeof iv - sizeof *iv); int rc = encryption_crypt( src, uint(size), dst, &dst_len, const_cast(info.crypt_key), MY_AES_BLOCK_SIZE, reinterpret_cast(iv), uint(sizeof iv), encrypt ? ENCRYPTION_FLAG_ENCRYPT|ENCRYPTION_FLAG_NOPAD : ENCRYPTION_FLAG_DECRYPT|ENCRYPTION_FLAG_NOPAD, LOG_DEFAULT_ENCRYPTION_KEY, info.key_version); if (rc != MY_AES_OK) { ib::error() << (encrypt ? "Encryption" : "Decryption") << " failed for temporary file: " << rc; } return rc == MY_AES_OK; }