Skip to content

cainepavl/password_checker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Password Checker

A simple command-line tool that checks if your passwords have been compromised using the Have I Been Pwned API. This tool helps users ensure their passwords are secure and encourages them to change compromised passwords.

Table of Contents

Features

  • Check multiple passwords at once.
  • Clear console output for better readability.
  • Color-coded output indicating password security status.

Requirements

  • Python 3.x installed on your machine. You can download it from Python
  • requests library
  • colorama library

You can install the required libraries using pip:

pip3 install requests colorama 
pip3 install colorama

Usage

  1. Clone this repository:
git clone https://github.com/cainepavl/password_checker.git  
cd password_checker
  1. Run the program with your passwords as command-line arguments:
python3 password_checker.py password1 password2 password3

... replace password1, password2, and password3 with the passwords you want to check.

Example Output

For a SAFE password the output will be GREEN:

password123 was found 5 times...</span> 
You should change it!</span> 

For a COMPROMISED password the output will be RED:

mySecurePassword is good to go!

How It Works

  1. Password Hashing: The program takes each password, hashes it using SHA-1, and sends the first 5 characters of the hash to the Have I Been Pwned API.

  2. API Response: The API returns a list of hashes that start with those 5 characters, allowing the program to check how many times the full password hash appears in the database.

  3. Output: The program displays whether each password is compromised or secure, with color-coded messages for better visibility.

Contributing

Contributions are welcome! If you have suggestions for improvements or features, feel free to create a pull request or open an issue.

License

This project is licensed under the MIT License - LICENSE see the file for details.

Acknowledgments

HAVE I BEEN PWNED for providing the API.

COLORAMA for terminal color formatting.

ZTM Academy for the course and walkthrough creating this site!

Contact

If you have any questions, feel free to contact me at [email protected]

About

Check for password compromise

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages