Luzifer / password

This project is a rewrite of my former password generator written in Python. The intention is to provide a fast and secure way to generate one or more passwords using a CLI tool or a HTTP(s) API.

Usage

Via Web

My service pwd.knut.me is powered by this API and will provide you with secure passwords.

Via CLI

1. Download the compiled binary from GoBuilder.me and unzip the package

2. Generate your password:

   # ./password get -h
   NAME:
     get - generate and return a secure random password
   
   USAGE:
     command get [command options] [arguments...]
   
   OPTIONS:
     --length, -l "20"	length of the generated password
     --special, -s	use special characters in your password
   
   # ./password get
   Vzupi4IaPbXmSQEX9A4e
   
   # ./password get -l 32 -s
   }d.sks(4J$2G]x52=k)WAN{M68LxEg}%
   

Via API

• /v1/getPassword - Retrieve a password from the API
  • length=20 - Specify the length of the password to generate
  • special=false - Set to true to enable special characters

Self-Hosted

1. Download the compiled binary from GoBuilder.me and unzip the package

2. Run the API server:

   # ./password serve -h
   NAME:
     serve - start an API server to request passwords
   
   USAGE:
     command serve [command options] [arguments...]
   
   OPTIONS:
     --port "3000"	port to listen on
   

3. Request your password using http://localhost:3000/v1/getPassword?length=20&special=true

Hosted

# curl http://password.hub.luzifer.io/v1/getPassword?length=20&special=true
0M4L-1[lT:@2&7,p,o-;

Benchmark / Test

Tests and benchmark are run by Travis CI at every push to this repository:

# go test -bench .
PASS
BenchmarkGeneratePasswords8Char           20000       74875 ns/op
BenchmarkGeneratePasswords8CharSpecial    10000      108451 ns/op
BenchmarkGeneratePasswords16Char          10000      135059 ns/op
BenchmarkGeneratePasswords16CharSpecial   10000      142958 ns/op
BenchmarkGeneratePasswords32Char           5000      307994 ns/op
BenchmarkGeneratePasswords32CharSpecial    5000      284031 ns/op
BenchmarkGeneratePasswords128Char           300     6721034 ns/op
BenchmarkGeneratePasswords128CharSpecial    500     3244446 ns/op
ok  	github.com/Luzifer/password/lib	13.764s