1
0
Fork 0
mirror of https://github.com/Luzifer/password.git synced 2024-12-19 12:21:17 +00:00
Fast and secure password generator and library
Find a file
2024-12-12 12:06:03 +01:00
.github/workflows CI: Replace build-system 2024-04-07 01:03:15 +02:00
ci CI: Replace build-system 2024-04-07 01:03:15 +02:00
cmd/password Update Go dependencies 2024-12-12 10:35:16 +01:00
hasher Modernize code, replace broken library 2024-04-07 00:52:39 +02:00
js Update node dependencies 2024-12-12 10:35:52 +01:00
lib Lint: Update linter config, fix linter error 2024-12-12 10:41:31 +01:00
.gitignore Switch from bindata to go:embed 2022-06-27 21:40:10 +02:00
.gitmodules Breaking: Password v2.0.0 (#5) 2019-02-28 19:51:33 +01:00
.golangci.yml Lint: Update linter config, fix linter error 2024-12-12 10:41:31 +01:00
Dockerfile Fix missing JS build in Dockerfile 2022-06-28 00:36:33 +02:00
generateXKCDWordList.sh Breaking: Password v2.0.0 (#5) 2019-02-28 19:51:33 +01:00
go.mod Update Go dependencies 2024-12-12 12:05:53 +01:00
go.sum Update Go dependencies 2024-12-12 12:05:53 +01:00
History.md prepare release v2.4.2 2024-12-12 12:06:03 +01:00
LICENSE Replace Apache license stub with proper license 2017-09-22 15:32:49 +02:00
Makefile CI: Replace build-system 2024-04-07 01:03:15 +02:00
README.md Breaking: Password v2.0.0 (#5) 2019-02-28 19:51:33 +01:00

Go Report Card

Luzifer / password

The intention of this project is to provide a fast and secure way to generate one or more passwords using a CLI tool, a HTTPs page or a HTTPs API.

For the security of the passwords there are several assertions:

  • The password may not contain pattern found on the keyboard or in alphabet
  • The password must have 3 or 4 different character groups in it depending on whether special characters are requested
  • The password may not have repeating characters
  • The API generator does not transmit or store any data about the generated passwords

Usage

Via Web

My service Secure Password is powered by this app and will provide you with secure passwords.

Via CLI

  1. Download the compiled binary from Github releases

  2. Generate your password:

    $ ./password get -h
    generate and return a secure random password
    
    Usage:
      password get [flags]
    
    Flags:
      -d, --date         prepend current date to XKCD style passwords (default true)
      -h, --help         help for get
      -j, --json         return output in JSON format
      -l, --length int   length of the generated password (default 20)
      -n, --number int   number of passwords to generate (default 1)
      -s, --special      use special characters in your password
      -x, --xkcd         use XKCD style password
    
    $ ./password get
    Vzupi4IaPbXmSQEX9A4e
    
    $ ./password get -l 32 -s
    }d.sks(4J$2G]x52=k)WAN{M68LxEg}%
    
    $ ./password get -l 4 -x
    20190101.SeashellSupporterTumbleweedGeneral
    

Via API

  • /v1/getPassword - Retrieve a password from the API
    • date=true - Set to false no to prepend the date to XKCD-style passwords
    • length=20 - Specify the length of the password to generate (the API only supports values between 4 and 128 - for more characters use the CLI)
    • special=false - Set to true to enable special characters
    • xkcd=false - Set to true to enable XKCD-style passwords

Self-Hosted

  1. Download the compiled binary from Github releases

  2. Run the API server:

    $ ./password serve -h
    start an API server to request passwords
    
    Usage:
      password serve [flags]
    
    Flags:
      -h, --help       help for serve
          --port int   port to listen on (default 3000)
    
  3. Request your password using http://localhost:3000/v1/getPassword?length=20&special=true

Hosted

$ curl https://passwd.fyi/v1/getPassword?length=20&special=true
0M4L-1[lT:@2&7,p,o-;

As library in your own code

package main

import pwd "github.com/Luzifer/password/v2/lib"

func getPassword() (string, error) {
	return pwd.NewSecurePassword().GeneratePassword(16, false)
}

Benchmark / Test

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

Build Status

$ go test -bench .
goos: linux
goarch: amd64
pkg: github.com/Luzifer/password/lib
BenchmarkGeneratePasswords8Char-8                  20000             65469 ns/op
BenchmarkGeneratePasswords8CharSpecial-8           20000             97659 ns/op
BenchmarkGeneratePasswords16Char-8                 20000             84215 ns/op
BenchmarkGeneratePasswords16CharSpecial-8          20000             92885 ns/op
BenchmarkGeneratePasswords32Char-8                 10000            152436 ns/op
BenchmarkGeneratePasswords32CharSpecial-8          10000            144352 ns/op
BenchmarkGeneratePasswords128Char-8                 1000           2199011 ns/op
BenchmarkGeneratePasswords128CharSpecial-8          2000           1089225 ns/op
BenchmarkGeneratePasswords4Words-8                200000              9472 ns/op
BenchmarkGeneratePasswords20Words-8               100000             14098 ns/op
PASS
ok      github.com/Luzifer/password/lib 21.624s