Head

GCC Code Coverage Report

Directory:	./		Exec	Total	Coverage
File:	crypto/crypto_keygen.h	Lines:	67	93	72.0 %
Date:	2022-06-06 04:15:48	Branches:	25	43	58.1 %


#ifndef SRC_CRYPTO_CRYPTO_KEYGEN_H_
#define SRC_CRYPTO_CRYPTO_KEYGEN_H_

#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS

#include "async_wrap.h"
#include "base_object.h"
#include "crypto/crypto_keys.h"
#include "crypto/crypto_util.h"
#include "env.h"
#include "memory_tracker.h"
#include "v8.h"

namespace node {
namespace crypto {
namespace Keygen {
void Initialize(Environment* env, v8::Local<v8::Object> target);
void RegisterExternalReferences(ExternalReferenceRegistry* registry);
}  // namespace Keygen

enum class KeyGenJobStatus {
  OK,
  FAILED
};

// A Base CryptoJob for generating secret keys or key pairs.
// The KeyGenTraits is largely responsible for the details of
// the implementation, while KeyGenJob handles the common
// mechanisms.
template <typename KeyGenTraits>
class KeyGenJob final : public CryptoJob<KeyGenTraits> {
 public:
  using AdditionalParams = typename KeyGenTraits::AdditionalParameters;

  static void New(const v8::FunctionCallbackInfo<v8::Value>& args) {
    Environment* env = Environment::GetCurrent(args);
    CHECK(args.IsConstructCall());

    CryptoJobMode mode = GetCryptoJobMode(args[0]);

    unsigned int offset = 1;

    AdditionalParams params;
    if (KeyGenTraits::AdditionalConfig(mode, args, &offset, &params)
            .IsNothing()) {
      // The KeyGenTraits::AdditionalConfig is responsible for
      // calling an appropriate THROW_CRYPTO_* variant reporting
      // whatever error caused initialization to fail.
      return;
    }

    new KeyGenJob<KeyGenTraits>(env, args.This(), mode, std::move(params));
  }

  static void Initialize(
      Environment* env,
      v8::Local<v8::Object> target) {
    CryptoJob<KeyGenTraits>::Initialize(New, env, target);
  }

  static void RegisterExternalReferences(ExternalReferenceRegistry* registry) {
    CryptoJob<KeyGenTraits>::RegisterExternalReferences(New, registry);
  }

  KeyGenJob(
      Environment* env,
      v8::Local<v8::Object> object,
      CryptoJobMode mode,
      AdditionalParams&& params)
      : CryptoJob<KeyGenTraits>(
            env,
            object,
            KeyGenTraits::Provider,
            mode,
            std::move(params)) {}

  void DoThreadPoolWork() override {
    // Make sure the CSPRNG is properly seeded so the results are secure.
    CheckEntropy();

    AdditionalParams* params = CryptoJob<KeyGenTraits>::params();

    switch (KeyGenTraits::DoKeyGen(AsyncWrap::env(), params)) {
      case KeyGenJobStatus::OK:
        status_ = KeyGenJobStatus::OK;
        // Success!
        break;
      case KeyGenJobStatus::FAILED: {
        CryptoErrorStore* errors = CryptoJob<KeyGenTraits>::errors();
        errors->Capture();
        if (errors->Empty())
          errors->Insert(NodeCryptoError::KEY_GENERATION_JOB_FAILED);
      }
    }
  }

  v8::Maybe<bool> ToResult(
      v8::Local<v8::Value>* err,
      v8::Local<v8::Value>* result) override {
    Environment* env = AsyncWrap::env();
    CryptoErrorStore* errors = CryptoJob<KeyGenTraits>::errors();
    AdditionalParams* params = CryptoJob<KeyGenTraits>::params();

    if (status_ == KeyGenJobStatus::OK) {
      v8::Maybe<bool> ret = KeyGenTraits::EncodeKey(env, params, result);
      if (ret.IsJust() && ret.FromJust()) {
        *err = Undefined(env->isolate());
      }
      return ret;
    }

    if (errors->Empty())
      errors->Capture();
    CHECK(!errors->Empty());
    *result = Undefined(env->isolate());
    return v8::Just(errors->ToException(env).ToLocal(err));
  }

  SET_SELF_SIZE(KeyGenJob)

 private:
  KeyGenJobStatus status_ = KeyGenJobStatus::FAILED;
};

// A Base KeyGenTraits for Key Pair generation algorithms.
template <typename KeyPairAlgorithmTraits>
struct KeyPairGenTraits final {
  using AdditionalParameters =
      typename KeyPairAlgorithmTraits::AdditionalParameters;

  static const AsyncWrap::ProviderType Provider =
      AsyncWrap::PROVIDER_KEYPAIRGENREQUEST;
  static constexpr const char* JobName = KeyPairAlgorithmTraits::JobName;

  static v8::Maybe<bool> AdditionalConfig(
      CryptoJobMode mode,
      const v8::FunctionCallbackInfo<v8::Value>& args,
      unsigned int* offset,
      AdditionalParameters* params) {
    // Notice that offset is a pointer. Each of the AdditionalConfig,
    // GetPublicKeyEncodingFromJs, and GetPrivateKeyEncodingFromJs
    // functions will update the value of the offset as they successfully
    // process input parameters. This allows each job to have a variable
    // number of input parameters specific to each job type.
    if (KeyPairAlgorithmTraits::AdditionalConfig(mode, args, offset, params)
            .IsNothing()) {
      return v8::Just(false);
    }

    params->public_key_encoding = ManagedEVPPKey::GetPublicKeyEncodingFromJs(
        args,
        offset,
        kKeyContextGenerate);

    auto private_key_encoding =
        ManagedEVPPKey::GetPrivateKeyEncodingFromJs(
            args,
            offset,
            kKeyContextGenerate);

    if (!private_key_encoding.IsEmpty())
      params->private_key_encoding = private_key_encoding.Release();

    return v8::Just(true);
  }

  static KeyGenJobStatus DoKeyGen(
      Environment* env,
      AdditionalParameters* params) {
    EVPKeyCtxPointer ctx = KeyPairAlgorithmTraits::Setup(params);

    if (!ctx)
      return KeyGenJobStatus::FAILED;

    // Generate the key
    EVP_PKEY* pkey = nullptr;
    if (!EVP_PKEY_keygen(ctx.get(), &pkey))
      return KeyGenJobStatus::FAILED;

    params->key = ManagedEVPPKey(EVPKeyPointer(pkey));
    return KeyGenJobStatus::OK;
  }

  static v8::Maybe<bool> EncodeKey(
      Environment* env,
      AdditionalParameters* params,
      v8::Local<v8::Value>* result) {
    v8::Local<v8::Value> keys[2];
    if (ManagedEVPPKey::ToEncodedPublicKey(
            env,
            std::move(params->key),
            params->public_key_encoding,
            &keys[0]).IsNothing() ||
        ManagedEVPPKey::ToEncodedPrivateKey(
            env,
            std::move(params->key),
            params->private_key_encoding,
            &keys[1]).IsNothing()) {
      return v8::Nothing<bool>();
    }
    *result = v8::Array::New(env->isolate(), keys, arraysize(keys));
    return v8::Just(true);
  }
};

struct SecretKeyGenConfig final : public MemoryRetainer {
  size_t length;  // Expressed a a number of bits
  char* out = nullptr;  // Placeholder for the generated key bytes

  void MemoryInfo(MemoryTracker* tracker) const override;
  SET_MEMORY_INFO_NAME(SecretKeyGenConfig)
  SET_SELF_SIZE(SecretKeyGenConfig)
};

struct SecretKeyGenTraits final {
  using AdditionalParameters = SecretKeyGenConfig;
  static const AsyncWrap::ProviderType Provider =
      AsyncWrap::PROVIDER_KEYGENREQUEST;
  static constexpr const char* JobName = "SecretKeyGenJob";

  static v8::Maybe<bool> AdditionalConfig(
      CryptoJobMode mode,
      const v8::FunctionCallbackInfo<v8::Value>& args,
      unsigned int* offset,
      SecretKeyGenConfig* params);

  static KeyGenJobStatus DoKeyGen(
      Environment* env,
      SecretKeyGenConfig* params);

  static v8::Maybe<bool> EncodeKey(
      Environment* env,
      SecretKeyGenConfig* params,
      v8::Local<v8::Value>* result);
};

template <typename AlgorithmParams>
struct KeyPairGenConfig final : public MemoryRetainer {
  PublicKeyEncodingConfig public_key_encoding;
  PrivateKeyEncodingConfig private_key_encoding;
  ManagedEVPPKey key;
  AlgorithmParams params;

  KeyPairGenConfig() = default;
  ~KeyPairGenConfig() {
    Mutex::ScopedLock priv_lock(*key.mutex());
  }

  explicit KeyPairGenConfig(KeyPairGenConfig&& other) noexcept
      : public_key_encoding(other.public_key_encoding),
        private_key_encoding(
            std::forward<PrivateKeyEncodingConfig>(
                other.private_key_encoding)),
        key(std::move(other.key)),
        params(std::move(other.params)) {}

  KeyPairGenConfig& operator=(KeyPairGenConfig&& other) noexcept {
    if (&other == this) return *this;
    this->~KeyPairGenConfig();
    return *new (this) KeyPairGenConfig(std::move(other));
  }

  void MemoryInfo(MemoryTracker* tracker) const override {
    tracker->TrackField("key", key);
    if (!private_key_encoding.passphrase_.IsEmpty()) {
      tracker->TrackFieldWithSize("private_key_encoding.passphrase",
                                  private_key_encoding.passphrase_->size());
    }
    tracker->TrackField("params", params);
  }

  SET_MEMORY_INFO_NAME(KeyPairGenConfig)
  SET_SELF_SIZE(KeyPairGenConfig)
};

struct NidKeyPairParams final : public MemoryRetainer {
  int id;
  SET_NO_MEMORY_INFO()
  SET_MEMORY_INFO_NAME(NidKeyPairParams)
  SET_SELF_SIZE(NidKeyPairParams)
};

using NidKeyPairGenConfig = KeyPairGenConfig<NidKeyPairParams>;

struct NidKeyPairGenTraits final {
  using AdditionalParameters = NidKeyPairGenConfig;
  static constexpr const char* JobName = "NidKeyPairGenJob";

  static EVPKeyCtxPointer Setup(NidKeyPairGenConfig* params);

  static v8::Maybe<bool> AdditionalConfig(
      CryptoJobMode mode,
      const v8::FunctionCallbackInfo<v8::Value>& args,
      unsigned int* offset,
      NidKeyPairGenConfig* params);
};

using NidKeyPairGenJob = KeyGenJob<KeyPairGenTraits<NidKeyPairGenTraits>>;
using SecretKeyGenJob = KeyGenJob<SecretKeyGenTraits>;
}  // namespace crypto
}  // namespace node

#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
#endif  // SRC_CRYPTO_CRYPTO_KEYGEN_H_



Generated by: GCOVR (Version 4.2)

Line	Branch	Exec	Source
1			#ifndef SRC_CRYPTO_CRYPTO_KEYGEN_H_
2			#define SRC_CRYPTO_CRYPTO_KEYGEN_H_
3
4			#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
5
6			#include "async_wrap.h"
7			#include "base_object.h"
8			#include "crypto/crypto_keys.h"
9			#include "crypto/crypto_util.h"
10			#include "env.h"
11			#include "memory_tracker.h"
12			#include "v8.h"
13
14			namespace node {
15			namespace crypto {
16			namespace Keygen {
17			void Initialize(Environment* env, v8::Local<v8::Object> target);
18			void RegisterExternalReferences(ExternalReferenceRegistry* registry);
19			} // namespace Keygen
20
21			enum class KeyGenJobStatus {
22			OK,
23			FAILED
24			};
25
26			// A Base CryptoJob for generating secret keys or key pairs.
27			// The KeyGenTraits is largely responsible for the details of
28			// the implementation, while KeyGenJob handles the common
29			// mechanisms.
30			template <typename KeyGenTraits>
31			class KeyGenJob final : public CryptoJob<KeyGenTraits> {
32			public:
33			using AdditionalParams = typename KeyGenTraits::AdditionalParameters;
34
35		761	static void New(const v8::FunctionCallbackInfo<v8::Value>& args) {
36		761	Environment* env = Environment::GetCurrent(args);
37	✗✓	761	CHECK(args.IsConstructCall());
38
39		761	CryptoJobMode mode = GetCryptoJobMode(args[0]);
40
41		761	unsigned int offset = 1;
42
43		761	AdditionalParams params;
44	✗✓	1522	if (KeyGenTraits::AdditionalConfig(mode, args, &offset, &params)
45			.IsNothing()) {
46			// The KeyGenTraits::AdditionalConfig is responsible for
47			// calling an appropriate THROW_CRYPTO_* variant reporting
48			// whatever error caused initialization to fail.
49			return;
50			}
51
52		761	new KeyGenJob<KeyGenTraits>(env, args.This(), mode, std::move(params));
53			}
54
55		6832	static void Initialize(
56			Environment* env,
57			v8::Local<v8::Object> target) {
58		6832	CryptoJob<KeyGenTraits>::Initialize(New, env, target);
59		6832	}
60
61		41648	static void RegisterExternalReferences(ExternalReferenceRegistry* registry) {
62		41648	CryptoJob<KeyGenTraits>::RegisterExternalReferences(New, registry);
63		41648	}
64
65		761	KeyGenJob(
66			Environment* env,
67			v8::Local<v8::Object> object,
68			CryptoJobMode mode,
69			AdditionalParams&& params)
70			: CryptoJob<KeyGenTraits>(
71			env,
72			object,
73			KeyGenTraits::Provider,
74			mode,
75		761	std::move(params)) {}
76
77		758	void DoThreadPoolWork() override {
78			// Make sure the CSPRNG is properly seeded so the results are secure.
79		758	CheckEntropy();
80
81		758	AdditionalParams* params = CryptoJob<KeyGenTraits>::params();
82
83	✓✗✗	758	switch (KeyGenTraits::DoKeyGen(AsyncWrap::env(), params)) {
84		758	case KeyGenJobStatus::OK:
85		758	status_ = KeyGenJobStatus::OK;
86			// Success!
87		758	break;
88			case KeyGenJobStatus::FAILED: {
89			CryptoErrorStore* errors = CryptoJob<KeyGenTraits>::errors();
90			errors->Capture();
91			if (errors->Empty())
92			errors->Insert(NodeCryptoError::KEY_GENERATION_JOB_FAILED);
93			}
94			}
95		758	}
96
97		757	v8::Maybe<bool> ToResult(
98			v8::Local<v8::Value>* err,
99			v8::Local<v8::Value>* result) override {
100		757	Environment* env = AsyncWrap::env();
101		757	CryptoErrorStore* errors = CryptoJob<KeyGenTraits>::errors();
102		757	AdditionalParams* params = CryptoJob<KeyGenTraits>::params();
103
104	✓✗	757	if (status_ == KeyGenJobStatus::OK) {
105		757	v8::Maybe<bool> ret = KeyGenTraits::EncodeKey(env, params, result);
106	✓✓✓✗ ✓✓	1509	if (ret.IsJust() && ret.FromJust()) {
107		1504	*err = Undefined(env->isolate());
108			}
109		757	return ret;
110			}
111
112			if (errors->Empty())
113			errors->Capture();
114			CHECK(!errors->Empty());
115			*result = Undefined(env->isolate());
116			return v8::Just(errors->ToException(env).ToLocal(err));
117			}
118
119			SET_SELF_SIZE(KeyGenJob)
120
121			private:
122			KeyGenJobStatus status_ = KeyGenJobStatus::FAILED;
123			};
124
125			// A Base KeyGenTraits for Key Pair generation algorithms.
126			template <typename KeyPairAlgorithmTraits>
127			struct KeyPairGenTraits final {
128			using AdditionalParameters =
129			typename KeyPairAlgorithmTraits::AdditionalParameters;
130
131			static const AsyncWrap::ProviderType Provider =
132			AsyncWrap::PROVIDER_KEYPAIRGENREQUEST;
133			static constexpr const char* JobName = KeyPairAlgorithmTraits::JobName;
134
135		337	static v8::Maybe<bool> AdditionalConfig(
136			CryptoJobMode mode,
137			const v8::FunctionCallbackInfo<v8::Value>& args,
138			unsigned int* offset,
139			AdditionalParameters* params) {
140			// Notice that offset is a pointer. Each of the AdditionalConfig,
141			// GetPublicKeyEncodingFromJs, and GetPrivateKeyEncodingFromJs
142			// functions will update the value of the offset as they successfully
143			// process input parameters. This allows each job to have a variable
144			// number of input parameters specific to each job type.
145	✓✓	674	if (KeyPairAlgorithmTraits::AdditionalConfig(mode, args, offset, params)
146			.IsNothing()) {
147		2	return v8::Just(false);
148			}
149
150		335	params->public_key_encoding = ManagedEVPPKey::GetPublicKeyEncodingFromJs(
151			args,
152			offset,
153			kKeyContextGenerate);
154
155		335	auto private_key_encoding =
156			ManagedEVPPKey::GetPrivateKeyEncodingFromJs(
157			args,
158			offset,
159			kKeyContextGenerate);
160
161	✓✓	335	if (!private_key_encoding.IsEmpty())
162		334	params->private_key_encoding = private_key_encoding.Release();
163
164		335	return v8::Just(true);
165			}
166
167		334	static KeyGenJobStatus DoKeyGen(
168			Environment* env,
169			AdditionalParameters* params) {
170		668	EVPKeyCtxPointer ctx = KeyPairAlgorithmTraits::Setup(params);
171
172	✗✓	334	if (!ctx)
173			return KeyGenJobStatus::FAILED;
174
175			// Generate the key
176		334	EVP_PKEY* pkey = nullptr;
177	✗✓	334	if (!EVP_PKEY_keygen(ctx.get(), &pkey))
178			return KeyGenJobStatus::FAILED;
179
180		334	params->key = ManagedEVPPKey(EVPKeyPointer(pkey));
181		334	return KeyGenJobStatus::OK;
182			}
183
184		333	static v8::Maybe<bool> EncodeKey(
185			Environment* env,
186			AdditionalParameters* params,
187			v8::Local<v8::Value>* result) {
188	✓✓	999	v8::Local<v8::Value> keys[2];
189	✓✓	666	if (ManagedEVPPKey::ToEncodedPublicKey(
190			env,
191		333	std::move(params->key),
192		333	params->public_key_encoding,
193	✓✓✗✓	994	&keys[0]).IsNothing() \|\|
194	✓✓✓✗	661	ManagedEVPPKey::ToEncodedPrivateKey(
195			env,
196		328	std::move(params->key),
197		328	params->private_key_encoding,
198			&keys[1]).IsNothing()) {
199		5	return v8::Nothing<bool>();
200			}
201		328	*result = v8::Array::New(env->isolate(), keys, arraysize(keys));
202		328	return v8::Just(true);
203			}
204			};
205
206			struct SecretKeyGenConfig final : public MemoryRetainer {
207			size_t length; // Expressed a a number of bits
208			char* out = nullptr; // Placeholder for the generated key bytes
209
210			void MemoryInfo(MemoryTracker* tracker) const override;
211			SET_MEMORY_INFO_NAME(SecretKeyGenConfig)
212			SET_SELF_SIZE(SecretKeyGenConfig)
213			};
214
215			struct SecretKeyGenTraits final {
216			using AdditionalParameters = SecretKeyGenConfig;
217			static const AsyncWrap::ProviderType Provider =
218			AsyncWrap::PROVIDER_KEYGENREQUEST;
219			static constexpr const char* JobName = "SecretKeyGenJob";
220
221			static v8::Maybe<bool> AdditionalConfig(
222			CryptoJobMode mode,
223			const v8::FunctionCallbackInfo<v8::Value>& args,
224			unsigned int* offset,
225			SecretKeyGenConfig* params);
226
227			static KeyGenJobStatus DoKeyGen(
228			Environment* env,
229			SecretKeyGenConfig* params);
230
231			static v8::Maybe<bool> EncodeKey(
232			Environment* env,
233			SecretKeyGenConfig* params,
234			v8::Local<v8::Value>* result);
235			};
236
237			template <typename AlgorithmParams>
238			struct KeyPairGenConfig final : public MemoryRetainer {
239			PublicKeyEncodingConfig public_key_encoding;
240			PrivateKeyEncodingConfig private_key_encoding;
241			ManagedEVPPKey key;
242			AlgorithmParams params;
243
244		337	KeyPairGenConfig() = default;
245		1346	~KeyPairGenConfig() {
246		1346	Mutex::ScopedLock priv_lock(*key.mutex());
247			}
248
249		337	explicit KeyPairGenConfig(KeyPairGenConfig&& other) noexcept
250			: public_key_encoding(other.public_key_encoding),
251			private_key_encoding(
252			std::forward<PrivateKeyEncodingConfig>(
253		337	other.private_key_encoding)),
254		337	key(std::move(other.key)),
255		337	params(std::move(other.params)) {}
256
257			KeyPairGenConfig& operator=(KeyPairGenConfig&& other) noexcept {
258			if (&other == this) return *this;
259			this->~KeyPairGenConfig();
260			return *new (this) KeyPairGenConfig(std::move(other));
261			}
262
263			void MemoryInfo(MemoryTracker* tracker) const override {
264			tracker->TrackField("key", key);
265			if (!private_key_encoding.passphrase_.IsEmpty()) {
266			tracker->TrackFieldWithSize("private_key_encoding.passphrase",
267			private_key_encoding.passphrase_->size());
268			}
269			tracker->TrackField("params", params);
270			}
271
272			SET_MEMORY_INFO_NAME(KeyPairGenConfig)
273			SET_SELF_SIZE(KeyPairGenConfig)
274			};
275
276			struct NidKeyPairParams final : public MemoryRetainer {
277			int id;
278			SET_NO_MEMORY_INFO()
279			SET_MEMORY_INFO_NAME(NidKeyPairParams)
280			SET_SELF_SIZE(NidKeyPairParams)
281			};
282
283			using NidKeyPairGenConfig = KeyPairGenConfig<NidKeyPairParams>;
284
285			struct NidKeyPairGenTraits final {
286			using AdditionalParameters = NidKeyPairGenConfig;
287			static constexpr const char* JobName = "NidKeyPairGenJob";
288
289			static EVPKeyCtxPointer Setup(NidKeyPairGenConfig* params);
290
291			static v8::Maybe<bool> AdditionalConfig(
292			CryptoJobMode mode,
293			const v8::FunctionCallbackInfo<v8::Value>& args,
294			unsigned int* offset,
295			NidKeyPairGenConfig* params);
296			};
297
298			using NidKeyPairGenJob = KeyGenJob<KeyPairGenTraits<NidKeyPairGenTraits>>;
299			using SecretKeyGenJob = KeyGenJob<SecretKeyGenTraits>;
300			} // namespace crypto
301			} // namespace node
302
303			#endif // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
304			#endif // SRC_CRYPTO_CRYPTO_KEYGEN_H_
305