strong-password-generator

Strong Password Generator is a utility module which provides straight-forward, powerful password generation function.

Installation

To install strong-password-generator, use npm:

npm install strong-password-generator

Usage

using default configurations

var strongPaswordGenerator = require("strong-password-generator");

strongPaswordGenerator.generatePassword();
// >> "cWst77snJtVris"

providing own configurations

var strongPaswordGenerator = require("strong-password-generator");
var defaultPasswordConfig = {
  base: 'WORD',
  length: {
    min: 12,
    max: 16
  },
  capsLetters: {
    min: 3,
    max: 3
  },
  numerals: {
    min: 2,
    max: 2
  },
  spacialCharactors: {
    includes: [],
    min: 0,
    max: 0
  },
  spaces: {
    allow: false,
    min: 0,
    max: 0
  }
};

strongPaswordGenerator.generatePassword(defaultPasswordConfig); // defaultPasswordConfig optional
// >> "cWst77snJtVris"

get default configurations

var strongPaswordGenerator = require("strong-password-generator");

strongPaswordGenerator.getDefaultConfig();
// >> {
  base: 'WORD',
  length: {
    min: 12,
    max: 16
  },
  capsLetters: {
    min: 3,
    max: 3
  },
  numerals: {
    min: 2,
    max: 2
  },
  spacialCharactors: {
    includes: [],
    min: 0,
    max: 0
  },
  spaces: {
    allow: false,
    min: 0,
    max: 0
  }
}

API

strong-password-generator.

• generatePassword(options) - options [OPTIONAL]

  • base - describe the way that password text populated [REQUIRED]
    • WORD - from random word for given length
    • RANDOM - from a totaly random text for given length
  • length - length of the password [REQUIRED]
    • min - minimum length of the password
    • max - maximum length of the password
  • capsLetters - number of capital letters needs to be included within the password [REQUIRED]
    • min - minimum number of captital letters for the password
    • max - maximum number of captital letters for the password
  • numerals - number of numerals needs to be included within the password [REQUIRED]
    • min - minimum number of numerals for the password
    • max - maximum number of numerals for the password
  • spacialCharactors - details of the speacial charactors needs to be included within the password [REQUIRED]
    • includes - list of special charactors used to generate password
    • min - minimum number of special charactors for the password
    • max - maximum number of special charactors for the password
  • spaces - details of the spaces needs to be included within the password [REQUIRED]
    • allow - specify whether password includes spaces or not
    • min - minimum number of spaces for the password
    • max - maximum number of spaces for the password

• getDefaultConfig() - to get default configurations