pwgen

Documentation

Overview

Package pwgen implements multiple popular password generate algorithms. It supports creating classic cryptic passwords with different character classes as well as more recent memorable approaches.

Some methods try to ensure certain requirements are met and can be very slow.

Index

• Constants
• func GenerateExternal(pwlen int) (string, error)
• func GenerateMemorablePassword(minLength int, symbols bool) string
• func GeneratePassword(length int, symbols bool) string
• func GeneratePasswordCharset(length int, chars string) string
• func GeneratePasswordCharsetCheck(length int, chars string) string
• func GeneratePasswordWithAllClasses(length int) (string, error)
• func Prune(in string, cutset string) string
• type Cryptic
  • func NewCryptic(length int) *Cryptic
  • func NewCrypticForDomain(length int, domain string) *Cryptic
  • func NewCrypticWithAllClasses(length int) *Cryptic
  • func NewCrypticWithCrunchy(length int) *Cryptic
  • func (c *Cryptic) Password() string

Examples

• GenerateMemorablePassword

Constants

const (
	Digits = "0123456789"
	Upper  = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
	Lower  = "abcdefghijklmnopqrstuvwxyz"
	Syms   = "!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~"
	Ambiq  = "0ODQ1IlB8G6S5Z2"
	// CharAlpha is the class of letters
	CharAlpha = Upper + Lower
	// CharAlphaNum is the class of alpha-numeric characters
	CharAlphaNum = Digits + Upper + Lower
	// CharAll is the class of all characters
	CharAll = Digits + Upper + Lower + Syms
)

Character classes

Functions

func GenerateExternal

func GenerateExternal(pwlen int) (string, error)

GenerateExternal will invoke an external password generator, if set, and return it's output.

func GenerateMemorablePassword

func GenerateMemorablePassword(minLength int, symbols bool) string

GenerateMemorablePassword will generate a memorable password with a minimum length

Example

fmt.Println(GenerateMemorablePassword(12, false))

func GeneratePassword

func GeneratePassword(length int, symbols bool) string

GeneratePassword generates a random, hard to remember password

func GeneratePasswordCharset

func GeneratePasswordCharset(length int, chars string) string

GeneratePasswordCharset generates a random password from a given set of characters

func GeneratePasswordCharsetCheck

func GeneratePasswordCharsetCheck(length int, chars string) string

GeneratePasswordCharsetCheck generates a random password from a given set of characters and validates the generated password with crunchy

func GeneratePasswordWithAllClasses

func GeneratePasswordWithAllClasses(length int) (string, error)

GeneratePasswordWithAllClasses tries to enforce a password which contains all character classes instead of only enabling them. This is especially useful for broken (corporate) password policies that mandate the use of certain character classes for no good reason

func Prune

func Prune(in string, cutset string) string

Prune removes all characters in cutset from the input

Types

type Cryptic

type Cryptic struct {
	Chars      string
	Length     int
	MaxTries   int
	Validators []func(string) error
}

Cryptic is a generator for hard-to-remember passwords as required by (too) many sites. Prefer memorable or xkcd-style passwords, if possible.

func NewCryptic

func NewCryptic(length int) *Cryptic

NewCryptic creates a new generator with sane defaults.

func NewCrypticForDomain

func NewCrypticForDomain(length int, domain string) *Cryptic

NewCrypticForDomain tries to look up password rules for the given domain or uses the default generator.

func NewCrypticWithAllClasses

func NewCrypticWithAllClasses(length int) *Cryptic

NewCrypticWithAllClasses returns a password generator that generates passwords containing all available character classes

func NewCrypticWithCrunchy

func NewCrypticWithCrunchy(length int) *Cryptic

NewCrypticWithCrunchy returns a password generators that only returns a password if it's successfully validated with crunchy.

func (*Cryptic) Password

func (c *Cryptic) Password() string

Password returns a single password from the generator