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 文檔。