// Copyright 2016 Google LLC. All rights reserved. // // Use of this source code is governed by a BSD-style // license that can be found in the LICENSE file or at // https://developers.google.com/open-source/licenses/bsd #include "packager/media/base/aes_cryptor.h" #include #include #include "glog/logging.h" #include "mbedtls/entropy.h" namespace { // According to ISO/IEC 23001-7:2016 CENC spec, IV should be either // 64-bit (8-byte) or 128-bit (16-byte). bool IsIvSizeValid(size_t iv_size) { return iv_size == 8 || iv_size == 16; } } // namespace namespace shaka { namespace media { AesCryptor::AesCryptor(ConstantIvFlag constant_iv_flag) : constant_iv_flag_(constant_iv_flag), num_crypt_bytes_(0) { mbedtls_cipher_init(&cipher_ctx_); } AesCryptor::~AesCryptor() { mbedtls_cipher_free(&cipher_ctx_); } bool AesCryptor::Crypt(const std::vector& text, std::vector* crypt_text) { // Save text size to make it work for in-place conversion, since the // next statement will update the text size. const size_t text_size = text.size(); // mbedtls requires an extra block's worth of output buffer available. crypt_text->resize(text_size + NumPaddingBytes(text_size) + AES_BLOCK_SIZE); size_t crypt_text_size = crypt_text->size(); if (!Crypt(text.data(), text_size, crypt_text->data(), &crypt_text_size)) { return false; } DCHECK_LE(crypt_text_size, crypt_text->size()); crypt_text->resize(crypt_text_size); return true; } bool AesCryptor::Crypt(const std::string& text, std::string* crypt_text) { // Save text size to make it work for in-place conversion, since the // next statement will update the text size. const size_t text_size = text.size(); // mbedtls requires an extra block's worth of output buffer available. crypt_text->resize(text_size + NumPaddingBytes(text_size) + AES_BLOCK_SIZE); size_t crypt_text_size = crypt_text->size(); if (!Crypt(reinterpret_cast(text.data()), text_size, reinterpret_cast(&(*crypt_text)[0]), &crypt_text_size)) return false; DCHECK_LE(crypt_text_size, crypt_text->size()); crypt_text->resize(crypt_text_size); return true; } bool AesCryptor::SetIv(const std::vector& iv) { if (!IsIvSizeValid(iv.size())) { LOG(ERROR) << "Invalid IV size: " << iv.size(); return false; } iv_ = iv; num_crypt_bytes_ = 0; SetIvInternal(); return true; } void AesCryptor::UpdateIv() { if (constant_iv_flag_ == kUseConstantIv) return; uint64_t increment = 0; // As recommended in ISO/IEC 23001-7:2016 CENC spec, for 64-bit (8-byte) // IV_Sizes, initialization vectors for subsequent samples can be created by // incrementing the initialization vector of the previous sample. // For 128-bit (16-byte) IV_Sizes, initialization vectors for subsequent // samples should be created by adding the block count of the previous sample // to the initialization vector of the previous sample. // There is no official recommendation of how IV for next sample should be // generated for CBC mode. We use the same generation algorithm as CTR here. if (iv_.size() == 8) { increment = 1; } else { DCHECK_EQ(16u, iv_.size()); increment = (num_crypt_bytes_ + AES_BLOCK_SIZE - 1) / AES_BLOCK_SIZE; } for (int64_t i = iv_.size() - 1; increment > 0 && i >= 0; --i) { increment += iv_[i]; iv_[i] = increment & 0xFF; increment >>= 8; } num_crypt_bytes_ = 0; SetIvInternal(); } bool AesCryptor::GenerateRandomIv(FourCC protection_scheme, std::vector* iv) { // ISO/IEC 23001-7:2016 10.1 and 10.3 For 'cenc' and 'cens' // default_Per_Sample_IV_Size and Per_Sample_IV_Size SHOULD be 8-bytes. // There is no official guideline on the iv size for 'cbc1' and 'cbcs', // but 16-byte provides better security. const size_t iv_size = (protection_scheme == FOURCC_cenc || protection_scheme == FOURCC_cens) ? 8 : 16; iv->resize(iv_size); mbedtls_entropy_context entropy_ctx; mbedtls_entropy_init(&entropy_ctx); int rv = mbedtls_entropy_func(&entropy_ctx, iv->data(), iv_size); mbedtls_entropy_free(&entropy_ctx); if (rv != 0) { LOG(ERROR) << "mbedtls_entropy_func failed with: " << rv; return false; } return true; } size_t AesCryptor::NumPaddingBytes(size_t size) const { // No padding by default. UNUSED(size); return 0; } bool AesCryptor::SetupCipher(size_t key_size, CipherMode mode) { mbedtls_cipher_type_t type; // AES defines three key sizes: 128, 192 and 256 bits. // NOTE: Because we use ECB mode in the CTR cryptors, this returns ECB // instead of CTR. Counters and block offsets are managed internally. switch (key_size) { case 16: type = mode == kCtrMode ? MBEDTLS_CIPHER_AES_128_ECB : MBEDTLS_CIPHER_AES_128_CBC; break; case 24: type = mode == kCtrMode ? MBEDTLS_CIPHER_AES_192_ECB : MBEDTLS_CIPHER_AES_192_CBC; break; case 32: type = mode == kCtrMode ? MBEDTLS_CIPHER_AES_256_ECB : MBEDTLS_CIPHER_AES_256_CBC; break; default: LOG(ERROR) << "Invalid AES key size: " << key_size; return false; } const mbedtls_cipher_info_t* cipher_info = mbedtls_cipher_info_from_type(type); CHECK(cipher_info); if (mbedtls_cipher_setup(&cipher_ctx_, cipher_info) != 0) { LOG(ERROR) << "Cipher setup failed"; return false; } // Padding mode only applies to CBC. if (mode == kCbcMode) { // We handle padding ourselves. Don't let mbedtls mess with it. mbedtls_cipher_padding_t cipher_padding = MBEDTLS_PADDING_NONE; if (mbedtls_cipher_set_padding_mode(&cipher_ctx_, cipher_padding) != 0) { LOG(ERROR) << "Failed to set CBC padding mode"; return false; } } return true; } } // namespace media } // namespace shaka