To ease this process and because I’d love to see more people care about their password quality, here is a guide to use the range search. To me it’s important that you don’t need to download any code that handles your valuable plain text passwords, that’s why I propose a really simple approch in some lines of python.
Let’s get going
Open a shell and start the python interpreter with
python (or find another way to start python) and enter the following lines
The part starting with
def defines a function that asks for your password, hashes it and splits the hash. You need to ensure that there are 2 spaces before 2nd to 4th line of this and that there is a blank line afterwards. In case you paste it into the interpreter, just hit enter to add a blank line more for safety. You need to see those
>>> again. The python interpreter will show it somehow like this.
Afterwards, without leaving the python interpreter you can just call the function which will then ask for the password to check (won’t be printed or recorded).
This is the example for my personal password
qwe123. Now, the first part
C5325 is what you need for the range search, it makes up the URL to query.
You can call that just with your browser, with wget or whatever tool you prefer for http. What you get back is on average 478 hashes that start with these 5 chars. This amount of hashes can be easily checked locally in your browser (Ctrl-F / Cmd-F) or with
grep in your terminal.
Precisely, you don’t get complete hashes back, you only get the remaining 35 chars of the hash, the first 5 are missing. This is where the second part of the output of the python function comes into place, you have to use this for your local search. To mee, that was initially confusing because I missed this detail in Troy’s API description which lead me to the misbelief that ‚qwe123‘ might be an unknown password.
Looks to me like my password is pretty famous, the hash is in the list. After the hash, there is a number that shows how often this password was found inside all the data that Troy collected. But honestly, this number does not matter, at least for security. If the hash is in the data you should consider your password publicly known which means it will be used in dictionary attacks. Go and change it!
My colleague Simon Kölsch dug a lot deeper into the topic of password security in context of the „have i been pwned?“ database with his post „Enforce strong passwords!“. Go for it to get more into the details and see how all this can be fully integrated into your own services.
Disclaimer: The code above was tested on Mac OS with python 3.6 and 2.7, it is supposed to work on any python environment version 2.7 or newer. Use at own risk. Feedback welcome.