An open API service indexing awesome lists of open source software.

https://github.com/kloeckner-i/can-haz-password

A Go Library For Generating Random, Rule Based Passwords. Many Random, Much Secure.
https://github.com/kloeckner-i/can-haz-password

Last synced: 6 months ago
JSON representation

A Go Library For Generating Random, Rule Based Passwords. Many Random, Much Secure.

Awesome Lists containing this project

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](cmd/main.go).

## Demonstration

![can-haz-password demonstration](demo.gif)

## Documentation

Documentation is available in the [docs](docs) subdirectory.

## Developing

### Prerequisites

* Make
* [Go 1.13](https://golang.org/dl/) (or greater)
* [golangci-lint](https://golangci-lint.run)

### Build

Lint, and test your changes:

```console
make lint test
```

### Run

To generate a new random password:

```console
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](mailto:[email protected]?subject=Can%20Haz%20Password%20Vulnerability%20Report)
for responsible disclosure information. Do not post security vulnerabilities as
public GitHub issues.