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

crypto.pbkdf2Sync(password, salt, iterations, keylen, digest)

参数

• password <string> | <Buffer> | <TypedArray> | <DataView>
• salt <string> | <Buffer> | <TypedArray> | <DataView>
• iterations <number>
• keylen <number>
• digest <string>
• 返回： <Buffer>

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

如果发生错误，将抛出 Error ，否则将返回派生 key 作为 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 {
  pbkdf2Sync
} = await import('node:crypto');

const key = pbkdf2Sync('secret', 'salt', 100000, 64, 'sha512');
console.log(key.toString('hex'));  // '3745e48...08d59ae'const {
  pbkdf2Sync,
} = require('node:crypto');

const key = pbkdf2Sync('secret', 'salt', 100000, 64, 'sha512');
console.log(key.toString('hex'));  // '3745e48...08d59ae'

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

import crypto from 'node:crypto';
crypto.DEFAULT_ENCODING = 'hex';
const key = crypto.pbkdf2Sync('secret', 'salt', 100000, 512, 'sha512');
console.log(key);  // '3745e48...aa39b34'const crypto = require('node:crypto');
crypto.DEFAULT_ENCODING = 'hex';
const key = crypto.pbkdf2Sync('secret', 'salt', 100000, 512, 'sha512');
console.log(key);  // '3745e48...aa39b34'

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