ronin

• Сайт
• Исходный код
• Проблемы
• Документация
• Discord | Mastodon

Описание

Ronin — это бесплатный набор инструментов с открытым исходным кодом на Ruby для исследований и разработок в области безопасности. Ronin содержит множество различных команд CLI и библиотек Ruby для разнообразных задач безопасности, таких как кодирование/декодирование данных, фильтрация IP-адресов/хостов/URL-адресов, запросы ASN, запросы DNS, HTTP, сканирование веб-уязвимостей, обход веб-сайтов, установка сторонних репозиториев с эксплойтами и/или полезными нагрузками, запуск эксплойтов, разработка новых эксплойтов, управление локальными базами данных, фазинг данных, проведение разведки и многое другое.

Для кого Ronin?

• Игроки CTF
• Охотники за багами
• Исследователи безопасности
• Инженеры по безопасности
• Разработчики
• Студенты

Что предоставляет Ronin?

• Набор полезных команд.
• Полнофункциональную Ruby REPL.
• Экосистему высококачественных библиотек Ruby, API и команд, связанных с безопасностью.
• Легковесный локальный веб-интерфейс.

Что можно сделать с помощью Ronin?

• Быстро обрабатывать и запрашивать различные данные с помощью команд ronin.
• Эффективно работать с кодом и данными в Ruby REPL ronin irb.
• Быстро создавать прототипы скриптов на Ruby с помощью ronin-support и других библиотек ronin.
• Устанавливать сторонние git-репозитории эксплойтов, полезных нагрузок или другого кода с помощью ronin-repos.
• Импортировать и запрашивать данные с помощью базы данных ronin-db.
• Фазить данные с помощью ronin-fuzzer.
• Проводить разведку с помощью ronin-recon.
• Использовать распространённые полезные нагрузки или писать собственные с помощью ronin-payloads.
• Писать и запускать эксплойты с помощью ronin-exploits.
• Сканировать веб-уязвимости с помощью ronin-vulns.
• Выполнять сканирование и просматривать базу данных в браузере с помощью ronin-app.

Краткий обзор```

Usage: ronin [options] [COMMAND [ARGS...]]

Options: -h, --help Print help information

Arguments: [COMMAND] The command name to run [ARGS ...] Additional arguments for the command

Commands: archive asn banner-grab bitflip cert-dump cert-gen cert-grab completion decode, dec decrypt dns dns-proxy email-addr encode, enc encrypt entropy escape extract grep help hexdump highlight hmac homoglyph host http ip iprange irb md5 netcat, nc new pack proxy public-suffix-list quote rot sha1 sha256 sha512 strings tld-list tips typo typosquat unarchive unescape unhexdump unpack unquote url xor

Additional Ronin Commands: $ ronin-repos $ ronin-wordlists $ ronin-db $ ronin-web $ ronin-fuzzer $ ronin-masscan $ ronin-nmap $ ronin-recon $ ronin-payloads $ ronin-exploits $ ronin-vulns $ ronin-app

Список команд ronin:```shell
$ ronin help

Просмотреть man-страницу для команды:```shell $ ronin help COMMAND

Получить случайный совет по использованию `ronin`:```shell
$ ronin tips

Откройте Ronin Ruby REPL:``` $ ronin irb , Jµ ▓▓█▓ J▌ ▐▓██▌ ████ ██ ▐███D ╓▄▓▓█████▌ ██µ ████ ▄███ÖJ██▌ ███▌ ,╓µ▄▄▄▄▄▄▄▄µ;, ,▄▓██████████ ▐███ ▐███▀ ███▌ ████µ ▄███ ¬∞MÆ▓███████████████████████▓M ▄██████▀▀╙████▌ ████▌ ████ ▄███ J█████ ███▌ █████▀▀▀▀▀███████ -████▀└ ████ ▐█████n ▄███O ███▌ ██████████ ▓████L ████▀ ▓████ ▓███Ö ███████ ███▌ ▓███ ▐█████████▀ ▄████▀ ,╓▄▄▄█████ J████Ü ,███▌ ▄███████████ J███▀ ████ █████ J█████████████████─ ████▌ ████ ██████████▌ ████ ▐███Ü ▐███Ü ███████████▀▀▀╙└ ▐████ J███▌ ▓███▌ ²█████ J███Ü ███▌ ▀█▌ ▓██████████▌ ████▌ ████ ;████ ▀███▀ ███▌ J▀▀▀- █ ▄█████▀ ▀█████µ ▐████ ,▄▓████▀ ████▀ ███ J███ ` J█████- ╙▀███▄ ████████████▀╙ J█▀▀▀ █U ▀█▌ ████▀ ▀███ ▄████████▀▀ ╨ █ ▓██▀ ²▀█▄ █▀▀▀╙└ ▄██╜ ╙W J█▀ ▌└ ┘

irb(ronin)>

Запускает и открывает интерактивный веб-интерфейс для Ronin:```
$ ronin-app

Бинарный

Создает дамп данных в шестнадцатеричном виде в различных форматах:```shell $ ronin hexdump /bin/ls

Преобразует файл с hex-дампом обратно в исходные необработанные двоичные данные:```shell
$ ronin unhexdump -o data.bin hexdump.txt

Вывести все печатные строки из файла:```shell $ ronin strings /bin/ls

Вывести все буквенные строки из файла:```shell
$ ronin strings --alpha /bin/ls

Вывести все буквенно-цифровые строки из файла:```shell $ ronin strings --alpha-num /bin/ls

Вывести все числовые строки из файла:```shell
$ ronin strings --numeric /bin/ls

Вывести все шестнадцатеричные строки из файла:```shell $ ronin strings --hex /bin/ls

Перечислить все Bit-flips доменного имени:```shell
$ ronin bitflip microsoft --alpha-num --append .com
licrosoft.com
oicrosoft.com
iicrosoft.com
eicrosoft.com
Microsoft.com
mhcrosoft.com
mkcrosoft.com
mmcrosoft.com
macrosoft.com
mycrosoft.com
...

Кодирование

Base64 кодирование строки:```shell $ ronin encode --base64 --string "foo bar baz" Zm9vIGJhciBiYXo=

Zlib сжимает, кодирует в Base64, а затем URI-кодирует строку:```shell
$ ronin encode --zlib --base64 --uri --string "foo bar"
%65%4A%78%4C%79%38%39%58%53%45%6F%73%41%67%41%4B%63%41%4B%61%0A

Декодировать строку Base64:```shell $ ronin decode --base64 --string "Zm9vIGJhciBiYXo=" foo bar baz

Декодирует URI, декодирует Base64, а затем распаковывает строку с помощью zlib:```shell
$ ronin decode --uri --base64 --zlib --string "%65%4A%78%4C%79%38%39%58%53%45%6F%73%41%67%41%4B%63%41%4B%61%0A"
foo bar

Экранирование URI строки:```shell $ ronin escape --uri --string "foo bar" foo%20bar

Раскодировать URI строку:```shell
$ ronin unescape --uri --string "foo%20bar"
foo bar

Преобразовать файл в C-строку с кавычками:```shell $ ronin quote --c file.bin "..."

Преобразовать файл в строку JavaScript в кавычках:```shell
$ ronin quote --js file.bin

Расквотировать строку C:```shell $ ronin unquote --c --string '"\x66\x6f\x6f\x20\x62\x61\x72"' foo bar

### Текст

Извлечение данных с высокой энтропией из файла:```shell
$ ronin entropy -e 5.0 index.html

Grep для поиска общих шаблонов данных:```shell $ ronin grep --hash index.html

Извлечение общих шаблонов из данных:```shell
$ ronin extract --hash index.html

Сгенерировать случайную опечатку слова:```shell $ ronin typo microsoft microssoft

Перебор всех вариантов опечаток слова:```shell
$ ronin typo --enum microsoft
microosoft
microsooft
microssoft

Сгенерируйте случайную гомоглифическую версию слова:```shell $ ronin homoglyph CEO CＥO

Перечислить все гомоглифные вариации слова:```shell
$ ronin homoglyph --enum CEO
ϹEO
СEO
ⅭEO
ＣEO
CΕO
CЕO
CＥO
CEΟ
CEО
CEＯ

Подсвечивает синтаксис файла:```shell $ ronin highlight index.html

### Криптография

AES-256 зашифровать файл:```shell
$ ronin encrypt --cipher aes-256-cbc --password "..." file.txt > encrypted.bin

Расшифровать данные:```shell $ ronin decrypt --cipher aes-256-cbc --password "..." encrypted.bin

Генерирует HMAC для файла:```shell
$ ronin hmac --hash sha1 --password "too many secrets" data.txt

Генерирует HMAC для строки:```shell $ ronin hmac --hash sha1 --password "too many secrets" --string "..."

Вычислить MD5-контрольную сумму строки:```shell
$ ronin md5 --string "hello world"
5eb63bbbe01eeed093cb22bb8f5acdc3

Вычислить MD5-контрольную сумму файла:```shell $ ronin md5 file.txt

Вычислите MD5-контрольную сумму каждой строки в файле:```shell
$ ronin md5 --multiline file.txt

Вычислить контрольную сумму SHA1 строки:```shell $ ronin sha1 --string "hello world" 2aae6c35c94fcfb415dbe95f408b9ce91ee846ed

Вычислите SHA1-контрольную сумму файла:```shell
$ ronin sha1 file.txt

Вычислить контрольную сумму SHA1 для каждой строки в файле:```shell $ ronin sha1 --multiline file.txt

Вычислить SHA256 контрольную сумму строки:```shell
$ ronin sha256 --string "hello world"
b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9

Вычислить контрольную сумму SHA256 файла:```shell $ ronin sha256 file.txt

Вычислите контрольную сумму SHA256 каждой строки в файле:```shell
$ ronin sha256 --multiline file.txt

Вычислить контрольную сумму SHA512 для строки:```shell $ ronin sha512 --string "hello world" 309ecc489c12d6eb4cc40f50c902f2b4d0ed77ee511a7c7a9bcd3ca86d4cd86f989dd35bc5ff499670da34255b45b0cfd830e81f605dcf7dc5542e93ae9cd76f

Вычислите контрольную сумму SHA512 файла:```shell
$ ronin sha512 file.txt

Вычислите SHA512 контрольную сумму для каждой строки в файле:```shell $ ronin sha512 --multiline file.txt

ROT-13 кодирует строку:```shell
$ ronin rot --string "The quick brown fox jumps over the lazy dog"
Gur dhvpx oebja sbk whzcf bire gur ynml qbt

XOR-кодирует строку:```shell $ ronin xor --key ABC --string "The quick brown fox jumps over the lazy dog" "\x15*&a36(!(a 1.5-a$,9b)4/32b,7'1a6+$b/ 8:a&,&"

### Сеть

Запрос ASN для IP-адреса:```shell
$ ronin asn -I 4.2.2.1
4.0.0.0/9 AS3356 (US) LEVEL3

Получить внешний/публичный IP-адрес системы:```shell $ ronin ip --public

Преобразование IP-адреса в десятичный формат:```shell
$ ronin ip --decimal 127.0.0.1
2130706433

Преобразовать файл с IP-адресами в URL-адреса:```shell $ ronin ip --file targets.txt --http

Перечислите все IP-адреса в диапазоне IP CIDR:```shell
$ ronin iprange 10.1.0.0/15
10.0.0.1
10.0.0.2
10.0.0.3
10.0.0.4
10.0.0.5
10.0.0.6
10.0.0.7
10.0.0.8
10.0.0.9
...

Перечислить все IP-адреса в диапазоне IP glob:```shell $ ronin iprange 10.1-3.0.* 10.1.0.1 10.1.0.2 10.1.0.3 10.1.0.4 10.1.0.5 10.1.0.6 10.1.0.7 10.1.0.8 10.1.0.9 10.1.0.10 ...

Перечислить все IP-адреса между двумя IP-адресами:```shell
$ ronin iprange --start 10.0.0.1 --stop 10.0.3.33
10.0.0.1
10.0.0.2
10.0.0.3
10.0.0.4
10.0.0.5
10.0.0.6
10.0.0.7
10.0.0.8
10.0.0.9
10.0.0.10

Подключиться к удаленному TCP-сервису:```shell $ ronin netcat -v example.com 80

Прослушивание на локальном TCP-порту:```shell
$ ronin netcat -v -l 1337

Подключиться к удаленному SSL/TLS сервису:```shell $ ronin netcat -v --ssl example.com 443

Подключиться к удаленному UDP-сервису:```shell
$ ronin netcat -v -u example.com 1337

Прослушивание локального UDP-порта:```shell $ ronin netcat -v -u -l 1337

Открывает UNIX-сокет:```shell
$ ronin netcat -v --unix /path/to/unix.socket

Шестнадцатеричный дамп всех данных, полученных из сокета:```shell $ ronin netcat --hexdump example.com 80 GET / HTTP/1.1 Host: example.com User-Agent: Ruby

00000000 48 54 54 50 2f 31 2e 31 20 32 30 30 20 4f 4b 0d |HTTP/1.1 200 OK.| 00000010 0a 41 67 65 3a 20 32 35 30 38 30 36 0d 0a 43 61 |.Age: 250806..Ca| 00000020 63 68 65 2d 43 6f 6e 74 72 6f 6c 3a 20 6d 61 78 |che-Control: max| 00000030 2d 61 67 65 3d 36 30 34 38 30 30 0d 0a 43 6f 6e |-age=604800..Con| 00000040 74 65 6e 74 2d 54 79 70 65 3a 20 74 65 78 74 2f |tent-Type: text/| 00000050 68 74 6d 6c 3b 20 63 68 61 72 73 65 74 3d 55 54 |html; charset=UT| ...

#### DNS

Запрос DNS-записей:```shell
$ ronin dns -t TXT github.com

Найти все зарегистрированные TLD для имени хоста:```shell $ ronin host --enum-tlds --registered github.com github.ac github.actor github.ae github.africa github.agency github.ai ...

Найти все зарегистрированные публичные суффиксы для имени хоста:```shell
$ ronin host --enum-suffix --registered github.com
example.com.ag
example.ai
example.al
example.am
example.com.ar
example.at
example.co.at
example.or.at
example.com.au
example.be
example.com.bh
...

Найти все поддомены, у которых есть адреса:```shell $ ronin host --enum-subdomains subdomains.txt --has-addresses google.com www.google.com mail.google.com smtp.google.com ns1.google.com ns2.google.com m.google.com ns.google.com blog.google.com admin.google.com news.google.com vpn.google.com ns3.google.com ...

Перечислить все возможные варианты тайпсквоттинга для домена:```shell
$ ronin typosquat microsoft.com
microosoft.com
microsooft.com
microssoft.com

Найдите все зарегистрированные домены-тайпсквоттеры для действительного домена:```shell $ ronin typosquat --registered microsoft.com

Найти все тайпсквоттинговые домены с адресами для действительного домена:```shell
$ ronin typosquat --has-addresses microsoft.com

Найти все незарегистрированные домены-типосквоттеры для действительного домена:```shell $ ronin typosquat --unregistered microsoft.com

Деобфусцировать адрес электронной почты:```shell
$ ronin email-addr --deobfuscate "john [dot] smith [at] example [dot] com"
[email protected]

Перечислите все обфускации адреса электронной почты:```shell $ ronin email-addr --enum-obfuscations [email protected] john.smith @ example.com john.smith AT example.com john.smith at example.com john.smith[AT]example.com john.smith[at]example.com ...

#### SSL/TLS Сертификаты

Выгрузить информацию о SSL/TLS сертификате:```shell
$ ronin cert-dump https://example.com/

Скачать SSL/TLS сертификат с хоста и порта:```shell $ ronin cert-grab github.com:443

Сгенерировать новый SSL/TLS сертификат:```shell
$ ronin cert-gen -c test.com -O "Test Co" -U "Test Dept" \
                 -L "Test City" -S NY -C US

HTTP

Выполнить HTTP GET запрос (с подсветкой синтаксиса):```shell $ ronin http https://example.com/

Отправить HTTP-запрос с дополнительными заголовками:```shell
$ ronin http --post --header "Authorization: ..." https://foo.bar/

Отправьте HTTP-запрос с известной строкой User-Agent:```shell $ ronin http --post --user-agent chrome-android https://foo.bar/

Отправьте HTTP-запрос с пользовательской строкой `User-Agent`:```shell
$ ronin http --post --user-agent-string "..." https://foo.bar/

Откройте интерактивную HTTP-оболочку:```shell $ ronin http --shell https://example.com/ https://example.com/> help help [COMMAND] Prints the list of commands or additional help get PATH[?QUERY] [BODY] Performs a GET request head PATH[?QUERY] Performs a HEAD request patch PATH[?QUERY] [BODY] Performs a PATCH request post PATH[?QUERY] [BODY] Performs a POST request put PATH [BODY] Performs a PUT request copy PATH DEST Performs a COPY request delete PATH[?QUERY] Performs a DELETE request lock PATH[?QUERY] Performs a LOCK request options PATH[?QUERY] Performs a OPTIONS request mkcol PATH[?QUERY] Performs a MKCOL request move PATH[?QUERY] DEST Performs a MOVE request propfind PATH[?QUERY] Performs a PROPFIND request proppatch PATH[?QUERY] Performs a PROPPATCH request trace PATH[?QUERY] Performs a TRACE request unlock PATH[?QUERY] Performs a UNLOCK request cd PATH Changes the base URL path headers [{set | unset} NAME [VALUE]] Manages the request headers

Вывести HTTP-статус каждого URL из файла:```shell
$ ronin url --file urls.txt --status

Генераторы

Создайте новый Ruby-скрипт с предварительно загруженным ronin-support:```shell $ ronin new script foo.rb

Создайте новый проект на Ruby с `Gemfile`:```shell
$ ronin new project foo

Создайте новый Ruby-скрипт с использованием nokogiri для парсинга HTML/XML:

$ ronin new nokogiri foo.rb

Создать новый [ronin-web-server] Ruby-скрипт:```shell
$ ronin new web-server my_server.rb

Создайте новое веб-приложение на основе ronin-web-server:```shell $ ronin new web-app my_app

Сгенерируйте новый Ruby-скрипт [ronin-web-spider]:```shell
$ ronin new web-spider --host=example.com my_spider.rb

Создать скрипт ronin-listener-dns:```shell $ ronin new dns-listener my_dns_listener.rb

Сгенерировать скрипт [ronin-dns-proxy]:```shell
$ ronin new dns-proxy my_dns_proxy.rb

Сгенерировать скрипт ronin-listener-http:```shell $ ronin new http-listener my_http_listener.rb

Сгенерируйте скрипт [ronin-exploits]:```shell
$ ronin new exploit my_exploit.rb

Создайте скрипт ronin-payloads:```shell $ ronin new payload my_payload.rb

### Архив

Архивные файлы:```shell
$ ronin archive -o archive.zip file1.txt file2.txt

Архивируйте файлы с помощью формата tar:```shell $ ronin archive -o archive.tar file1.txt file2.txt

Разархивировать файлы:```shell
$ ronin unarchive arch1.tar arch2.zip

Разархивировать файл с явным указанием формата:```shell $ ronin unarchive -f zip arch2.jar

### See Also

* [ronin-repos](https://github.com/ronin-rb/ronin-repos#synopsis)
* [ronin-wordlists](https://github.com/ronin-rb/ronin-wordlists#synopsis)
* [ronin-db](https://github.com/ronin-rb/ronin-db#synopsis)
* [ronin-web](https://github.com/ronin-rb/ronin-web#synopsis)
* [ronin-fuzzer](https://github.com/ronin-rb/ronin-fuzzer#synopsis)
* [ronin-payloads](https://github.com/ronin-rb/ronin-payloads#synopsis)
* [ronin-exploits](https://github.com/ronin-rb/ronin-exploits#synopsis)
* [ronin-vulns](https://github.com/ronin-rb/ronin-vulns#synopsis)

## Требования

* [gcc] / [clang]
* [make]
* [git]
* [libsqlite3]
* [Ruby] >= 3.2.0
* [open_namespace] ~> 0.4
* [rouge] ~> 3.0
* [io-endpoint] ~> 0.15
* [io-stream] ~> 0.8
* [wordlist] ~> 1.1
* [ronin-support] ~> 1.1
* [ronin-dns-proxy] ~> 0.1
* [ronin-core] ~> 0.2
* [ronin-repos] ~> 0.1
* [ronin-wordlists] ~> 0.1
* [ronin-db] ~> 0.1
* [ronin-listener] ~> 0.1
* [ronin-nmap] ~> 0.1
* [ronin-masscan] ~> 0.1
* [ronin-recon] ~> 0.1
* [ronin-fuzzer] ~> 0.1
* [ronin-web] ~> 2.0
* [ronin-code-asm] ~> 1.0
* [ronin-code-sql] ~> 2.0
* [ronin-payloads] ~> 0.1
* [ronin-exploits] ~> 1.0
* [ronin-vulns] ~> 0.2
* [ronin-app] ~> 0.1

## Установка

### Скрипт Bash```shell
curl -o ronin-install.sh https://raw.githubusercontent.com/ronin-rb/scripts/main/ronin-install.sh && bash ronin-install.sh

Manually

См. инструкции по ручной установке для установки Ronin и его дополнительных зависимостей на вашей платформе.

Docker

Если вы предпочитаете использовать Docker, также доступны [Docker образы]:

```shell docker pull roninrb/ronin docker run -it roninrb/ronin

Кроме того, если вы хотите смонтировать ваш домашний каталог в образ Docker:```shell
docker run --mount type=bind,source="$HOME",target=/home/ronin -it ronin

Разработка

1. Форкните!
2. Клонируйте!
3. cd ronin
4. ./scripts/setup
5. git checkout -b my_feature
6. Пишите код!
7. bundle exec rake spec
8. git push origin my_feature

Лицензия

Copyright (c) 2006-2026 Hal Brodigan (postmodern.mod3 at gmail.com)

Ronin — это свободное программное обеспечение; вы можете распространять и/или изменять его в соответствии с условиями GNU General Public License, опубликованной Free Software Foundation, либо версии 3 этой лицензии, либо (по вашему выбору) любой более поздней версии.

Ronin распространяется в надежде, что он будет полезен, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии КОММЕРЧЕСКОЙ ЦЕННОСТИ или ПРИГОДНОСТИ ДЛЯ ОПРЕДЕЛЕННОЙ ЦЕЛИ. Подробнее см. в GNU General Public License.

Вы должны были получить копию GNU General Public License вместе с Ronin. Если нет, см. https://www.gnu.org/licenses/.