Client for HIBP passwords api using K-Anonymity method
Project description
pywnedPasswords
===============
.. image:: https://travis-ci.org/xmatthias/pywnedpasswords.svg?branch=master
:target: https://travis-ci.org/xmatthias/pywnedpasswords
:alt: Build Status
This script uses the pwnedpasswords.com v2 api to check your password in
a secure way (using the `K-anonymity <https://en.wikipedia.org/wiki/K-anonymity>`_ method)
The full Hash is never transmitted over the wire, only the first 5 characters.
The comparison happens offline.
Special thanks to Troy Hunt (\ `@troyhunt <https://twitter.com/troyhunt>`_\ ) for making this script possible.
Installation
------------
.. code-block:: bash
pip install pywnedpasswords
Usage
-----
Interactive
^^^^^^^^^^^
.. code-block:: bash
pywnedpasswords
Insert your password when asked.
the output will either be:
..
Password to check:
Found your password 47205 times.
or in case your password is secure
..
Password to check:
Your password did not appear in PwnedPasswords yet.
Passing the password as a command line argument
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
**Discouraged - as it might leaves the password in your shell history**
.. code-block:: bash
pywnedpasswords Passw0rd
..
Found your password 46980 times.
Piping the password
^^^^^^^^^^^^^^^^^^^
**Discouraged - as it might leaves the password in your shell history**
.. code-block:: bash
echo -n 'Passw0rd!' | pywnedpasswords
..
Found your password 46980 times.
Reading passwords from a file
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. code-block:: bash
pywnedpasswords -f list-of-passwords.txt
Result is in the form: ``<line number>: <number of time the password was found>``. ``0`` meaning the password is not known from Have I Been Pwned yet.
..
.. raw:: html
<pre>
0: 7026
1: 45337
2: 376
3: 51
4: 27
5: 11
6: 136
7: 1
8: 6
9: 1
10: 0
11: 0
12: 0
</pre>
Exit code
---------
The ``pywnedpasswords`` exits with code ``2`` if the password is know of Have I Been Pwned already, and exit code ``0`` otherwise.
© xmatthias 2018
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pywnedpasswords-0.61.tar.gz
(4.3 kB
view hashes)
Built Distribution
Close
Hashes for pywnedpasswords-0.61-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5b798809977dcfa11fe35be46caa1ad7a4cba49c01f1fa8c96e13332494070a5 |
|
MD5 | 4722388c9e1eb56b85e1c40dde0d25d3 |
|
BLAKE2b-256 | f74ea8ee877074284f3407dc75643ad16535d7eac529552b563f1a128285825b |