Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/r3curs1v3-pr0xy/sub404
A python tool to check subdomain takeover vulnerability
https://github.com/r3curs1v3-pr0xy/sub404
bug-bounty bugbounty bugbounty-tool pentesting sub404 subdomain subdomain-takeover takeover-subdomain vulnerability-scanner
Last synced: 3 months ago
JSON representation
A python tool to check subdomain takeover vulnerability
- Host: GitHub
- URL: https://github.com/r3curs1v3-pr0xy/sub404
- Owner: r3curs1v3-pr0xy
- License: gpl-3.0
- Archived: true
- Created: 2020-07-03T11:58:56.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-01-06T15:26:23.000Z (almost 2 years ago)
- Last Synced: 2024-04-13T17:17:38.752Z (7 months ago)
- Topics: bug-bounty, bugbounty, bugbounty-tool, pentesting, sub404, subdomain, subdomain-takeover, takeover-subdomain, vulnerability-scanner
- Language: Python
- Homepage:
- Size: 421 KB
- Stars: 321
- Watchers: 9
- Forks: 60
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- WebHackersWeapons - Sub404 - pr0xy/sub404?label=%20)|[`subdomains`](/categorize/tags/subdomains.md) [`takeover`](/categorize/tags/takeover.md)|[](/categorize/langs/Go.md)| (Weapons / Tools)
README
# Sub404: A Fast Tool To Check Subdomain Takeover Vulnerability
## 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+
- git clone https://github.com/r3curs1v3-pr0xy/sub404.git
- Install dependencies: pip install -r requirements.txt
- Install [Subfinder](https://github.com/projectdiscovery/subfinder) (optional)
- Install [Sublist3r](https://github.com/aboul3la/Sublist3r) (optional)
- python3 sub404.py -h
### 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
- If subfinder and sublist3r is not installed, provide subdomains in text file
$ python3 sub404.py -f subdomain.txt
## 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](https://twitter.com/hackw1thproxy/)
## Credits:
[Ice3man543](https://github.com/Ice3man543) - Projectdiscovery's subfinder tool is used to enumerate subdomains
[aboul3la](https://github.com/aboul3la) - aboul3la's sublist3r tool is used to enumerate subdomains
## Current version is 1.0