objection-password-argon2
TypeScript icon, indicating that this package has built-in type declarations

2.3.1 • Public • Published

Automatic Argon2 Password Hashing for Objection.js Build Status

This plugin automatically adds automatic password hashing to your Objection.js models. This makes it super-easy to secure passwords and other sensitive data.

Under the hood, the plugin uses Argon2 for hashing.

Installation

yarn add objection-password-argon2

Usage

Hashing your data

import Password from 'objection-password-argon2'
import Model from 'objection'
 
class Person extends Password()(Model) {
  // ...
}
 
const person = await Person.query().insert({
  email: 'matt@damon.com',
  password: 'q1w2e3r4'
});
 
console.log(person.password);
// $argon2i$v=19$m=4096,t=3,p=1$yqdvmjCHT1o+03hbpFg7HQ$Vg3+D9kW9+Nm0+ukCzKNWLb0h8iPQdTkD/HYHrxInhA

Verifying the data

// the password to verify
const password = 'q1w2e3r4';
 
// fetch the person by email
const person =
    await Person.query().first().where({ email: 'matt@damon.com'});
 
// verify the password is correct
const passwordValid = await person.verifyPassword(password);

Options

There are a few options you can pass to customize the way the plugin works.

These options can be added when instantiating the plugin. For example:

import Password from 'objection-password-argon2'
 
class Person extends Password({ passwordField: 'hash' })(Model) {
  // ...
}

allowEmptyPassword (defaults to false)

Allows an empty password to be set.

passwordField (defaults to password)

Allows you to override the name of the field to be hashed.

Readme

Keywords

none

Package Sidebar

Install

npm i objection-password-argon2

Weekly Downloads

1

Version

2.3.1

License

MIT

Unpacked Size

7.87 kB

Total Files

6

Last publish

Collaborators

  • venables