Skip to content

Protect your personal information from hackers and cyber criminals with HackAlert. Our product scans the internet for your online persona, including financial, social, and personal accounts, to detect data breaches or hacks. With real-time notifications via text or email, you can take action before it's too late. Stay safe and secure with HackAlert

License

Notifications You must be signed in to change notification settings

initd1/HackAlert

Repository files navigation

Build and Test Docker Integration CodeQL GitHub Repo stars GitHub tag (latest SemVer)

Socials:

Twitter Follow Discord

Installation instructions

  1. Clone the github repository git clone https://github.com/initd1/HackAlert.git

Environment Set-up

  1. Install python-pip in your environment
  2. Install virtualenv pip install virtualenv
  3. Create virtual environment virtualenv <environment-name>
  4. Activate virtual environment
    Mac or Linux
source <environment-name>/bin/activate

Windows

<environment-name>\Scripts\activate.bat
  1. Install required packages in the virtual environment
pip install -r requirements.txt

Prerequisites

  1. Ensure config.ini file is created under Config directory
  2. Format of config.ini file is as below:
[APIKeys]
VT_APIKey = 1234567890
HIBP_APIKey = 1234567890
  1. Add API keys for Virus Total and Haveibeenpwned

Testing

It is important that before you do anything you have the requirements.txt file installed as it is required for the dependencies that are used in this project.

To install all dependencies listed in this file, run the following:

python -m pip install -r requirements.txt

To execute tests, please ensure that you have the pytest module installed. The unittest module is used, however, this is native to python and does not have to be installed. To run tests, please ensure that you are in the base directory, where Tests and main.py is visible.

To run tests with print output:

pytest -s 

To run tests without print output:

pytest

Warning pytest will not run if python site-packages are not already in your global path!

Execution

  1. HackAlert Usage:
python hackalert.py -h
usage: hackalert.py [-h] [-e EMAIL] [-i IP] [-u USERNAME]

Check if the given data has been compromised in a data breach.

options:
  -h, --help            show this help message and exit
  -e EMAIL, --email EMAIL
                        Email address to check
  -i IP, --ip IP        IP address to check
  -u USERNAME, --username USERNAME
                        Username to check
  1. Example Usage: image

About

Protect your personal information from hackers and cyber criminals with HackAlert. Our product scans the internet for your online persona, including financial, social, and personal accounts, to detect data breaches or hacks. With real-time notifications via text or email, you can take action before it's too late. Stay safe and secure with HackAlert

Resources

License

Stars

Watchers

Forks

Packages

No packages published