Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
RevoltSecurities authored Feb 8, 2024
1 parent 0296dbb commit 96ff153
Showing 1 changed file with 61 additions and 50 deletions.
111 changes: 61 additions & 50 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,29 +1,21 @@
# Dnsbruter - Active Subdomain Enumeration Tool
# Dnsbruter - Asynchornous Dns Bruteforcing Tool

Dnsbruter is a command-line tool designed for active subdomain enumeration through brute-forcing techniques. It helps security researchers and penetration testers discover potential subdomains for a given target domain. The tool allows users to customize their search and provides options for saving and displaying results.

### V1.0.2 features:

## New Features
- Asynchronous and concurrent bruteforcing
- Manages high level threads and wordlists
- Improved performance and usages in commands of dnsbruter
- User desired console for outputs

Dnsbruter comes with the following features:
### Installation

- Define the number of threads to use for faster processing.
- Define the concurrency for multiple processing for brutforcing subdomains
- User desired verbose and concise mode to print valid
- Main focued in concurrecy for brutforcing the subdomains
- Able to save output Whether its a directory or text file
- User defined wordlist or built-in wordlist provided for brutforcing subdomains
- Dnsbruter works like NSE script of [nmap](https://nmap.org/nsedoc/scripts/dns-brute.html) to find subdomains by brutforcing

## Installation

### ALL Users

### Method 1:

```bash
pip install dnsbruter

pip install git+https://github.com/sanjai-AK47/Dnsbruter.git
dnsbruter -h
```

Expand All @@ -40,40 +32,59 @@ Dnsbruter comes with the following features:

To start using Dnsbruter, use the following command-line options:

```bash
dnsbruter -h
usage: dnsbruter [-h] [-d DOMAIN] [-w WORDLIST] [-o OUTPUT] [-v] [-cn Concise] [-t THREADS] [-C CONCURRENCY]

[INFO]: Discover hidden subdomains effortlessly with Dnsbruter

options:
-h, --help show this help message and exit
-d DOMAIN, --domain DOMAIN
[INFO]: Target name to find hidden subdomains
-w WORDLIST, --wordlist WORDLIST
[INFO]: Wordlist that contains a list of subdomains for bruteforcing
-o OUTPUT, --output OUTPUT
[INFO]: Filename to save the output
-v, --verbose [INFO]: Verbose mode will print the valid subdomains that found
-cn, --concise [INFO]: Concise mode will print the invalid subdomains that found
-t THREADS, --threads THREADS
[INFO]: Thread level for Multiple Threads
-C CONCURRENCY, --concurrency CONCURRENCY
[INFO]: Concurrency level for Concurrency Process
```yaml
dnsbruter -h
___ ___ _
/ \ _ __ ___ / __\ _ __ _ _ | |_ ___ _ __
/ /\ /| '_ \ / __| /__\//| '__|| | | || __| / _ \| '__|
/ /_// | | | |\__ \/ \/ \| | | |_| || |_ | __/| |
/___,' |_| |_||___/\_____/|_| \__,_| \__| \___||_|



Author : D.SanjaiKumar @CyberRevoltSecurities

[Version]: Dnsbruter current version v1.0.2 (latest)

[DESCRIPTION]: Dnsbruter is a powerfull tool for dns brutforcing concurrently

[Usage]:

Dnsbruter [options]

[OPTIONS]:

[INPUT]:

-d , --domain string : Domain name for resolving subdomains.

-w , --wordlist string : Wordlist path for Dnsbruter.


[RATE-LIMIT]:

-c , --concurrency int : Concurrency value for scans.

-rt , --rate-limit int : Rate limit value for sending packets to port scans.

[UPDATES]:

-up , --updates command : Updates the Dnsbruter for larest version (required: pip to be installed)

[OUTPUT]:

-o , --output string : Filename to save the scans outputs.


[DEBUG]:

-vr , --version command : Shows Version of the Dnsbruter and exits:

-nc , --no-color command : Disable the Dnsbruter's colorised CLI outputs and info.

-s , --silent command : Only shows outputs and avoid other info.

```

**Example:**


![Screenshot from 2023-10-01 23-12-08](https://github.com/sanjai-AK47/Dnsbruter/assets/119435129/29a1da5a-30a2-4f98-9f50-9768989fd112)

```bash
dnsbruter --domain google.com --output output.txt --verbose --threads 50 --concurrency 5 --wordlist /path/to/wordlists
```

This command is recommonded for all and will perform perfect active subdomain enumeration on the `google.com` domain using 50 threads + 5 concurrecy multiprocessing, save the results to `output.txt`, display found and valid domains in verbose mode, and print invalid domains during the enumeration process if the concise mode is enabled

Show you love ❤️ and give ⭐ for [Dnsbruter](https://github.com/sanjai-AK47/Dnsbruter)

We hope this tool proves useful for your subdomain enumeration needs. Happy hacking! :rocket:
**INFO:** Dnsbruter is very high in concurrent but high threads causes high loads I recommend use a range of 50-300 for your resolving or the choice is up to you, Dnsbruter is a userfriendly tool and gives good performance, I hope the project
helps in your recon part if you like this project then give a ⭐ to show your support on it.

0 comments on commit 96ff153

Please sign in to comment.