RouterSploit: Exploitation Framework for Embedded Devices

Python 3.6 Build Status

The RouterSploit Framework is an open-source exploitation framework dedicated to embedded devices. It consists of various modules that aid penetration testing operations:

• Exploits - modules that take advantage of identified vulnerabilities
• Creds - modules designed to test credentials against network services
• Scanners - modules that check if a target is vulnerable to any exploit
• Payloads - modules that are responsible for generating payloads for various architectures and injection points
• Generic - modules that perform generic attacks

Installation

Requirements

Required:

• future
• requests
• paramiko
• pysnmp
• pycrypto

Optional:

• bluepy - Bluetooth low energy

Installation on Kali Linux

$ apt-get install python3-pip

$ git clone https://www.github.com/threat9/routersploit

$ cd routersploit

$ python3 -m pip install -r requirements.txt

$ python3 rsf.py

Bluetooth Low Energy support:

$ apt-get install libglib2.0-dev

$ python3 -m pip install bluepy

$ python3 rsf.py

Installation on Ubuntu 20.04

$ sudo apt-get install git python3-pip

$ git clone https://github.com/threat9/routersploit

$ cd routersploit

$ python3 -m pip install -r requirements.txt

$ python3 rsf.py

Bluetooth Low Energy support:

$ sudo apt-get install libglib2.0-dev

$ python3 -m pip install bluepy

$ python3 rsf.py

Installation on Ubuntu 18.04 & 17.10

$ sudo add-apt-repository universe

$ sudo apt-get install git python3-pip

$ git clone https://www.github.com/threat9/routersploit

$ cd routersploit

$ python3 -m pip install setuptools

$ python3 -m pip install -r requirements.txt

$ python3 rsf.py

Bluetooth Low Energy support:

$ apt-get install libglib2.0-dev

$ python3 -m pip install bluepy

$ python3 rsf.py

Installation on OSX

$ git clone https://www.github.com/threat9/routersploit

$ cd routersploit

$ sudo python3 -m pip install -r requirements.txt

$ python3 rsf.py

Running on Docker

$ git clone https://www.github.com/threat9/routersploit

$ cd routersploit

$ docker build -t routersploit .

$ docker run -it --rm routersploit

Update

Update RouterSploit Framework often. The project is under heavy development and new modules are shipped almost every day.

$ cd routersploit

$ git pull

Disclaimer

Disclaimer: This tool is intended for educational and ethical purposes only. Misuse of RouterSploit may result in criminal charges and penalties. Ensure you have proper authorization before engaging in any penetration testing activities. The authors and contributors are not responsible for any misuse or damage caused by this tool.