pass-pwned is a Password Store extension for checking passwords against the pwnedpasswords API
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
tests Use datafile for tests Mar 25, 2018
.gitignore Ignoring gnupg random_seed Mar 4, 2018
.travis.yml more travis fixes Mar 25, 2018
Makefile Setup tests Mar 3, 2018
README.md Update README.md Jan 20, 2019
license.md Initial extension implementation Mar 2, 2018
pass-pwned.1 Imrpoved docs Mar 24, 2018
pwned.bash bsearch project address Mar 24, 2018

README.md

pass-pwned

Build Status

A pass extension for checking passwords against pwnedpasswords API.

This extension supports checking individual passwords or all passwords against the API.

If you're concerned about using the API, you can provide a password hash file to use instead via the -f or --file option.

Usage

pass pwned is a Password Store extension for checking passwords against the pwnedpasswords API.

  Usage:

    pass pwned check [-f <filename>] [pass-name]
        Check the contents of pass-name against pwnedpasswords API. For a multiline
        passfile only the first line will be checked.

        Using the -f or --file flag will use the provided password hash file
        instead of the pwnedpasswords API.

        If you want to check all of your password store entries, don't provide a
        pass-name.

  Options:
    -f, --file    Provide a sorted password hash file to use instead of the API.

More information may be found in the pass-pwned(1) man page.

Password Hash Files

Password hash fils must be sorted by the hash, this is to allow an efficient lookup using bsearch.

Hash files should be structured as follows, with a colon (:) separating the hash from count.

21BD10E37C7AE489C68833760870331191440428:4
21BD10E517DD1DBBEBB24B31D69EFCD9AA3565D5:15
21BD10F212CF1B355E4F388728F61E0C6DE227B8:5
...

Installation

Manual

git clone https://github.com/jamesridgway/pass-pwned.git
cd pass-pwned
make install