Node.js crypto.pbkdf2(password, salt, iterations, keylen, digest, callback)用法及代码示例

crypto.pbkdf2(password, salt, iterations, keylen, digest, callback)

参数

• password <string> | <ArrayBuffer> | <Buffer> | <TypedArray> | <DataView>
• salt <string> | <ArrayBuffer> | <Buffer> | <TypedArray> | <DataView>
• iterations <number>
• keylen <number>
• digest <string>
• callback <Function>
  • err <Error>
  • derivedKey <Buffer>

提供异步的基于密码的 key 派生函数 2 (PBKDF2) 实现。应用由digest 指定的选定HMAC 摘要算法以从password、salt 和iterations 导出请求字节长度(keylen) 的 key 。

提供的 callback 函数使用两个参数调用：err 和 derivedKey。如果在导出 key 时发生错误，将设置err；否则 err 将是 null 。默认情况下，成功生成的 derivedKey 将作为 Buffer 传递给回调。如果任何输入参数指定无效值或类型，将引发错误。

如果 digest 是 null ，将使用 'sha1'。此行为已弃用，请明确指定 digest。

iterations 参数必须设置为尽可能高的数字。迭代次数越多，派生 key 就越安全，但需要更长的时间才能完成。

salt 应尽可能独特。建议盐是随机的并且至少 16 字节长。有关详细信息，请参阅NIST SP 800-132。

在传递 password 或 salt 的字符串时，请考虑 caveats when using strings as inputs to cryptographic APIs 。

const {
  pbkdf2
} = await import('node:crypto');

pbkdf2('secret', 'salt', 100000, 64, 'sha512', (err, derivedKey) => {
  if (err) throw err;
  console.log(derivedKey.toString('hex'));  // '3745e48...08d59ae'
});const {
  pbkdf2,
} = require('node:crypto');

pbkdf2('secret', 'salt', 100000, 64, 'sha512', (err, derivedKey) => {
  if (err) throw err;
  console.log(derivedKey.toString('hex'));  // '3745e48...08d59ae'
});

crypto.DEFAULT_ENCODING 属性可用于更改 derivedKey 传递给回调的方式。但是，此属性已被弃用，应避免使用。

import crypto from 'node:crypto';
crypto.DEFAULT_ENCODING = 'hex';
crypto.pbkdf2('secret', 'salt', 100000, 512, 'sha512', (err, derivedKey) => {
  if (err) throw err;
  console.log(derivedKey);  // '3745e48...aa39b34'
});const crypto = require('node:crypto');
crypto.DEFAULT_ENCODING = 'hex';
crypto.pbkdf2('secret', 'salt', 100000, 512, 'sha512', (err, derivedKey) => {
  if (err) throw err;
  console.log(derivedKey);  // '3745e48...aa39b34'
});

可以使用 crypto.getHashes() 检索支持的摘要函数数组。

此 API 使用 libuv 的线程池，这可能会对某些应用程序产生令人惊讶的负面性能影响；有关详细信息，请参阅 UV_THREADPOOL_SIZE 文档。