Subdominator - Unleash the Power of Subdomain Enumeration

Subdominator is a powerful tool for passive subdomain enumeration during bug hunting and reconnaissance processes. It is designed to help researchers and cybersecurity professionals discover potential security vulnerabilities by efficiently enumerating subdomains some various free passive resources.

Features:

• fast and powerfull to enumerate subdomains.
• 45+ passive results to enumerate subdomains.
• configurable API keys setup
• Integrated notification system

Usage:

subdominator -h

                    __         __                       _                    __                
   _____  __  __   / /_   ____/ /  ____    ____ ___    (_)   ____   ____ _  / /_  ____    _____
  / ___/ / / / /  / __ \ / __  /  / __ \  / __ `__ \  / /   / __ \ / __ `/ / __/ / __ \  / ___/
 (__  ) / /_/ /  / /_/ // /_/ /  / /_/ / / / / / / / / /   / / / // /_/ / / /_  / /_/ / / /    
/____/  \__,_/  /_.___/ \__,_/   \____/ /_/ /_/ /_/ /_/   /_/ /_/ \__,_/  \__/  \____/ /_/     
                                                                                               

                     @RevoltSecurities


          
[DESCRIPTION]: Subdominator a passive subdomain enumeration that discovers subdomains for your targets using with passive and open source resources

[USAGE]: 

    subdominator [flags]
    
[FLAGS]: 

    [INPUT]: 
    
        -d,   --domain                  :  domain name to enumerate subdomains.
        -dL,  --domain-list             :  filename that contains domains for subdomain enumeration.
        stdout                          :  subdominator supports stdout to pipe its output
        
    [OUTPUT]: 
    
        -o,   --output                  :  filename to save the outputs.
        -oD,  --output-directory        :  directory name to save the outputs (use it when -dL is flag used).
        
    [OPTIMIZATION]: 
    
        -t,   --timeout                 : timeout value for every sources requests. 
    
    [Update]: 
    
        -up,   --update                 :  update subdominator for latest version but yaml source update required manual to not affect your api keys configurations.
        -duc, --disable-update-check    :  disable automatic update check for subdominator
        -sup, --show-updates            :  shows latest version updates of subdominator 
        
    [CONFIG]: 
    
        -nt,  --notify              :  send notification of found subdomain using source Slack, Pushbullet, Telegram, Discord
        -p,   --proxy               :  http proxy to use with subdominator (intended for debugging the performance of subdominator).
        -cp,  --config-path         :  custom path of config file for subdominator to read api keys ( default path: /home/sanjai/.config/Subdominator/provider-config.yaml)
        
    [DEBUG]: 
    
        -h,   --help                :  displays this help message and exits 
        -v,   --version             :  show current version of subdominator and latest version if available and exits
        -ske, --show-key-error      :  show keys error for out of credits and key not provided for particular sources
        -sre, --show-timeout-error  :  show timeout error for sources that are timeout to connect
        -nc,  --no-color            :  disable the colorised output of subdominator
        -ls,  --list-source         :  display the sources of subdominator uses for subdomain enumerations and exits (included for upcoming updates on sources).

Subdominator Integrations:

Subdominator integrates with various free and Paid API passive sources to gather valuable subdomain information. We would like to give credit to the following websites for providing free-to-obtain API keys for subdomain enumeration.
Claim your free API and Paid keys here:

Subdomains Resources:

• VirusTotal: VirusTotal
• Chaos: Chaos
• Dnsdumpter: Dnsdumpster
• Whoisxml: WhoisXML
• SecurityTrails: SecurityTrails
• Bevigil: Bevigil
• Binaryedge: BinaryEdge
• Fullhunt: Fullhunt
• Rapidapi: RapidAPI
• Bufferover: Bufferover
• Certspotter: Certspotter
• Censys: Censys
• Fullhunt: Fullhunt
• Zoomeye: Zoomeye
• Netlas: Netlas
• Leakix: Leakix
• Redhunt: Redhunt
• Shodan : Shodan
• Huntermap : Hunter
• Google: Google
• Facebook: Facebook
• Quake: Quake
• RapidFinder: RapidFinder
• RapidScan: RapidScan
• Fofa: Fofa
• CodeRog: CodeRog
• C99: C99
• RSECloud: RSECloud
• Myssl: Myssl
• Racent: Racent

Notification Resources:

• Slack: Slack
• Pushbullet: Pushbullet

Installation:

**Subdominator requires python latest version to be installed and with latest version pip commandline tool

pip install git+https://github.com/RevoltSecurities/Subdominator

Subdominator - Unleash the Power of Subdomain Enumeration

Subdominator is a powerful tool for passive subdomain enumeration during bug hunting and reconnaissance processes. It is designed to help researchers and cybersecurity professionals discover potential security vulnerabilities by efficiently enumerating subdomains some various free passive resources.

Features:

• fast and powerfull to enumerate subdomains.
• 35+ passive results to enumerate subdomains.
• configurable API keys setup
• Integrated notification system

Usage:

subdominator -h

                    __         __                       _                    __                
   _____  __  __   / /_   ____/ /  ____    ____ ___    (_)   ____   ____ _  / /_  ____    _____
  / ___/ / / / /  / __ \ / __  /  / __ \  / __ `__ \  / /   / __ \ / __ `/ / __/ / __ \  / ___/
 (__  ) / /_/ /  / /_/ // /_/ /  / /_/ / / / / / / / / /   / / / // /_/ / / /_  / /_/ / / /    
/____/  \__,_/  /_.___/ \__,_/   \____/ /_/ /_/ /_/ /_/   /_/ /_/ \__,_/  \__/  \____/ /_/     
                                                                                               

                     @RevoltSecurities


          
[DESCRIPTION]: Subdominator a passive subdomain enumeration that discovers subdomains for your targets using with passive and open source resources

[USAGE]: 

    subdominator [flags]
    
[FLAGS]: 

    [INPUT]: 
    
        -d,   --domain                  :  domain name to enumerate subdomains.
        -dL,  --domain-list             :  filename that contains domains for subdomain enumeration.
        stdout                          :  subdominator supports stdout to pipe its output
        
    [OUTPUT]: 
    
        -o,   --output                  :  filename to save the outputs.
        -oD,  --output-directory        :  directory name to save the outputs (use it when -dL is flag used).
        
    [OPTIMIZATION]: 
    
        -t,   --timeout                 : timeout value for every sources requests. 
    
    [Update]: 
    
        -up,   --update                 :  update subdominator for latest version but yaml source update required manual to not affect your api keys configurations.
        -duc, --disable-update-check    :  disable automatic update check for subdominator
        -sup, --show-updates            :  shows latest version updates of subdominator 
        
    [CONFIG]: 
    
        -nt,  --notify              :  send notification of found subdomain using source Slack, Pushbullet, Telegram, Discord
        -p,   --proxy               :  http proxy to use with subdominator (intended for debugging the performance of subdominator).
        -cp,  --config-path         :  custom path of config file for subdominator to read api keys ( default path: /home/sanjai/.config/Subdominator/provider-config.yaml)
        
    [DEBUG]: 
    
        -h,   --help                :  displays this help message and exits 
        -v,   --version             :  show current version of subdominator and latest version if available and exits
        -ske, --show-key-error      :  show keys error for out of credits and key not provided for particular sources
        -sre, --show-timeout-error  :  show timeout error for sources that are timeout to connect
        -nc,  --no-color            :  disable the colorised output of subdominator
        -ls,  --list-source         :  display the sources of subdominator uses for subdomain enumerations and exits (included for upcoming updates on sources).

Subdominator Integrations:

Subdominator integrates with various free API passive sources to gather valuable subdomain information. We would like to give credit to the following websites for providing free-to-obtain API keys for subdomain enumeration.
Claim your free API keys here:
Subdomains Resources:

• VirusTotal: VirusTotal
• Chaos: Chaos
• Dnsdumpter: Dnsdumpster
• Whoisxml: WhoisXML
• SecurityTrails: SecurityTrails
• Bevigil: Bevigil
• Binaryedge: BinaryEdge
• Fullhunt: Fullhunt
• Rapidapi: RapidAPI
• Bufferover: Bufferover
• Certspotter: Certspotter
• Censys: Censys
• Fullhunt: Fullhunt
• Zoomeye: Zoomeye
• Netlas: Netlas
• Leakix: Leakix
• Redhunt: Redhunt
• Shodan : Shodan
• Huntermap : Hunter
• Google: Google
• Facebook: Facebook
• Quake: Quake
• RapidFinder: RapidFinder
• RapidScan: RapidScan

Notification Resources:

• Slack: Slack
• Pushbullet: Pushbullet

Installation:

**Subdominator requires python latest version to be installed and with latest version pip commandline tool

pip install git+https://github.com/RevoltSecurities/Subdominator

Subdominator New Verision updates:

• New version of subdominator concurrency are improved
• Subdominator notification results are enhanced and improved
• Subdominator OSINT mode will give more and better than previous versions
• Installation errors and Bugs are patched
• Subdominator supports oneliners

Install New version by pip:

 pip install git+https://github.com/sanjai-AK47/Subdominator.git

INFO: If you are installing subdominator for first time means install it will config_keys.yaml file by git clone then install with pip

Subdominator v1.0.5 Release Notes

We are excited to announce the latest release of Subdominator v1.0.5, packed with new features, bug fixes, and improvements. Subdominator is now more powerful, versatile, and easier to use than ever before.

What's New:

• Shodan and Hunter: Subdominator now supports Shodan and HunterHow API service, expanding the range of tools available for subdomain enumeration and analysis. Harness the power of Redhunt alongside other APIs for comprehensive domain reconnaissance.

• Increased Concurrency: We've optimized Subdominator for faster subdomain enumeration. With increased concurrency, you can discover subdomains more efficiently, making your penetration testing workflows even smoother.

• Bug Fixes and Logical Improvements: We've squashed pesky bugs and refined the logic under the hood. Subdominator is now more reliable and accurate, ensuring you get the results you need.

• Improved Recursion for Unique Wildcards: Subdominator's recursion algorithm for unique wildcards has been enhanced. Discover even more hidden subdomains with our improved recursive scanning.

• Python Package: Subdominator is now available as a Python package! Installing and upgrading Subdominator is a breeze on any operating system. Run Subdominator anywhere, anytime, without hassle.

About the Author:

Hi Im D.Sanjai Kumar the developer for Subdominator and Im a web pentester and an API penetration tester and open source tool developer
if you have any issues related to subdominator please submit an issues. Thank you!
Getting Started:

To get started with Subdominator v1.0.4, simply visit the official GitHub repository: Subdominator GitHub Repo

How to Install:

Method 1

pip install subdominator
subdominator -h

copy the configuration yaml file from github if you are new user to subdominator
Dont worry if any installation failed and there is another method is there for you guys or you run the subdominator script as previous version!

git clone https://github.com/sanjai-AK47/Subdominator.git
pip install .
subdominator -h

After a successfull installtions configure your yaml file you can simply see here how to
add new integration in the config_keys.yaml with my Instructions and some changes also done is services like Censys,Zoomeye-auth,Dnsdumpster and etc.. which breaks the limitations of api keys of Subdominator which makes it better than previous versions

Thank you for using Subdominator, and happy hacking! 🚀

Subdominator v1.0.4 Release Notes

We are excited to announce the latest release of Subdominator v1.0.4, packed with new features, bug fixes, and improvements. Subdominator is now more powerful, versatile, and easier to use than ever before.

What's New:

• Redhunt API Integration: Subdominator now supports Redhunt API service, expanding the range of tools available for subdomain enumeration and analysis. Harness the power of Redhunt alongside other APIs for comprehensive domain reconnaissance.

• Increased Concurrency: We've optimized Subdominator for faster subdomain enumeration. With increased concurrency, you can discover subdomains more efficiently, making your penetration testing workflows even smoother.

• Bug Fixes and Logical Improvements: We've squashed pesky bugs and refined the logic under the hood. Subdominator is now more reliable and accurate, ensuring you get the results you need.

• Improved Recursion for Unique Wildcards: Subdominator's recursion algorithm for unique wildcards has been enhanced. Discover even more hidden subdomains with our improved recursive scanning.

• Python Package: Subdominator is now available as a Python package! Installing and upgrading Subdominator is a breeze on any operating system. Run Subdominator anywhere, anytime, without hassle.

About the Author:

Hi Im D.Sanjai Kumar the developer for Subdominator and Im a web pentester and an API penetration tester and open source tool developer
if you have any issues related to subdominator please submit an issues. Thank you!
Getting Started:

To get started with Subdominator v1.0.4, simply visit the official GitHub repository: Subdominator GitHub Repo

How to Install:

Method 1

git clone https://github.com/sanjai-AK47/Subdominator.git
pip install subdominator
subdominator -h

Dont worry if any installation failed and there is another method is there for you guys or you run the subdominator script as previous version!

git clone https://github.com/sanjai-AK47/Subdominator.git
pip install .
subdominator -h

After a successfull installtions configure your yaml file you can simply see here how to
add new integration in the config_keys.yaml with my Instructions and some changes also done is services like Censys,Zoomeye-auth,Dnsdumpster and etc.. which breaks the limitations of api keys of Subdominator which makes it better than previous versions

Thank you for using Subdominator, and happy hacking! 🚀

.

Subdominator V1.0.3 Release Notes

We're excited to introduce Subdominator V1.0.3, packed with new features and improvements to enhance your subdomain enumeration experience. In this release, we've focused on expanding your capabilities, making it easier to manage API keys, and improving the overall workflow.

New Features:

1. Expanded API Key Management

Subdominator now allows you to store an unlimited number of API keys for various services in a YAML configuration file. This makes it convenient to switch between different API keys and ensures that you have the flexibility to use the APIs you prefer.

# Example YAML Configuration for API Keys
Virustotal: #Unlimited keys
  - # Your VirusTotal API keys here
Chaos: #Unlimited or Limited keys (Your choice)
  - # Your Chaos API keys here
# ... (and so on for other services)

2. Recursive Enumeration for Wildcards

With the recursive enumeration feature, Subdominator can now identify wildcards in the discovered subdomains and perform additional enumeration to uncover even more subdomains. This advanced functionality helps you get a more comprehensive list of subdomains.

3. Subdomain Enumeration from a List of Domains

You can now provide a file containing a list of domains to Subdominator, and it will efficiently enumerate subdomains for each domain in the list. This is particularly useful when you want to gather subdomains for multiple domains in one go.

4. Notification Integration

Subdominator now includes a notification feature that can send notifications to your PC or mobile device when the subdomain enumeration process is complete. Stay informed about the progress and results of your scans without constantly monitoring the terminal.

How to Use:

Subdominator V1.0.3 introduces new command-line options to access these features:

• -d DOMAIN or --domain DOMAIN: Specify a single domain to find subdomains.
• -dL DOMAINS_LIST or --domains-list DOMAINS_LIST: Provide a file containing a list of domains to find subdomains for multiple domains.
• -nt or --notify: Enable push notifications to stay updated on scan progress.
• -r or --recursive: Activate recursive enumeration for wildcards.
• -cf or --config: Use the configured API keys from the YAML file.
• -o OUTPUT or --output OUTPUT: Specify the output filename to save the results.

Upgrade Now:

Don't miss out on the enhanced capabilities of Subdominator V1.0.3. Upgrade now and take advantage of these new features to improve your subdomain enumeration workflow.

Thank you for using Subdominator, and happy hacking! 🚀

Feel free to customize and expand this release note to suit your needs.

Subdominator v1.0.1 Release

We are excited to announce the release of Subdominator v1.0.1! This version brings significant enhancements to subdomain enumeration, including integration with more API keys that are available for free. With these additional API keys, Subdominator can now discover even more subdomains, expanding your reconnaissance capabilities.

What's New

• More API Keys: In this release, we have integrated additional API keys that are freely available, enabling Subdominator to access a wider range of data sources. This means more comprehensive subdomain enumeration and increased coverage of your target domains.

• Linux Executable: We have introduced a new Linux executable file that allows you to run Subdominator without requiring Python to be installed. Simply execute the Linux binary, and Subdominator will automatically detect and load the config_keys.yaml file for seamless subdomain enumeration.

• Enhanced Usability: Subdominator now offers improved usability by allowing users to run the Python script (subdominator.py) or the Linux executable (subdominator) from any directory. The tool will automatically locate and utilize the config_keys.yaml file, simplifying the setup process.

Getting Started

To get started with Subdominator v1.0.1, follow these steps:

1. Download the Release: Visit the Releases page and download the latest release (SubdominatorV1.0.1.zip).

2. Extract Files: Extract the downloaded ZIP file to your desired location.

3. Run Subdominator:

   • Python Script: If you prefer to run the Python script, navigate to the extracted directory and execute the following command:

     python subdominator.py --help

   • Linux Executable: If you prefer to use the Linux executable, navigate to the extracted directory and execute the following command:

     ./subdominator --help

4. Automatic Configuration: Subdominator will automatically detect and load the config_keys.yaml file located in the same directory. Ensure that you have added your API keys to the config_keys.yaml file for seamless subdomain enumeration.

Upgrade Notes

• If you are upgrading from a previous version of Subdominator, simply replace the existing files with those from the new release.

Feedback and Contributions

We value your feedback and contributions to Subdominator. If you encounter any issues, have suggestions for improvements, or want to contribute, please open an issue or pull request on GitHub.

Thank you for choosing Subdominator for your subdomain enumeration needs. Happy hacking!

• The Subdominator Creator

We are excited to announce the first official release of Subdominator - a powerful and versatile tool for passive subdomain enumeration in bug hunting and reconnaissance processes.

Version v1.0.0 introduces the following features:

Passive subdomain enumeration using popular APIs like VirusTotal, DnsDump, and SecurityTrails.

DNS data extraction and subdomain enumeration with WhoisXML and RapidAPI integration.

Improved performance and enhanced stability.

Stay tuned for future updates as we continue to enhance Subdominator with even more powerful features and improvements. Happy bug hunting!

If any Bug or Errors in Subdominator you can inform us!

Follow us on GitHub for the latest updates and bug fixes: Subdominator