pass-test

1.0.3 • Public • Published

Pass-Test

A tool for checking if a password satisfies basic rules (using owasp-password-strength-test, or appears on the list of 10,000 most common passwords (https://xato.net/passwords/more-top-worst-passwords/#.VCQkvh37vtQ)

Configuration

You can configure pass-test to fit your password policy

property Description Default
maxLength Maximum password length 256
minLength Minimum password length 8
minPhraseLength Minimum length to be considered a passphrase 20
minOptionalTestsToPass Passwords must pass at least this many optional tests to be considered strong 3
allowPassphrases If false, passphrases are no longer exempt from optional tests true

Usage

var PassTest = require("PassTest");
var pt = new PassTest();

var badPassword = "password";
var goodPassword = "LaserUnicornHammerTime23!";

var result = pt.test(badPassword);
console.log(resultSet1);
/*
{
  // details of required and optional tests passed
  "errors": [
    "Password is on the 10,000 most commonly used password list",
    "The password must contain at least one uppercase letter.",
    "The password must contain at least one number.",
    "The password must contain at least one special character."
  ],
  "failedTests": [
    3,
    5,
    6,
    7
  ],
  "passedTests": [
    0,
    1,
    2,
    4
  ],
  "isPassphrase": false,
  // failed overall
  "strong": false,
  "optionalTestsPassed": 1
}
*/

var resultSet2 = pt.test(goodPassword);
console.log(resultSet2);
/*
{
  "errors": [],
  "failedTests": [],
  "passedTests": [
    0,
    1,
    2,
    3
  ],
  "isPassphrase": true,
  "strong": true,
  "optionalTestsPassed": 0
}
*/

Tests

npm test to run unit tests

Readme

Keywords

none

Package Sidebar

Install

npm i pass-test

Weekly Downloads

318

Version

1.0.3

License

MIT

Last publish

Collaborators

  • cadecairos