Index: crypto/aes_128_gcm_helpers_nss.cc |
diff --git a/crypto/aes_128_gcm_helpers_nss.cc b/crypto/aes_128_gcm_helpers_nss.cc |
new file mode 100644 |
index 0000000000000000000000000000000000000000..621f28b586f181c9bcc37ea9e4b162639fc6849c |
--- /dev/null |
+++ b/crypto/aes_128_gcm_helpers_nss.cc |
@@ -0,0 +1,374 @@ |
+// Copyright 2015 The Chromium Authors. All rights reserved. |
+// Use of this source code is governed by a BSD-style license that can be |
+// found in the LICENSE file. |
+ |
+#include "crypto/aes_128_gcm_helpers_nss.h" |
+ |
+#include <pkcs11t.h> |
+#include <seccomon.h> |
+ |
+#include "base/lazy_instance.h" |
+#include "base/macros.h" |
+#include "crypto/ghash.h" |
+#include "crypto/scoped_nss_types.h" |
+ |
+#if defined(USE_NSS_CERTS) |
+#include <dlfcn.h> |
+#endif |
+ |
+namespace crypto { |
+namespace { |
+ |
+// Declaration of the prototype both PK11_Decrypt and PK11_Encrypt follow. |
+using PK11_TransformFunction = SECStatus(PK11SymKey* symKey, |
+ CK_MECHANISM_TYPE mechanism, |
+ SECItem* param, |
+ unsigned char* out, |
+ unsigned int* outLen, |
+ unsigned int maxLen, |
+ const unsigned char* data, |
+ unsigned int dataLen); |
+ |
+// On Linux, dynamically link against the system version of libnss3.so. In |
+// order to continue working on systems without up-to-date versions of NSS, |
+// lookup PK11_Decrypt and PK11_Encrypt with dlsym. |
+// |
+// GcmSupportChecker is a singleton which caches the results of runtime symbol |
+// resolution of these symbols. |
+class GcmSupportChecker { |
+ public: |
+ PK11_TransformFunction* pk11_decrypt_func() { return pk11_decrypt_func_; } |
+ |
+ PK11_TransformFunction* pk11_encrypt_func() { return pk11_encrypt_func_; } |
+ |
+ private: |
+ friend struct base::DefaultLazyInstanceTraits<GcmSupportChecker>; |
+ |
+ GcmSupportChecker() { |
+#if !defined(USE_NSS_CERTS) |
+ // Using a bundled version of NSS that is guaranteed to have these symbols. |
+ pk11_decrypt_func_ = PK11_Decrypt; |
+ pk11_encrypt_func_ = PK11_Encrypt; |
+#else |
+ // Using system NSS libraries and PCKS #11 modules, which may not have the |
+ // necessary functions (PK11_Decrypt and PK11_Encrypt) or mechanism support |
+ // (CKM_AES_GCM). |
+ |
+ // If PK11_Decrypt() and PK11_Encrypt() were successfully resolved, then NSS |
+ // will support AES-GCM directly. This was introduced in NSS 3.15. |
+ pk11_decrypt_func_ = reinterpret_cast<PK11_TransformFunction*>( |
+ dlsym(RTLD_DEFAULT, "PK11_Decrypt")); |
+ pk11_encrypt_func_ = reinterpret_cast<PK11_TransformFunction*>( |
+ dlsym(RTLD_DEFAULT, "PK11_Encrypt")); |
+#endif |
+ } |
+ |
+ ~GcmSupportChecker() {} |
+ |
+ // |pk11_decrypt_func_| stores the runtime symbol resolution of PK11_Decrypt. |
+ PK11_TransformFunction* pk11_decrypt_func_; |
+ |
+ // |pk11_encrypt_func_| stores the runtime symbol resolution of PK11_Encrypt. |
+ PK11_TransformFunction* pk11_encrypt_func_; |
+ |
+ DISALLOW_COPY_AND_ASSIGN(GcmSupportChecker); |
+}; |
+ |
+base::LazyInstance<GcmSupportChecker>::Leaky g_gcm_support_checker = |
+ LAZY_INSTANCE_INITIALIZER; |
+ |
+} // namespace |
+ |
+// Calls PK11_Decrypt if it's available. Otherwise, emulates CKM_AES_GCM using |
+// CKM_AES_CTR and the GaloisHash class. |
+SECStatus PK11DecryptHelper(PK11SymKey* key, |
+ CK_MECHANISM_TYPE mechanism, |
+ SECItem* param, |
+ unsigned char* out, |
+ unsigned int* out_len, |
+ unsigned int max_len, |
+ const unsigned char* data, |
+ unsigned int data_len) { |
+ // If PK11_Decrypt() was successfully resolved or if bundled version of NSS is |
+ // being used, then NSS will support AES-GCM directly. |
+ PK11_TransformFunction* pk11_decrypt_func = |
+ g_gcm_support_checker.Get().pk11_decrypt_func(); |
+ |
+ if (pk11_decrypt_func != nullptr) { |
+ return pk11_decrypt_func(key, mechanism, param, out, out_len, max_len, data, |
+ data_len); |
+ } |
+ |
+ // Otherwise, the user has an older version of NSS. Regrettably, NSS 3.14.x |
+ // has a bug in the AES GCM code |
+ // (https://bugzilla.mozilla.org/show_bug.cgi?id=853285), as well as missing |
+ // the PK11_Decrypt function |
+ // (https://bugzilla.mozilla.org/show_bug.cgi?id=854063), both of which are |
+ // resolved in NSS 3.15. |
+ |
+ CHECK_EQ(mechanism, static_cast<CK_MECHANISM_TYPE>(CKM_AES_GCM)); |
+ CHECK_EQ(param->len, sizeof(CK_GCM_PARAMS)); |
+ |
+ const CK_GCM_PARAMS* gcm_params = |
+ reinterpret_cast<CK_GCM_PARAMS*>(param->data); |
+ |
+ const CK_ULONG auth_tag_size = gcm_params->ulTagBits / 8; |
+ |
+ if (gcm_params->ulIvLen != 12u) { |
+ DVLOG(1) << "ulIvLen is not equal to 12"; |
+ PORT_SetError(SEC_ERROR_INPUT_LEN); |
+ return SECFailure; |
+ } |
+ |
+ SECItem my_param = {siBuffer, nullptr, 0}; |
+ |
+ // Step 2. Let H = CIPH_K(128 '0' bits). |
+ unsigned char ghash_key[16] = {0}; |
+ crypto::ScopedPK11Context ctx( |
+ PK11_CreateContextBySymKey(CKM_AES_ECB, CKA_ENCRYPT, key, &my_param)); |
+ if (!ctx) { |
+ DVLOG(1) << "PK11_CreateContextBySymKey failed"; |
+ return SECFailure; |
+ } |
+ int output_len; |
+ if (PK11_CipherOp(ctx.get(), ghash_key, &output_len, sizeof(ghash_key), |
+ ghash_key, sizeof(ghash_key)) != SECSuccess) { |
+ DVLOG(1) << "PK11_CipherOp failed"; |
+ return SECFailure; |
+ } |
+ |
+ if (PK11_Finalize(ctx.get()) != SECSuccess) { |
+ DVLOG(1) << "PK11_Finalize failed"; |
+ return SECFailure; |
+ } |
+ |
+ if (output_len != sizeof(ghash_key)) { |
+ DVLOG(1) << "Wrong output length"; |
+ PORT_SetError(SEC_ERROR_LIBRARY_FAILURE); |
+ return SECFailure; |
+ } |
+ |
+ // Step 3. If len(IV)=96, then let J0 = IV || 31 '0' bits || 1. |
+ CK_AES_CTR_PARAMS ctr_params = {0}; |
+ ctr_params.ulCounterBits = 32; |
+ memcpy(ctr_params.cb, gcm_params->pIv, gcm_params->ulIvLen); |
+ ctr_params.cb[12] = 0; |
+ ctr_params.cb[13] = 0; |
+ ctr_params.cb[14] = 0; |
+ ctr_params.cb[15] = 1; |
+ |
+ my_param.type = siBuffer; |
+ my_param.data = reinterpret_cast<unsigned char*>(&ctr_params); |
+ my_param.len = sizeof(ctr_params); |
+ |
+ ctx.reset( |
+ PK11_CreateContextBySymKey(CKM_AES_CTR, CKA_ENCRYPT, key, &my_param)); |
+ if (!ctx) { |
+ DVLOG(1) << "PK11_CreateContextBySymKey failed"; |
+ return SECFailure; |
+ } |
+ |
+ // Step 6. Calculate the encryption mask of GCTR_K(J0, ...). |
+ unsigned char tag_mask[16] = {0}; |
+ if (PK11_CipherOp(ctx.get(), tag_mask, &output_len, sizeof(tag_mask), |
+ tag_mask, sizeof(tag_mask)) != SECSuccess) { |
+ DVLOG(1) << "PK11_CipherOp failed"; |
+ return SECFailure; |
+ } |
+ if (output_len != sizeof(tag_mask)) { |
+ DVLOG(1) << "Wrong output length"; |
+ PORT_SetError(SEC_ERROR_LIBRARY_FAILURE); |
+ return SECFailure; |
+ } |
+ |
+ if (data_len < auth_tag_size) { |
+ PORT_SetError(SEC_ERROR_INPUT_LEN); |
+ return SECFailure; |
+ } |
+ |
+ // The const_cast for |data| can be removed if system NSS libraries are |
+ // NSS 3.14.1 or later (NSS bug |
+ // https://bugzilla.mozilla.org/show_bug.cgi?id=808218). |
+ if (PK11_CipherOp(ctx.get(), out, &output_len, max_len, |
+ const_cast<unsigned char*>(data), |
+ data_len - auth_tag_size) != SECSuccess) { |
+ DVLOG(1) << "PK11_CipherOp failed"; |
+ return SECFailure; |
+ } |
+ |
+ if (PK11_Finalize(ctx.get()) != SECSuccess) { |
+ DVLOG(1) << "PK11_Finalize failed"; |
+ return SECFailure; |
+ } |
+ |
+ if (static_cast<unsigned int>(output_len) != data_len - auth_tag_size) { |
+ DVLOG(1) << "Wrong output length"; |
+ PORT_SetError(SEC_ERROR_LIBRARY_FAILURE); |
+ return SECFailure; |
+ } |
+ |
+ crypto::GaloisHash ghash(ghash_key); |
+ ghash.UpdateAdditional(gcm_params->pAAD, gcm_params->ulAADLen); |
+ ghash.UpdateCiphertext(data, output_len); |
+ unsigned char auth_tag[auth_tag_size]; |
+ ghash.Finish(auth_tag, auth_tag_size); |
+ for (unsigned int i = 0; i < auth_tag_size; i++) { |
+ auth_tag[i] ^= tag_mask[i]; |
+ } |
+ |
+ if (NSS_SecureMemcmp(auth_tag, data + output_len, auth_tag_size) != 0) { |
+ PORT_SetError(SEC_ERROR_BAD_DATA); |
+ return SECFailure; |
+ } |
+ |
+ *out_len = output_len; |
+ return SECSuccess; |
+} |
+ |
+// Calls PK11_Encrypt if it's available. Otherwise, emulates CKM_AES_GCM using |
+// CKM_AES_CTR and the GaloisHash class. |
+SECStatus PK11EncryptHelper(PK11SymKey* key, |
+ CK_MECHANISM_TYPE mechanism, |
+ SECItem* param, |
+ unsigned char* out, |
+ unsigned int* out_len, |
+ unsigned int max_len, |
+ const unsigned char* data, |
+ unsigned int data_len) { |
+ // If PK11_Encrypt() was successfully resolved or if bundled version of NSS is |
+ // being used, then NSS will support AES-GCM directly. |
+ PK11_TransformFunction* pk11_encrypt_func = |
+ g_gcm_support_checker.Get().pk11_encrypt_func(); |
+ |
+ if (pk11_encrypt_func != nullptr) { |
+ return pk11_encrypt_func(key, mechanism, param, out, out_len, max_len, data, |
+ data_len); |
+ } |
+ |
+ // Otherwise, the user has an older version of NSS. Regrettably, NSS 3.14.x |
+ // has a bug in the AES GCM code |
+ // (https://bugzilla.mozilla.org/show_bug.cgi?id=853285), as well as missing |
+ // the PK11_Encrypt function |
+ // (https://bugzilla.mozilla.org/show_bug.cgi?id=854063), both of which are |
+ // resolved in NSS 3.15. |
+ |
+ CHECK_EQ(mechanism, static_cast<CK_MECHANISM_TYPE>(CKM_AES_GCM)); |
+ CHECK_EQ(param->len, sizeof(CK_GCM_PARAMS)); |
+ |
+ const CK_GCM_PARAMS* gcm_params = |
+ reinterpret_cast<CK_GCM_PARAMS*>(param->data); |
+ |
+ const CK_ULONG auth_tag_size = gcm_params->ulTagBits / 8; |
+ |
+ if (max_len < auth_tag_size) { |
+ DVLOG(1) << "max_len is less than kAuthTagSize"; |
+ PORT_SetError(SEC_ERROR_OUTPUT_LEN); |
+ return SECFailure; |
+ } |
+ |
+ if (gcm_params->ulIvLen != 12u) { |
+ DVLOG(1) << "ulIvLen is not equal to 12"; |
+ PORT_SetError(SEC_ERROR_INPUT_LEN); |
+ return SECFailure; |
+ } |
+ |
+ SECItem my_param = {siBuffer, nullptr, 0}; |
+ |
+ // Step 1. Let H = CIPH_K(128 '0' bits). |
+ unsigned char ghash_key[16] = {0}; |
+ crypto::ScopedPK11Context ctx( |
+ PK11_CreateContextBySymKey(CKM_AES_ECB, CKA_ENCRYPT, key, &my_param)); |
+ if (!ctx) { |
+ DVLOG(1) << "PK11_CreateContextBySymKey failed"; |
+ return SECFailure; |
+ } |
+ int output_len; |
+ if (PK11_CipherOp(ctx.get(), ghash_key, &output_len, sizeof(ghash_key), |
+ ghash_key, sizeof(ghash_key)) != SECSuccess) { |
+ DVLOG(1) << "PK11_CipherOp failed"; |
+ return SECFailure; |
+ } |
+ |
+ if (PK11_Finalize(ctx.get()) != SECSuccess) { |
+ DVLOG(1) << "PK11_Finalize failed"; |
+ return SECFailure; |
+ } |
+ |
+ if (output_len != sizeof(ghash_key)) { |
+ DVLOG(1) << "Wrong output length"; |
+ PORT_SetError(SEC_ERROR_LIBRARY_FAILURE); |
+ return SECFailure; |
+ } |
+ |
+ // Step 2. If len(IV)=96, then let J0 = IV || 31 '0' bits || 1. |
+ CK_AES_CTR_PARAMS ctr_params = {0}; |
+ ctr_params.ulCounterBits = 32; |
+ memcpy(ctr_params.cb, gcm_params->pIv, gcm_params->ulIvLen); |
+ ctr_params.cb[12] = 0; |
+ ctr_params.cb[13] = 0; |
+ ctr_params.cb[14] = 0; |
+ ctr_params.cb[15] = 1; |
+ |
+ my_param.type = siBuffer; |
+ my_param.data = reinterpret_cast<unsigned char*>(&ctr_params); |
+ my_param.len = sizeof(ctr_params); |
+ |
+ ctx.reset( |
+ PK11_CreateContextBySymKey(CKM_AES_CTR, CKA_ENCRYPT, key, &my_param)); |
+ if (!ctx) { |
+ DVLOG(1) << "PK11_CreateContextBySymKey failed"; |
+ return SECFailure; |
+ } |
+ |
+ // Step 6. Calculate the encryption mask of GCTR_K(J0, ...). |
+ unsigned char tag_mask[16] = {0}; |
+ if (PK11_CipherOp(ctx.get(), tag_mask, &output_len, sizeof(tag_mask), |
+ tag_mask, sizeof(tag_mask)) != SECSuccess) { |
+ DVLOG(1) << "PK11_CipherOp failed"; |
+ return SECFailure; |
+ } |
+ if (output_len != sizeof(tag_mask)) { |
+ DVLOG(1) << "Wrong output length"; |
+ PORT_SetError(SEC_ERROR_LIBRARY_FAILURE); |
+ return SECFailure; |
+ } |
+ |
+ // The const_cast for |data| can be removed if system NSS libraries are |
+ // NSS 3.14.1 or later (NSS bug |
+ // https://bugzilla.mozilla.org/show_bug.cgi?id=808218). |
+ if (PK11_CipherOp(ctx.get(), out, &output_len, max_len, |
+ const_cast<unsigned char*>(data), data_len) != SECSuccess) { |
+ DVLOG(1) << "PK11_CipherOp failed"; |
+ return SECFailure; |
+ } |
+ |
+ if (PK11_Finalize(ctx.get()) != SECSuccess) { |
+ DVLOG(1) << "PK11_Finalize failed"; |
+ return SECFailure; |
+ } |
+ |
+ if (static_cast<unsigned int>(output_len) != data_len) { |
+ DVLOG(1) << "Wrong output length"; |
+ PORT_SetError(SEC_ERROR_LIBRARY_FAILURE); |
+ return SECFailure; |
+ } |
+ |
+ if ((max_len - auth_tag_size) < static_cast<unsigned int>(output_len)) { |
+ DVLOG(1) << "(max_len - kAuthTagSize) is less than output_len"; |
+ PORT_SetError(SEC_ERROR_OUTPUT_LEN); |
+ return SECFailure; |
+ } |
+ |
+ crypto::GaloisHash ghash(ghash_key); |
+ ghash.UpdateAdditional(gcm_params->pAAD, gcm_params->ulAADLen); |
+ ghash.UpdateCiphertext(out, output_len); |
+ ghash.Finish(out + output_len, auth_tag_size); |
+ for (unsigned int i = 0; i < auth_tag_size; i++) { |
+ out[output_len + i] ^= tag_mask[i]; |
+ } |
+ |
+ *out_len = output_len + auth_tag_size; |
+ return SECSuccess; |
+} |
+ |
+} // namespace crypto |