pathbuster

A path-normalization pentesting tool

Todos • Installation • Usage • Examples • Contributing • License • Join Discord

Todos

• [x] Implement --filter-status which will filter the status codes.
• [x] Implement --filter-body-size which will filter the response sizes.

  - [x] Implement --drop-after-fail which will ignore requests with the same response code multiple times in a row.

Installation

Install rust

bash curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Install pathbuster

bash cargo install pathbuster

Usage

bash pathbuster -h

This command will show the tool's help information and present a list of all the switches that are available.

``` USAGE: pathbuster [OPTIONS] --urls --payloads --wordlist

OPTIONS: -c, --concurrency The amount of concurrent requests [default: 1000]

    --drop-after-fail <drop-after-fail>
        ignore requests with the same response code multiple times in a row [default: 302,301]

    --filter-body-size <filter-body-size>
        [default: 0]

    --filter-status <filter-status>
        [default: 302,301]

-h, --help
        Print help information

    --match-status <match-status>
        [default: 400]

-o, --out <out>
        The output file

    --payloads <payloads>
        the file containing the traversal payloads [default: ./payloads/traversals.txt]

-r, --rate <rate>
        Maximum in-flight requests per second [default: 1000]

-u, --urls <urls>
        the url you would like to test

-v, --verbose <verbose>
        The amount of workers [default: false]

-V, --version
        Print version information

-w, --workers <workers>
        The amount of workers [default: 1]

    --wordlist <wordlist>
        the file containing the wordlist for discovery [default: ./wordlists/wordlist.txt]

```

Flags

| Flag | Description | | ----------------- | ------------------------------------------------------------------ | | --urls | the file containing the urls to test make sure it contains a path | --payloads | file containing the payloads to test | | --wordlist | file containing the technology wordlist | | --match-status | status code used to match internal responses | | --filter-body-size | used to filter the response body like ffuf | | --filter-status | used to filter the response status code like ffuf | | --drop-after-fail | specify a status code to ignore if it reoccurs more than 5 times in a row | | --rate | used set the maximum in-flight requests per second | | --workers | number of workers to process the jobs | | --concurrency | number of threads to be used for processing | | --verbose | prints everything | | --out | save output to a file | | --help | prints help information | | --version | prints version information |

Examples

Usage:

rust $ pathbuster --urls crawls.txt --payloads traversals.txt --wordlist raft-medium-directories.txt -o output.txt

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

Pathbuster is distributed under MIT License