pass-test

A simple password checker

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
pass-test
001.0.39 years ago10 years agoMinified + gzip package size for pass-test in KB

Readme

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