src/crypto/crypto_argon2.h - main - githubmirror/node

src/crypto/crypto_argon2.h
88 строк3 KB
Filip Skokan
src: implement MemoryRetainer protocol for ByteSource
29 июл 2026, 20:48
29 июл 2026, 20:4829d183d
#ifndef SRC_CRYPTO_CRYPTO_ARGON2_H_
#define SRC_CRYPTO_CRYPTO_ARGON2_H_

#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS

#include "crypto/crypto_keys.h"
#include "crypto/crypto_util.h"

namespace node::crypto {
#if OPENSSL_WITH_ARGON2

// Argon2 is a password-based key derivation algorithm
// defined in https://datatracker.ietf.org/doc/html/rfc9106

// It takes as input a password, a salt value, and a
// handful of additional parameters that control the
// cost of the operation. In this case, the higher
// the cost, the better the result. The length parameter
// defines the number of bytes that are generated.

// The salt must be as random as possible and should be
// at least 16 bytes in length.

struct Argon2Config final : public MemoryRetainer {
  KeyObjectData key;
  ByteSource pass;
  ByteSource salt;
  ByteSource secret;
  ByteSource ad;
  ncrypto::Argon2Type type;
  uint32_t iter;
  uint32_t lanes;
  uint32_t memcost;
  uint32_t version = 0x13;
  uint32_t keylen;

  Argon2Config() = default;

  explicit Argon2Config(Argon2Config&& other) noexcept;

  Argon2Config& operator=(Argon2Config&& other) noexcept;

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

struct Argon2Traits final {
  using AdditionalParameters = Argon2Config;
  static constexpr const char* JobName = "Argon2Job";
  static constexpr AsyncWrap::ProviderType Provider =
      AsyncWrap::PROVIDER_ARGON2REQUEST;

  static v8::Maybe<void> AdditionalConfig(
      CryptoJobMode mode,
      const v8::FunctionCallbackInfo<v8::Value>& args,
      unsigned int offset,
      Argon2Config* config);

  static bool DeriveBits(Environment* env,
                         const Argon2Config& config,
                         ByteSource* out,
                         CryptoJobMode mode,
                         CryptoErrorStore* errors);

  static v8::MaybeLocal<v8::Value> EncodeOutput(Environment* env,
                                                const Argon2Config& config,
                                                ByteSource* out);
};

using Argon2Job = DeriveBitsJob<Argon2Traits>;

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

#else
// If there is no Argon2 support, Argon2Job becomes a non-op
struct Argon2Job {
  static void Initialize(Environment* env, v8::Local<v8::Object> target) {}
};
#endif

}  // namespace node::crypto

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