README
¶
Can Haz Password?
A Go library for generating random, rule based passwords. Many random, much secure.
Features
- Randomized password length (bounded).
- Tunable password composition (eg. special character frequency).
- Password complexity enforcement.
- Rules support for enforcing custom requirements.
Quickstart
An example implementation of a password generator utilizing this library is available cmd/main.go.
Documentation
Documentation is available in the docs subdirectory.
Developing
Prerequisites
- Make
- Go 1.13 (or greater)
- golangci-lint
Build
Lint, and test your changes:
make lint test
Run
To generate a new random password:
make run
Issues
If you find a bug or have a feature request, please report them via this repositories issues section. If you find a security vulnerability please first contact the security team for responsible disclosure information. Do not post security vulnerabilities as public GitHub issues.
Directories
¶
| Path | Synopsis |
|---|---|
|
An example reference implementation of a random password generator.
|
An example reference implementation of a random password generator. |
|
Package password provides methods for generating secure random passwords, and shared constants such as common character sets.
|
Package password provides methods for generating secure random passwords, and shared constants such as common character sets. |
|
Package rand provides primitives and utilities for generating and working with secure random numbers.
|
Package rand provides primitives and utilities for generating and working with secure random numbers. |
Click to show internal directories.
Click to hide internal directories.