29c339a7034de121bda92762e105de296172fa2aba02ace7758b8a197e684e78295bf7f01220c448898f4f5a312701f7a24eb08bf055f4a8e9a8cfe6e6555b 2.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748
  1. # pbkdf2 <sup>[![Version Badge][2]][1]</sup>
  2. This library provides the functionality of PBKDF2 with the ability to use any supported hashing algorithm returned from `crypto.getHashes()`
  3. [![github actions][actions-image]][actions-url]
  4. [![coverage][codecov-image]][codecov-url]
  5. [![dependency status][5]][6]
  6. [![dev dependency status][7]][8]
  7. [![License][license-image]][license-url]
  8. [![Downloads][downloads-image]][downloads-url]
  9. [![npm badge][11]][1]
  10. ## Usage
  11. ```js
  12. var pbkdf2 = require('pbkdf2')
  13. var derivedKey = pbkdf2.pbkdf2Sync('password', 'salt', 1, 32, 'sha512')
  14. ...
  15. ```
  16. For more information on the API, please see the relevant [Node documentation](https://nodejs.org/api/crypto.html#crypto_crypto_pbkdf2_password_salt_iterations_keylen_digest_callback).
  17. For high performance, use the `async` variant (`pbkdf2.pbkdf2`), not `pbkdf2.pbkdf2Sync`; this variant has the oppurtunity to use `window.crypto.subtle` when browserified.
  18. ## Credits
  19. This module is a derivative of [cryptocoinjs/pbkdf2-sha256](https://github.com/cryptocoinjs/pbkdf2-sha256/), so thanks to [JP Richardson](https://github.com/jprichardson/) for laying the ground work.
  20. Thank you to [FangDun Cai](https://github.com/fundon) for donating the package name on npm, if you're looking for his previous module it is located at [fundon/pbkdf2](https://github.com/fundon/pbkdf2).
  21. [1]: https://npmjs.org/package/pbkdf2
  22. [2]: https://versionbadg.es/browserify/pbkdf2.svg
  23. [5]: https://david-dm.org/browserify/pbkdf2.svg
  24. [6]: https://david-dm.org/browserify/pbkdf2
  25. [7]: https://david-dm.org/browserify/pbkdf2/dev-status.svg
  26. [8]: https://david-dm.org/browserify/pbkdf2#info=devDependencies
  27. [11]: https://nodei.co/npm/pbkdf2.png?downloads=true&stars=true
  28. [license-image]: https://img.shields.io/npm/l/pbkdf2.svg
  29. [license-url]: LICENSE
  30. [downloads-image]: https://img.shields.io/npm/dm/pbkdf2.svg
  31. [downloads-url]: https://npm-stat.com/charts.html?package=pbkdf2
  32. [codecov-image]: https://codecov.io/gh/browserify/pbkdf2/branch/main/graphs/badge.svg
  33. [codecov-url]: https://app.codecov.io/gh/browserify/pbkdf2/
  34. [actions-image]: https://img.shields.io/endpoint?url=https://github-actions-badge-u3jn4tfpocch.runkit.sh/browserify/pbkdf2
  35. [actions-url]: https://github.com/browserify/pbkdf2/actions