File: README.md

package info (click to toggle)
pwndck 0.2-3
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 108 kB
  • sloc: python: 70; makefile: 8
file content (38 lines) | stat: -rw-r--r-- 1,258 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
# pwndck

Check the the HaveIBeenPwned password database to see if a particular password
has been compromised.

It uses the [haveibeenpwned API](https://haveibeenpwned.com/API/v3#PwnedPasswords)
for the check:
  * This use does not require an API key. Anyone can run it.
  * This is more secure than the [web page tool](https://haveibeenpwned.com/Passwords).
    your password is not exposed beyond your local machine.
  * It returns the number of times the password occurs in the database.

# Install
Install from [PyPi](https://pypi.org/project/pwndck/)

# Usage

    $ pwndck.py -h
    usage: pwndck [-h] [-q] [password]
    
    Report # of password hits in HaveIBeenPwned
    
    positional arguments:
      password     The password to check
    
    options:
      -h, --help   show this help message and exit
      -q, --quiet  Suppress output
    
    Evaluate a password against the HaveIBeenPwned password
    database, and return the number of accounts for which it has
    been reported as compromised. If the password is not specified
    on the command line, the user will be prompted.
    
    The command returns with an error code if the password is
    found in the database.
    
    See https://haveibeenpwned.com/API/v3#PwnedPasswords