TritonDataCenter/node-bcrypt-pbkdf: Port of the OpenBSD `bcrypt_pbkdf` function to pure Javascript · GitHub

Name		Name	Last commit message	Last commit date
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
index.js		index.js
package.json		package.json

Repository files navigation

Port of the OpenBSD bcrypt_pbkdf function to pure Javascript. npm-ified version of Devi Mandiri's port, with some minor performance improvements. The code is copied verbatim (and un-styled) from Devi's work.

This product includes software developed by Niels Provos.

API

bcrypt_pbkdf.pbkdf(pass, passlen, salt, saltlen, key, keylen, rounds)

Derive a cryptographic key of arbitrary length from a given password and salt, using the OpenBSD bcrypt_pbkdf function. This is a combination of Blowfish and SHA-512.

See this article for further information.

Parameters:

pass, a Uint8Array of length passlen
passlen, an integer Number
salt, a Uint8Array of length saltlen
saltlen, an integer Number
key, a Uint8Array of length keylen, will be filled with output
keylen, an integer Number
rounds, an integer Number, number of rounds of the PBKDF to run

bcrypt_pbkdf.hash(sha2pass, sha2salt, out)

Calculate a Blowfish hash, given SHA2-512 output of a password and salt. Used as part of the inner round function in the PBKDF.

Parameters:

sha2pass, a Uint8Array of length 64
sha2salt, a Uint8Array of length 64
out, a Uint8Array of length 32, will be filled with output

License

This source form is a 1:1 port from the OpenBSD blowfish.c and bcrypt_pbkdf.c. As a result, it retains the original copyright and license. The two files are under slightly different (but compatible) licenses, and are here combined in one file. For each of the full license texts see LICENSE.