routersploit README

The project's README from github.com/threat9/routersploit. As one markdown file: README.md.

RouterSploit - Exploitation Framework for Embedded Devices

Python 3.6 Build Status

Community

Join community on Embedded Exploitation Discord.

Description

The RouterSploit Framework is an open-source exploitation framework dedicated to embedded devices.

asciicast

It consists of various modules that aid penetration testing operations:

Installation

Requirements

Required:

Optional:

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 compose up --build -d
docker attach routersploit

To run again without rebuild

docker start routersploit
docker attach routersploit

Update

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

cd routersploit
git pull

Build your own

To our surprise, people started to fork routersploit not because they were interested in the security of embedded devices but simply because they want to leverage our interactive shell logic and build their tools using similar concept. All these years they must have said: "There must be a better way!" and they were completely right, the better way is called Riposte.

Riposte allows you to easily wrap your application inside a tailored interactive shell. Common chores regarding building REPLs was factored out and being taken care of so you can focus on specific domain logic of your application.

License

The RouterSploit Framework is under a BSD license. Please see LICENSE for more details.

Acknowledgments

routersploit (threat9/routersploit)

Searching Database…

13.3K ·GitHub
Routersploit
Что это такое?RouterSploit — это фреймворк для эксплуатации уязвимостей с открытым исходным кодом, созданный специально для проверки безопасности встраиваемых устройств, например маршрутизаторов.
Это один инструмент для эксплуатации или модульный фреймворк?Это модульный фреймворк, разделённый на типы модулей: exploits для известных уязвимостей, creds для проверки учётных данных, scanners для проверки наличия уязвимостей, payloads для генерации полезной нагрузки под конкретные архитектуры и общие модули атак.
Как установить и запустить RouterSploit?Выполните шаги для вашей ОС из README: для Kali Linux, Ubuntu 20.04, Ubuntu 18.04/17.10 или OSX, либо запустите его сразу из готового образа Docker без ручной сборки.
Что нужно установить перед запуском?Нужен Python с библиотеками requests, paramiko, pysnmp и pycrypto; необязательный пакет bluepy добавляет поддержку модулей Bluetooth Low Energy.
Работает ли это на Windows?В README описана установка только для Kali Linux, Ubuntu и OSX или через Docker; способа нативной установки под Windows там не описано.
Почему люди делали форки routersploit вместо того, чтобы писать свои инструменты?Многим форкам было вовсе не интересно безопасность роутеров, им нужна была логика интерактивной оболочки RouterSploit. Поэтому авторы вынесли эту логику в отдельную библиотеку.
Что такое Riposte?Riposte — это вспомогательная библиотека, выделенная из RouterSploit. Она позволяет обернуть любое приложение в собственную интерактивную оболочку, беря на себя типовую работу REPL, чтобы вы могли сосредоточиться на логике своей предметной области.
Может ли RouterSploit тестировать устройства с Bluetooth Low Energy?Да, установка необязательной зависимости bluepy включает поддержку Bluetooth Low Energy для соответствующих модулей.
What are similar projects?masscan, fscan, bbot, nikto, thc-hydra, Claude-Red, evilginx2, ProxyBridge
Which topics is it in?bruteforce, credentials, scanner, router, infosec, exploit, network-security, iot, penetration-testing, embedded, bsd, security-tools
Creator
threat9
Size
1.9 MB
Stars
13.3K
Updated
CommitMay 05Releasev3.4.0Oct 17
Age
10y
Commits · 90 Days