2018-08-09 03:40:29 +08:00
```
*******************************************************************
2014-12-17 07:28:01 +08:00
* *
* | |_| |__ ___ /\ /\__ _ _ ____ _____ ___| |_ ___ _ __ *
* | __ | '_ \ / _ \ / /_ / / _` | '__\ \ / / _ \/ __ | __ / _ \ '__| *
* | |_| | | | __ / / __ / (_| | | \ V / __ /\__ \ || __ / | *
* \__|_| |_|\___| \/ /_/ \__,_|_| \_/ \___||___/\__\___|_| *
* *
2019-04-19 23:18:49 +08:00
* theHarvester 3.1.0 dev *
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
*******************************************************************
```
2019-02-11 05:56:01 +08:00
[](https://travis-ci.com/laramies/theHarvester)
2011-05-04 23:07:06 +08:00
What is this?
-------------
2019-01-02 06:40:40 +08:00
theHarvester is a very simple, yet effective tool designed to be used in the early< br >
2019-02-28 11:31:45 +08:00
stages of a penetration test. Use it for open source intelligence gathering and< br >
helping to determine a company's external threat landscape on the internet. The< br >
tool gathers emails, names, subdomains, IPs, and URLs using multiple public data< br >
sources that include:
2014-12-17 07:25:12 +08:00
2018-12-23 04:29:11 +08:00
Passive:
--------
2019-03-18 12:05:29 +08:00
* baidu: Baidu search engine - www.baidu.com
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
2019-03-15 03:44:46 +08:00
* censys: Censys.io search engine - www.censys.io
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
2019-03-15 03:43:28 +08:00
* cymon: Cymon.io search engine - www.cymon.io
* dnsdumpster: DNSdumpster search engine - dnsdumpster.com
2014-12-17 07:25:12 +08:00
2018-12-23 04:29:11 +08:00
* dogpile: Dogpile search engine - www.dogpile.com
2014-12-17 07:33:13 +08:00
2019-01-23 06:29:04 +08:00
* duckduckgo: DuckDuckGo search engine - www.duckduckgo.com
2019-01-02 10:43:42 +08:00
2018-12-27 15:19:13 +08:00
* google: Google search engine (Optional Google dorking.) - www.google.com
2014-12-17 07:25:12 +08:00
2019-03-15 03:43:28 +08:00
* google-certificates: Google Certificate Transparency report
2016-10-11 16:57:24 +08:00
2018-12-27 15:19:13 +08:00
* hunter: Hunter search engine (Requires API key, see below.) - www.hunter.io
2014-12-17 07:25:12 +08:00
2019-02-01 05:13:37 +08:00
* intelx: Intelx search engine (Requires API key, see below.) - www.intelx.io
2019-03-18 12:05:29 +08:00
* linkedin: Google search engine, specific search for Linkedin users - www.linkedin.com
2014-12-17 07:25:12 +08:00
2019-03-15 03:43:28 +08:00
* netcraft: Netcraft Data Mining - www.netcraft.com
2014-12-17 07:33:13 +08:00
2019-01-27 09:01:30 +08:00
* securityTrails: Security Trails search engine, the world's largest repository< br >
2018-12-27 15:19:13 +08:00
of historical DNS data (Requires API key, see below.) - www.securitytrails.com
2018-12-23 09:20:55 +08:00
2018-12-27 15:19:13 +08:00
* shodan: Shodan search engine, will search for ports and banners from discovered< br >
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 09:20:55 +08:00
* trello: Search trello boards (Uses Google search.)
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
2019-03-18 12:05:29 +08:00
* virustotal: virustotal.com domain search
2018-11-07 06:12:20 +08:00
2018-12-23 04:29:11 +08:00
* yahoo: Yahoo search engine
2014-12-17 07:25:12 +08:00
2019-01-01 19:58:14 +08:00
* all: currently a subset of all the most effective plugins
2018-11-23 07:33:04 +08:00
2014-12-17 07:25:12 +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
2014-12-17 07:25:12 +08:00
2018-12-23 04:29:11 +08:00
Modules that require an API key:
--------------------------------
2019-01-22 04:46:10 +08:00
Add your keys to api-keys.yaml
2018-12-27 15:19:13 +08:00
2019-02-28 11:31:45 +08:00
* bingapi
* hunter
* intelx
* securityTrails
* shodan
2011-05-04 23:07:06 +08:00
Dependencies:
2018-12-23 04:29:11 +08:00
-------------
2019-01-02 06:40:40 +08:00
* Python 3.6
2019-01-21 00:13:34 +08:00
* python3 -m pip install -r requirements.txt
2018-08-09 03:34:10 +08:00
2018-12-23 04:29:11 +08:00
Comments, bugs, or requests?
----------------------------
2019-03-19 05:26:54 +08:00
* [](https://twitter.com/laramies) Christian Martorella @laramies
* cmartorella@edge-security.com
2014-12-17 07:25:12 +08:00
2019-01-09 07:49:26 +08:00
Main contributors:
2019-01-28 09:33:18 +08:00
------------------
2019-04-13 02:14:56 +08:00
* [](https://twitter.com/NotoriousRebel1) Matthew Brown @NotoriousRebel1
2019-03-19 05:26:54 +08:00
* [](https://twitter.com/jay_townsend1) Jay "L1ghtn1ng" Townsend @jay_townsend1
2019-03-19 05:12:01 +08:00
* [](https://twitter.com/Jzold) Janos Zold @Jzold
* [](https://twitter.com/discoverscripts) Lee Baird @discoverscripts
2019-01-09 07:49:26 +08:00
Thanks:
-------
2019-01-01 19:58:14 +08:00
* John Matherly - Shodan project
2018-12-23 04:29:11 +08:00
* Ahmed Aboul Ela - subdomain names dictionaries (big and small)