crypto.argon2Sync(algorithm, parameters)

• 'algorithm' <string> Argon2 的变体，是 '“argon2d”， ''argon2i' 或 '“argon2id”' 之一。
• parameters <Object>
  • message <string> | <ArrayBuffer> | <Buffer> | <TypedArray> | <DataView> 必填，这是用于 Argon2 密码哈希应用的密码。
  • nonce <string> | <ArrayBuffer> | <Buffer> | <TypedArray> | <DataView> 必填，长度至少为 8 字节。这是 Argon2 密码哈希应用的盐值。
  • parallelism <number> 是必需的，并行度决定可以运行多少计算链（通道）。必须大于1且小于 2**24-1。
  • tagLength <number> 必填，要生成的密钥长度。必须大于 4 且小于 2**32-1。
  • memory <number> 必填，内存消耗以 1KiB 块为单位。必须大于 8 * parallelism 并且小于 2**32-1。实际的块数会向下取整到最接近的 4 * parallelism 倍数。
  • passes <number> 必需，传递次数（迭代次数）。必须大于 1 且小于 2**32-1。
  • secret <string> | <ArrayBuffer> | <Buffer> | <TypedArray> | <DataView> | <undefined> 可选，随机额外输入，类似于盐，不应与派生密钥一起存储。在密码哈希应用中称为 pepper。如果使用，长度不得超过 2**32-1 字节。
  • associatedData <string> | <ArrayBuffer> | <Buffer> | <TypedArray> | <DataView> | <undefined> 可选，附加数据，将添加到哈希中，功能上等同于盐值或密钥，但用于非随机数据。如果使用，长度不得超过 2**32-1 字节。
• 返回：<Buffer>

提供同步的 氩气2 实现。Argon2 是一种基于密码的密钥派生函数，设计上在计算和内存方面都很昂贵，以使暴力破解攻击不划算。

🌐 Provides a synchronous Argon2 implementation. Argon2 is a password-based key derivation function that is designed to be expensive computationally and memory-wise in order to make brute-force attacks unrewarding.

nonce 应尽可能唯一。建议 nonce 是随机的，并且至少 16 字节长。详情请参见 NIST SP 800-132。

🌐 The nonce should be as unique as possible. It is recommended that a nonce is random and at least 16 bytes long. See NIST SP 800-132 for details.

在为 message、nonce、secret 或 associatedData 传递字符串时，请考虑 将字符串用作加密 API 输入时的注意事项。

🌐 When passing strings for message, nonce, secret or associatedData, please consider caveats when using strings as inputs to cryptographic APIs.

当密钥派生失败时，会抛出异常，否则派生的密钥将作为 Buffer 返回。

🌐 An exception is thrown when key derivation fails, otherwise the derived key is returned as a Buffer.

当任何输入参数指定无效的值或类型时，会抛出异常。

🌐 An exception is thrown when any of the input arguments specify invalid values or types.

const { argon2Sync, randomBytes } = await import('node:crypto');

const parameters = {
  message: 'password',
  nonce: randomBytes(16),
  parallelism: 4,
  tagLength: 64,
  memory: 65536,
  passes: 3,
};

const derivedKey = argon2Sync('argon2id', parameters);
console.log(derivedKey.toString('hex'));  // 'af91dad...9520f15'const { argon2Sync, randomBytes } = require('node:crypto');

const parameters = {
  message: 'password',
  nonce: randomBytes(16),
  parallelism: 4,
  tagLength: 64,
  memory: 65536,
  passes: 3,
};

const derivedKey = argon2Sync('argon2id', parameters);
console.log(derivedKey.toString('hex'));  // 'af91dad...9520f15'拷贝