/sub404

A python tool to check subdomain takeover vulnerability

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Sub404: A Fast Tool To Check Subdomain Takeover Vulnerability

Banner

What is Sub 404

Sub 404 is a tool written in python which is used to check possibility of subdomain takeover vulnerability and it is fast as it is asynchronous.

Why

During recon process you might get a lot of subdomains(e.g more than 10k). It is not possible to test each manually or with traditional requests or urllib method as it is very slow. Using Sub 404 you can automate this task in much faster way. Sub 404 uses aiohttp/asyncio which makes this tool asynchronous and faster.

How it works

Sub 404 uses subdomains list from text file and checks for url of 404 Not Found status code and in addition it fetches CNAME(Canonical name) and removes those URL which have target domain name in CNAME. It also combines result from subfinder and sublist3r(subdomain enumeration tool) if you don't have target subdomains as two is better than one. But for this sublist3r and subfinder tools must be installed in your system. Sub 404 is able to check 7K subdomains in less than 5 minutes.

Key Features:

- Fast (as it is asynchronous)
- Uses two more tools to increase efficiency
- Saves result in a text file for future reference
- Umm thats it, nothing much !

How to use:

Note: Only works on Python3.7+

Using docker

As an alternative, it is also possible to build a Docker image, so no prerequisites are necessary.

$ docker build -t sub404 .
$ docker run --rm sub404 -h

Usage example:

Note: If subfinder and sublist3r is installed.
This combines result from sublist3r and subfinder tool and checks for possibility of takeover.
$ python3 sub404.py -d anydomain.com

Example


- If subfinder and sublist3r is not installed, provide subdomains in text file
$ python3 sub404.py -f subdomain.txt

Example

Note:

This tool is mostly tested in linux but should works on other OS too.

Usage options:

$ python3 sub404.py -h

This will display help for the tool. Here are all the switches it supports.

Flag Description Example
-d Domain name of the taget. python3 sub404.py -d noobarmy.tech
-f Provide location of subdomain file to check for takeover if subfinder is not installed. python3 sub404.py -f subdomain.txt
-p Set protocol for requests. Default is "http". python3 sub404.py -f subdomain.txt -p https or python3 sub404.py -d noobarmy.tech -p https
-o Output unique subdomains of sublist3r and subfinder to text file. Default is "uniqueURL.txt" python3 sub404.py -d noobarmy.tech -o output.txt
-h show this help message and exit python3 sub404.py -h

Note:

This tool fetches CNAME of 404 response code URL and removes all URL which have target domain in CNAME. So chances of false positives are high.

Contributing to Sub 404:

- Report bugs, missing best practices
- DM me with new ideas
- Help in Fixing bugs

My Twitter:

Say Hello @hackw1thproxy

Credits:

Ice3man543 - Projectdiscovery's subfinder tool is used to enumerate subdomains
aboul3la - aboul3la's sublist3r tool is used to enumerate subdomains

Current version is 1.0