theHarvester/README.md

119 lines
3.5 KiB
Markdown
Raw Normal View History

2018-08-09 03:40:29 +08:00
```
*******************************************************************
2014-12-17 07:28:01 +08:00
* *
* | |_| |__ ___ /\ /\__ _ _ ____ _____ ___| |_ ___ _ __ *
* | __| '_ \ / _ \ / /_/ / _` | '__\ \ / / _ \/ __| __/ _ \ '__| *
* | |_| | | | __/ / __ / (_| | | \ V / __/\__ \ || __/ | *
* \__|_| |_|\___| \/ /_/ \__,_|_| \_/ \___||___/\__\___|_| *
* *
2018-12-23 04:29:11 +08:00
* TheHarvester Ver. 3.0.6 *
2014-12-17 07:28:01 +08:00
* Coded by Christian Martorella *
* Edge-Security Research *
* cmartorella@edge-security.com *
2018-08-09 03:40:29 +08:00
*******************************************************************
```
2011-05-04 23:07:06 +08:00
What is this?
-------------
2018-12-23 04:29:11 +08:00
theHarvester is a tool used for gathering names, emails, subdomains, virtual
hosts, open ports/banners, and employee names from different public sources
(search engines, PGP key servers). A really simple, but very effective tool for
the early stages of a penetration test or just to know the visibility of your
company on the internet.
2011-05-04 23:07:06 +08:00
2018-12-23 04:29:11 +08:00
The data sources include:
2018-12-23 04:29:11 +08:00
Passive:
--------
* baidu: Baidu search engine
2011-05-04 23:07:06 +08:00
2018-12-23 04:29:11 +08:00
* bing: Microsoft search engine - www.bing.com
2011-05-04 23:07:06 +08:00
2018-12-23 04:29:11 +08:00
* bingapi: Microsoft search engine, through the API (Requires API key, see below.)
2018-03-23 06:40:41 +08:00
2018-12-23 04:29:11 +08:00
* censys:
2018-03-23 06:40:41 +08:00
2018-08-09 03:44:02 +08:00
* crtsh: Comodo Certificate search - www.crt.sh
2018-03-23 06:40:41 +08:00
2018-12-23 04:29:11 +08:00
* cymon:
2018-12-23 04:29:11 +08:00
* dogpile: Dogpile search engine - www.dogpile.com
2014-12-17 07:33:13 +08:00
2018-12-23 04:29:11 +08:00
* google: Google search engine - www.google.com (Optional Google dorking.)
2018-12-23 04:29:11 +08:00
* googleCSE: Google custom search engine
2018-12-23 04:29:11 +08:00
* googleplus: Users that work in target company (Uses Google search.)
2018-12-23 04:29:11 +08:00
* google-certificates: Google Certificate Transparency report
2018-12-23 04:29:11 +08:00
* google-profiles: Google search engine, specific search for Google profiles
* hunter: Hunter search engine (Requires API key, see below.)
2018-12-18 07:14:42 +08:00
* linkedin: Google search engine, specific search for Linkedin users
2018-12-23 04:29:11 +08:00
* netcraft:
2014-12-17 07:33:13 +08:00
2018-12-23 04:29:11 +08:00
* pgp: PGP key server - mit.edu
2014-12-17 07:33:13 +08:00
2018-12-23 04:29:11 +08:00
* shodan: Shodan search engine, will search for ports and banners from discovered
hosts - www.shodanhq.com
2014-12-17 07:33:13 +08:00
2018-12-23 04:29:11 +08:00
* threatcrowd: Open source threat intelligence - www.threatcrowd.org
2014-12-17 07:33:13 +08:00
2018-12-23 04:29:11 +08:00
* trello:
2015-05-11 06:37:00 +08:00
2018-12-23 04:29:11 +08:00
* twitter: Twitter accounts related to a specific domain (Uses Google search.)
* vhost: Bing virtual hosts search
2014-12-17 07:33:13 +08:00
2018-12-23 04:29:11 +08:00
* virustotal:
2018-12-23 04:29:11 +08:00
* yahoo: Yahoo search engine
2018-12-23 04:29:11 +08:00
* all:
2018-11-23 07:33:04 +08:00
Active:
-------
2018-12-23 04:29:11 +08:00
* DNS brute force: dictionary brute force enumeration
* DNS reverse lookup: reverse lookup of IP´s discovered in order to find hostnames
2018-08-09 03:44:02 +08:00
* DNS TDL expansion: TLD dictionary brute force enumeration
2018-12-23 04:29:11 +08:00
Modules that require an API key:
--------------------------------
* googleCSE: add your API key and CSE ID to discovery/googleCSE.py
* hunter: add your API key to discovery/huntersearch.py
* shodan: add your API key to discovery/shodansearch.py
2011-05-04 23:07:06 +08:00
Dependencies:
2018-12-23 04:29:11 +08:00
-------------
2018-08-09 03:44:02 +08:00
* Requests library (http://docs.python-requests.org/en/latest/)
`pip install requests`
2018-11-23 05:20:06 +08:00
* Beautiful Soup 4 (https://pypi.org/project/beautifulsoup4//)
2018-12-23 04:29:11 +08:00
`pip install beautifulsoup4`
Changelog in 3.0.0:
------------------
2018-08-09 04:08:20 +08:00
* Subdomain takeover checks
* Port scanning (basic)
* Improved DNS dictionary
* Shodan DB search fixed
* Result storage in Sqlite
2018-03-23 06:40:41 +08:00
2018-12-23 04:29:11 +08:00
Comments, bugs, or requests?
----------------------------
2011-05-04 23:07:06 +08:00
cmartorella@edge-security.com
Updates:
--------
2014-12-17 07:33:13 +08:00
https://github.com/laramies/theHarvester
Thanks:
-------
* Matthew Brown @NotoriousRebel
2018-12-12 05:07:48 +08:00
* Janos Zold @Jzold
2018-12-23 04:29:11 +08:00
* John Matherly - Shodan project
* Lee Baird @discoverscripts - suggestions and bugs reporting
* Ahmed Aboul Ela - subdomain names dictionaries (big and small)