ralexandr / hashers

Hashing algorithms from Django implemented for nodejs projects.

hashers

All password hashing algorithms for Django implemented in javascript for nodejs projects.

Supported Algorithms

1. PBKDF2PasswordHasher
2. PBKDF2SHA1PasswordHasher
3. BCryptSHA256PasswordHasher
4. BCryptPasswordHasher
5. SHA1PasswordHasher
6. MD5PasswordHasher
7. UnsaltedSHA1PasswordHasher
8. UnsaltedMD5PasswordHasher
9. Argon2PasswordHasher

Usage

A simple example just verifying and creating Django compatible passwords:

var hashers = require('node-django-hashers');

var h = new hashers.PBKDF2PasswordHasher();
h.encode("password").then(console.log); // prints the hashed password

You can also get a hashed password, identify the hashing algorithm, and verify the password. The below example is for PBKDF2PasswordHasher, a similar approach to the above code sample can be used for all the other algorithms.

var hashers = require('node-django-hashers');

// Hashed password from Django
var hash_password = "argon2$argon2i$v=19$m=512,t=2,p=2$ZGIzQXZXdjlaMjRK$2ecZ6JAld41sKwh9Q8KEyQ";

var hash_name = hashers.identifyHasher(hash_password);
var hash_algorithm = hashers.getHasher(hash_name);
hash_algorithm.verify("password", hash_password).then(console.log); // prints true
hash_algorithm.verify("wrong_password", hash_password).then(console.log); // prints false

A good practice is to verify if the password is using the default algorithm, and update the password if necessary on the database. Every hashing algorithm has an algorithm name. You can pass it in and check if updates are required:

var hashers = require('node-django-hashers');

var hash_password = "286755fad04869ca523320acce0dc6a4"; // "password" in md5
var mustUpdate = hashers.mustUpdateHashedPassword(hash_password, "pbkdf2_sha256");
// mustUpdate is true since we do not want MD5 hash passwords, pbkdf2_sha256 is the default

var hash_algorithm = hashers.getHasher("pbkdf2_sha256");
// update the users password in the database by re encoding the password here

Installation

npm install node-django-hashers