rustpad

build status shield uses Rust shield license shield

asciinema example run

🔪🏛️ A multi-threaded what now?

rustpad is a multi-threaded successor to the classic padbuster, written in Rust. It abuses a Padding Oracle vulnerability to decrypt any cypher text or encrypt arbitrary plain text without knowing the encryption key!

🦀💻 Features

🗒️🤔 Usage

Using rustpad to attack a padding oracle is easy. It requires only 4 pieces of information to start: - target oracle (--oracle) - cypher text to decrypt (--decrypt) - block size (--block-size) - type of oracle (web/script, see below)

```log ; rustpad --help rustpad Multi-threaded Padding Oracle attacks against any service.

USAGE: rustpad [OPTIONS] --block-size --decrypt --oracle

OPTIONS: -B, --block-size Block size used by the cypher [possible values: 8, 16]

-D, --decrypt <decrypt>
        Original cypher text, received from the target service, which is to be decrypted

-E, --encrypt <encrypt>
        Plain text to encrypt. Encryption mode requires a cypher text to gather necessary data

-h, --help
        Prints help information

-n, --no-iv
        Cypher text does not include an Initialisation Vector

-O, --oracle <oracle>
        The oracle to question with forged cypher texts. This can be a URL or a shell script.
        See the subcommands `web --help` and `script --help` respectively for further help.
-V, --version
        Prints version information

-v, --verbose
        Increase verbosity of logging

SUBCOMMANDS: web Question a web-based oracle script Question a script-based oracle ```

Web mode

Web mode specifies that the oracle is located on the web. In other words, the oracle is a web server with a URL.

For a padding oracle attack to succeed, an oracle must say so if a cypher text with incorrect padding was provided. rustpad will analyse the oracle's responses and automatically calibrate itself to the oracle's behaviour.

```log ; rustpad web --help rustpad-web Question a web-based oracle

USAGE: rustpad --block-size --decrypt --oracle web [OPTIONS]

OPTIONS: -c, --consider-body Consider the response body and content length when determining the web oracle's response to (in)correct padding

-d, --data <data>
        Data to send in a POST request

-h, --help
        Prints help information

-H, --header <header>...
        HTTP header to send

-k, --insecure
        Disable TLS certificate validation

-K, --keyword <keyword>
        Keyword indicating the location of the cypher text in the HTTP request. It is replaced by the cypher text's value at runtime [default: CTEXT]

-n, --no-iv
        Cypher text does not include an Initialisation Vector

-r, --redirect
        Follow 302 Redirects

-A, --user-agent <user_agent>
        User-agent to identify with [default: rustpad/<version>]

-v, --verbose
        Increase verbosity of logging

Indicate the cypher text's location! See --keyword for clarification. ```

Script mode

Script mode was made for power users ~~or CTF players 🏴‍☠️ who were given a script to run~~. The target oracle is a local shell script.

Scripts allow you to run attacks against local oracles or more exotic services. Or you can use script mode to customise and extend rustpad's features. However, if you're missing a feature, feel free to open an issue on GitHub!

```log ; rustpad script --help rustpad-script Question a script-based oracle

USAGE: rustpad --block-size --decrypt --oracle script [OPTIONS]

OPTIONS: -h, --help Prints help information

-n, --no-iv
        Cypher text does not include an Initialisation Vector

-v, --verbose
        Increase verbosity of logging

Script must respond with exit code 0 for correct padding, and any other code otherwise. Cypher text is passed as the 1st argument. ```

🕥💤 Coming soon