Ethical Hacking Tutorials

Ethical Hacking Tutorials, Tips and Tricks

H8Mail โ€“ Email OSINT and password breach hunting.


Use h8mail to find passwords through different breach and reconnaissance services, or the infamous Breached Compilation torrent

Features

  • ๐Ÿ”Ž Email pattern matching (reg exp), useful for all those raw HTML files
  • ๐Ÿณ Small and fast Alpine Dockerfile available
  • โœ… CLI or Bulk file-reading for targeting
  • ๐Ÿ“ Output to CSV file
  • โžฟ Reverse DNS + Open Ports
  • ๐Ÿ‘ฎ CloudFlare rate throttling avoidance
    • Execution flow remains synchronous and throttled according to API usage guidelines written by service providers
  • ๐Ÿ”ฅ Query and group results from different breach service providers
  • ๐Ÿ”ฅ Query a local copy of the โ€œBreach Compilationโ€
  • ๐Ÿ”ฅ Get related emails
  • ๐ŸŒˆ Delicious colors

Demos

๐Ÿ”“ Out of the box

1

๐Ÿš€ With API services

2

๐Ÿ’ฝ With the BreachedCompilation torrent

3

APIs

Service Functions Status
HaveIBeenPwned Number of email breachs โœ…
Shodan Reverse DNS, Open ports โœ…
Hunter.io โ€“ Public Number of related emails โœ…
Hunter.io โ€“ Service (free tier) Cleartext related emails โœ…
WeLeakInfo โ€“ Public Number of search-able breach results ๐Ÿ›ƒ
WeLeakInfo โ€“ Service Cleartext passwords, hashs and salts ๐Ÿ”œ
Snusbase โ€“ Service Cleartext passwords, hashs and salts โ€“ Fast โšก๏ธ โœ…

๐ŸŠ Install

If youโ€™re using Docker, make sure to add your targets.txt and your API keys in the configuration file before building

Locally

NodeJS is required to ensure CloudFlare bypassing. You can find out how to install it for your distribution here

These instructions assume you are running Python3 as default. If unsure, please check the troubleshooting section

apt-get install nodejs
git clone https://github.com/khast3x/h8mail.git
cd h8mail
pip install -r requirements.txt
python h8mail.py -h

Docker

git clone https://github.com/khast3x/h8mail.git
cd h8mail
docker build -t h8mail .
docker run -ti h8mail -h

๐ŸŠ Usage

> python h8mail.py --help
usage: h8mail.py [-h] -t TARGET_EMAILS [-c CONFIG_FILE] [-o OUTPUT_FILE]
                 [-bc BC_PATH] [-v] [-l] [-k CLI_APIKEYS]

Email information and password finding tool

optional arguments:
  -h, --help            show this help message and exit
  -t TARGET_EMAILS, --targets TARGET_EMAILS
                        Either single email, or file (one email per line).
                        REGEXP
  -c CONFIG_FILE, --config CONFIG_FILE
                        Configuration file for API keys
  -o OUTPUT_FILE, --output OUTPUT_FILE
                        File to write output
  -bc BC_PATH, --breachcomp BC_PATH
                        Path to the breachcompilation Torrent.
                        https://ghostbin.com/paste/2cbdn
  -v, --verbose         Show debug information
  -l, --local           Run local actions only
  -k CLI_APIKEYS, --apikey CLI_APIKEYS
                        Pass config options. Format is "K:V,K:V"

๐ŸŠ Usage examples

Query for a single target
python h8mail.py -t [email protected]
Query for list of targets, indicate config file for API keys, output to pwned_targets.csv
python h8mail.py -t targets.txt -c config.ini -o pwned_targets.csv
Query a list of targets against local copy of the Breach Compilation, pass API keys for Snusbase from the command line
python h8mail.py -t targets.txt -bc ../Downloads/BreachCompilation/ -k "snusbase_url:$snusbase_url,snusbase_token:$snusbase_token"
Query without making API calls against local copy of the Breach Compilation
python h8mail.py -t targets.txt -bc ../Downloads/BreachCompilation/ --local

๐ŸŠ Troubleshooting

Python version & Kali

The above instructions assume you are running python3 as default. If unsure, type:

in your terminal. It should be either Python 3.* or Python 2.*.

If you are running python2 as default :
Make sure you have python3 installed, then replace python commands with explicit python3 calls:

apt-get install nodejs
git clone https://github.com/khast3x/h8mail.git
cd h8mail
pip3 install -r requirements.txt
python3 h8mail.py -h

Updated: January 12, 2019 — 12:53 am

Leave a Reply

Your email address will not be published. Required fields are marked *

Ethical Hacking Tutorials © 2018
Skip to toolbar