{"id":13762673,"url":"https://github.com/r3curs1v3-pr0xy/sub404","last_synced_at":"2025-05-10T15:31:43.693Z","repository":{"id":51243148,"uuid":"276889193","full_name":"r3curs1v3-pr0xy/sub404","owner":"r3curs1v3-pr0xy","description":"A python tool to check subdomain takeover vulnerability","archived":true,"fork":false,"pushed_at":"2023-01-06T15:26:23.000Z","size":431,"stargazers_count":321,"open_issues_count":1,"forks_count":60,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-04-13T17:17:38.752Z","etag":null,"topics":["bug-bounty","bugbounty","bugbounty-tool","pentesting","sub404","subdomain","subdomain-takeover","takeover-subdomain","vulnerability-scanner"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/r3curs1v3-pr0xy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-07-03T11:58:56.000Z","updated_at":"2024-04-12T00:39:43.000Z","dependencies_parsed_at":"2023-02-06T05:45:46.576Z","dependency_job_id":null,"html_url":"https://github.com/r3curs1v3-pr0xy/sub404","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r3curs1v3-pr0xy%2Fsub404","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r3curs1v3-pr0xy%2Fsub404/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r3curs1v3-pr0xy%2Fsub404/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r3curs1v3-pr0xy%2Fsub404/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/r3curs1v3-pr0xy","download_url":"https://codeload.github.com/r3curs1v3-pr0xy/sub404/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224825762,"owners_count":17376326,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bug-bounty","bugbounty","bugbounty-tool","pentesting","sub404","subdomain","subdomain-takeover","takeover-subdomain","vulnerability-scanner"],"created_at":"2024-08-03T14:00:53.113Z","updated_at":"2024-11-16T21:30:39.019Z","avatar_url":"https://github.com/r3curs1v3-pr0xy.png","language":"Python","funding_links":[],"categories":["Weapons"],"sub_categories":["Tools"],"readme":"# Sub404: A Fast Tool To Check Subdomain Takeover Vulnerability\n![Banner](https://github.com/r3curs1v3-pr0xy/sub404/blob/master/banner.png)\n\n## What is Sub 404\nSub 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.\n\n## Why\nDuring 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 \u003cb\u003eSub 404\u003c/b\u003e you can automate this task in much faster way. Sub 404 uses \u003cb\u003eaiohttp/asyncio\u003c/b\u003e which makes this tool asynchronous and faster.\n\n## How it works\nSub 404 uses subdomains list from text file and checks for url of \u003cb\u003e404 Not Found\u003c/b\u003e status code and in addition it fetches \u003cb\u003eCNAME\u003c/b\u003e(Canonical name) and removes those URL which have target domain name in CNAME. It also combines result from \u003cb\u003esubfinder\u003c/b\u003e and \u003cb\u003esublist3r\u003c/b\u003e(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 \u003cb\u003e7K\u003c/b\u003e subdomains in less than 5 minutes.\n\n## Key Features:\n```\n- Fast (as it is asynchronous)\n- Uses two more tools to increase efficiency\n- Saves result in a text file for future reference\n- Umm thats it, nothing much !\n```\n## How to use:\n\u003cb\u003eNote: Only works on Python3.7+\u003c/b\u003e\n\n- git clone https://github.com/r3curs1v3-pr0xy/sub404.git\n- Install dependencies: pip install -r requirements.txt\n- Install [Subfinder](https://github.com/projectdiscovery/subfinder) (optional)\n- Install [Sublist3r](https://github.com/aboul3la/Sublist3r) (optional)\n- python3 sub404.py -h \n\n### Using docker\nAs an alternative, it is also possible to build a Docker image, so no prerequisites are necessary.\n```\n$ docker build -t sub404 .\n$ docker run --rm sub404 -h\n```\n\n## Usage example:\n\n\u003cb\u003eNote: If subfinder and sublist3r is installed.\u003c/b\u003e\u003cbr\u003e\nThis combines result from sublist3r and subfinder tool and checks for possibility of takeover.\u003cbr\u003e\n\u003ccode\u003e$ python3 sub404.py -d anydomain.com\u003c/code\u003e\n\n![Example](https://github.com/r3curs1v3-pr0xy/sub404/blob/master/example1.png)\n\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\u003cb\u003e - If subfinder and sublist3r is not installed, provide subdomains in text file\u003c/b\u003e\u003cbr\u003e\n\u003ccode\u003e$ python3 sub404.py -f subdomain.txt\u003c/code\u003e\u003cbr\u003e\u003cbr\u003e\n![Example](https://github.com/r3curs1v3-pr0xy/sub404/blob/master/example.png)\n## Note:\n\u003cb\u003eThis tool is mostly tested in linux but should works on other OS too.\u003c/b\u003e\n## Usage options:\n```\n$ python3 sub404.py -h\n```\nThis will display help for the tool. Here are all the switches it supports.\n\n\n|Flag |                Description                                             |                       Example                            |\n|-----|------------------------------------------------------------------------|----------------------------------------------------------|\n|  -d  | Domain name of the taget.                                                | python3 sub404.py -d noobarmy.tech                      |\n| -f   | Provide location of subdomain file to check for takeover if subfinder is not installed. | python3 sub404.py -f subdomain.txt|\n| -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|\n| -o | Output unique subdomains of sublist3r and subfinder to text file. Default is \"uniqueURL.txt\" | python3 sub404.py -d noobarmy.tech -o output.txt|\n| -h | show this help message and exit | python3 sub404.py -h|\n\n## Note:\n```\nThis 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.\n```\n\n## Contributing to Sub 404:\n```\n- Report bugs, missing best practices\n- DM me with new ideas\n- Help in Fixing bugs\n```\n## My Twitter:\n\u003cb\u003eSay Hello [@hackw1thproxy](https://twitter.com/hackw1thproxy/)\n\n## Credits:\n[Ice3man543](https://github.com/Ice3man543) - Projectdiscovery's subfinder tool is used to enumerate subdomains\u003cbr\u003e\n[aboul3la](https://github.com/aboul3la) - aboul3la's sublist3r tool is used to enumerate subdomains\n\n## Current version is 1.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fr3curs1v3-pr0xy%2Fsub404","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fr3curs1v3-pr0xy%2Fsub404","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fr3curs1v3-pr0xy%2Fsub404/lists"}