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, capitals 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, symbols bool) (string, error)
- func Prune(in string, cutset string) string
- type Cryptic
Examples ¶
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
Variables ¶
This section is empty.
Functions ¶
func GenerateExternal ¶ added in v1.12.9
GenerateExternal will invoke an external password generator, if set, and return it's output.
func GenerateMemorablePassword ¶ added in v1.12.9
GenerateMemorablePassword will generate a memorable password with a minimum length
Example ¶
fmt.Println(GenerateMemorablePassword(12, false, false))
Output:
func GeneratePassword ¶
GeneratePassword generates a random, hard to remember password
func GeneratePasswordCharset ¶
GeneratePasswordCharset generates a random password from a given set of characters
func GeneratePasswordCharsetCheck ¶
GeneratePasswordCharsetCheck generates a random password from a given set of characters and validates the generated password with crunchy
func GeneratePasswordWithAllClasses ¶ added in v1.8.0
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
Types ¶
type Cryptic ¶ added in v1.12.9
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 ¶ added in v1.12.9
NewCryptic creates a new generator with sane defaults.
func NewCrypticForDomain ¶ added in v1.12.9
NewCrypticForDomain tries to look up password rules for the given domain or uses the default generator.
func NewCrypticWithAllClasses ¶ added in v1.12.9
NewCrypticWithAllClasses returns a password generator that generates passwords containing all available character classes
func NewCrypticWithCrunchy ¶ added in v1.12.9
NewCrypticWithCrunchy returns a password generators that only returns a password if it's successfully validated with crunchy.
Source Files
Directories