Fast subdomains enumeration tool for penetration testers
Go to file
fleetcaptain cef20ce6b3
Delete sublist3r.py
2018-01-15 16:21:55 -08:00
subbrute Update sublist3r.py subbrute.py 2016-10-27 23:23:46 +13:00
.gitignore Ignore working files 2016-07-15 20:24:11 +12:00
LICENSE Initial commit 2015-12-15 02:55:25 +02:00
README.md Update README.md 2018-01-15 16:21:17 -08:00
requirements.txt Add requirements.txt for dependencies 2016-08-22 19:13:36 +01:00

README.md

Turbolist3r - Beta

Turbolist3r is a fork of the sublist3r subdomain discovery tool. In addition to all original OSINT capabilties of sublist3r, turbolist3r automates some of the results analysis, with a focus on subdomain takeover.

Turbolist3r queries public DNS servers for each discovered subdomain. If the subdomain exists (i.e. the resolver replied with an address), the answer is categorized as CNAME or A record. By examining A records, it is possible to discover potential penetration testing targets for a given domain. Likewise, the process of looking for subdomain takeovers is simple; view the discovered CNAME records and investigate any that point to applicable cloud services.

This is an early release and may contain bugs or other irregularities.

Screenshots

Screenshot 1

Screenshot 2

Usage

Short Form Long Form Description
-d --domain Domain name to enumerate subdomains of
-b --bruteforce Enable the subbrute bruteforce module
-p --ports Scan the found subdomains against specific tcp ports
-v --verbose Enable the verbose mode and display results in realtime
-t --threads Number of threads to use for subbrute bruteforce
-e --engines Specify a comma-separated list of search engines
-o --output Save discovered domain names to specified text file
-h --help show the help message and exit
-a --analysis Do analysis of the results and save to specified text file

Examples

  • To enumerate subdomains of a specific domain, perform turbolist3r analysis, and save the analysis to a file:

python turbolist3r.py -d example.com -a analysis_file.txt

  • To list all the basic options and switches use -h switch:

python turbolist3r.py -h

  • To enumerate subdomains of specific domain:

python turbolist3r.py -d example.com

  • To enumerate subdomains of specific domain and save discovered subdomains to a file:

python turbolist3r.py -d example.com -o example_hosts.txt

  • To enumerate subdomains of specific domain and show the results in realtime:

python turbolist3r.py -v -d example.com

  • To enumerate subdomains and enable the bruteforce module:

python turbolist3r.py -b -d example.com

  • To enumerate subdomains and use specific engines such Google, Yahoo and Virustotal engines

python turbolist3r.py -e google,yahoo,virustotal -d example.com

Dependencies:

Note that turbolist3r has not been tested on Windows.

Turbolist3r depends on the requests, dnspython, and argparse python modules.

  • Install for Ubuntu/Debian:
sudo apt-get install python-requests
  • Install for Centos/Redhat:
sudo yum install python-requests
  • Install using pip on Linux:
sudo pip install requests

dnspython Module (http://www.dnspython.org/)

  • Install for Ubuntu/Debian:
sudo apt-get install python-dnspython
  • Install using pip:
sudo pip install dnspython

argparse Module

  • Install for Ubuntu/Debian:
sudo apt-get install python-argparse
  • Install for Centos/Redhat:
sudo yum install python-argparse
  • Install using pip:
sudo pip install argparse

License

Turbolist3r is licensed under the GNU GPL license. take a look at the LICENSE for more information.

Respect legal restrictions and only conduct testing against infrastructure that you have permission to target.

Credits

  • aboul3la - The creator of Sublist3r; turbolist3r adds some features but is otherwise a near clone of sublist3r.
  • TheRook - The bruteforce module was based on his script subbrute.
  • bitquark - The Subbrute's wordlist was based on his research dnspop.

Thanks

  • Thank you to aboul3la for releasing sublist3r, an incredible subdomain discovery tool!

Version

1/15/18 Version 0.1