Skip to content
KitploitKITPLOIT
ИнструментыБлог
Log in
Отправить
ИнструментыБлог
Отправить

Инструменты для хакинга, пентеста и кибербезопасности — ваш арсенал защиты!

Kitploit — это каталог инструментов для хакинга, кибербезопасности и пентестинга. Находите последние обновления проектов для поиска уязвимостей, анализа систем, автоматизации тестирования и усиления вашей безопасности.

ЛентыКонтактыКонфиденциальность© 2026 Kitploit

Каталог инструментов

Категории

Все категории
Loading categories
ruzzy — Фаззер, управляемый покрытием, для чистого кода Ruby и C-расширений Ruby | Kitploit
Инструменты/GitHubGitHub/trailofbits/ruzzy
Динамический анализ (песочница)Анализ уязвимостейАнализ КодаФаззингАнализ Бинарных ФайловОбучение и Образование
GitHubtrailofbits/ruzzy

ruzzy

Фаззер, управляемый покрытием, для чистого кода Ruby и C-расширений Ruby

Репозиторий
1237414 дней назадПроверено Kitploit
Поделиться

Ruzzy

Test Gem Version

Фаззер с покрытийной обратной связью для чистого кода на Ruby и C-расширений Ruby.

Ruzzy во многом вдохновлён Atheris от Google — фаззером для Python. Ruzzy использует libFuzzer (или LibAFL) для инструментирования покрытия и в качестве движка фаззинга. Ruzzy также поддерживает AddressSanitizer и UndefinedBehaviorSanitizer при фаззинге C-расширений. Если вы хотите узнать больше о том, что вдохновило создание Ruzzy, см. нашу статью: Design and Implementation of a Coverage-Guided Ruby Fuzzer.

Содержание:

  • Установка
  • Использование
    • Начало работы
    • Фаззинг чистого кода на Ruby
    • Фаззинг C-расширений Ruby
  • API
    • Ruzzy
    • FuzzedDataProvider
  • Замечания для пользователей macOS
  • Список находок
  • Разработка
    • Компиляция
    • Тестирование
    • Линтинг
    • Выпуск релиза
  • Дополнительные материалы

Установка

Ruzzy поддерживает Linux (x86-64, AArch64/ARM64) и macOS (Apple Silicon). В Windows вы можете собрать Dockerfile и/или использовать среду разработки. Ruzzy требует свежую версию clang (протестировано вплоть до 14.0.0), предпочтительно последний релиз. О настройке для macOS см. замечания для пользователей macOS.

Установите Ruzzy следующей командой:

MAKE="make --environment-overrides V=1" \
CC="/path/to/clang" \
CXX="/path/to/clang++" \
LDSHARED="/path/to/clang -shared" \
LDSHAREDXX="/path/to/clang++ -shared" \
    gem install ruzzy

Здесь много всего, поэтому давайте разберём это по частям:

  • Переменная окружения MAKE переопределяет команду make при компиляции расширения Ruzzy C. Это указывает make учитывать последующие переменные окружения при компиляции расширения.
  • Остальные переменные окружения используются во время компиляции, чтобы гарантировать использование правильных бинарных файлов clang. Это обеспечивает наличие последних возможностей clang, которые необходимы для корректного фаззинга.

Если вы столкнётесь с проблемами при установке, то можете выполнить следующую команду, чтобы получить отладочный вывод:

RUZZY_DEBUG=1 gem install --verbose ruzzy

Если ваша цель чистого фаззинга на Ruby активно использует регулярные выражения, установите regexp_parser:

gem install regexp_parser

После установки Ruzzy автоматически использует эту функциональность для сэмплирования (то есть решения) регулярных выражений, встречающихся во время фаззинга. Это позволяет фаззеру преодолевать условия с регулярными выражениями и открывать дополнительное покрытие.

Использование

Начало работы

Ruzzy включает игрушечный пример, демонстрирующий его работу. Сначала задайте следующую переменную окружения:

export ASAN_OPTIONS="allocator_may_return_null=1:detect_leaks=0:use_sigaltstack=0"
Понимать эти параметры не обязательно, но если вам интересно, нажмите здесь.

ASAN_OPTIONS

  1. Сбои выделения памяти распространены и имеют низкое воздействие (DoS), поэтому пока пропустите их.
  2. Как и Python, интерпретатор Ruby утекает данные, поэтому пока игнорируйте их.
  3. Ruby рекомендует отключать sigaltstack.

Затем вы можете запустить пример с помощью следующей команды:

LD_PRELOAD=$(ruby -e 'require "ruzzy"; print Ruzzy::ASAN_PATH') \
    ruby -e 'require "ruzzy"; Ruzzy.dummy'

LD_PRELOAD требуется по тем же причинам, что и для Atheris. Однако, в отличие от ASAN_OPTIONS, вам, вероятно, не стоит делать его export, так как это может помешать другим программам.

Это должно быстро вызвать сбой, подобный следующему:

INFO: Running with entropic power schedule (0xFF, 100).
INFO: Seed: 2527961537
...
==45==ERROR: AddressSanitizer: heap-use-after-free on address 0x50c0009bab80 at pc 0xffff99ea1b44 bp 0xffffce8a67d0 sp 0xffffce8a67c8
...
SUMMARY: AddressSanitizer: heap-use-after-free /var/lib/gems/3.1.0/gems/ruzzy-0.9.0/ext/dummy/dummy.c:18:24 in _c_dummy_test_one_input
...
==45==ABORTING
MS: 4 EraseBytes-CopyPart-CopyPart-ChangeBit-; base unit: 410e5346bca8ee150ffd507311dd85789f2e171e
0x48,0x49,
HI
artifact_prefix='./'; Test unit written to ./crash-253420c1158bc6382093d409ce2e9cff5806e980
Base64: SEk=

Мы видим, что он правильно нашёл вход ("HI"), вызвавший нарушение памяти. Для получения дополнительной информации см. dummy.c, чтобы понять, почему произошло это нарушение.

Вы можете повторно запустить сценарий сбоя следующей командой:

LD_PRELOAD=$(ruby -e 'require "ruzzy"; print Ruzzy::ASAN_PATH') \
    ruby -e 'require "ruzzy"; Ruzzy.dummy' \
    ./crash-253420c1158bc6382093d409ce2e9cff5806e980

Доступны следующие санитайзеры:

  • Ruzzy::ASAN_PATH для AddressSanitizer
  • Ruzzy::UBSAN_PATH для UndefinedBehaviorSanitizer

Фаззинг чистого кода на Ruby

Давайте в качестве примера проведём фаззинг небольшого скрипта на Ruby. Фаззинг чистого кода на Ruby требует двух скриптов на Ruby: скрипта-трассировщика и фаззинг-обвязки. Скрипт-трассировщик необходим из-за особенности реализации интерпретатора Ruby.

Сначала скрипт-трассировщик, назовём его test_tracer.rb:

# frozen_string_literal: true

require 'ruzzy'

Ruzzy.trace('test_harness.rb')

Далее — обвязка для фаззинга, назовём её test_harness.rb:

# frozen_string_literal: true

require 'ruzzy'

def fuzzing_target(input)
  if input.length == 4
    if input[0] == 'F'
      if input[1] == 'U'
        if input[2] == 'Z'
          if input[3] == 'Z'
            raise
          end
        end
      end
    end
  end
end

test_one_input = lambda do |data|
  fuzzing_target(data) # Your fuzzing target would go here
  return 0
end

Ruzzy.fuzz(test_one_input)

Вы можете запустить этот файл и начать фаззинг с помощью следующей команды:

LD_PRELOAD=$(ruby -e 'require "ruzzy"; print Ruzzy::ASAN_PATH') \
    ruby test_tracer.rb

Он должен быстро вызвать сбой, подобный следующему:

Скачать инструмент

Популярное

Смотреть все →

Откройте для себя самые используемые инструменты нашего сообщества.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 Полный набор инструментов OSINT: граф расследования, оценка достоверности, семейства псевдонимов, карта, временная шкала и отчёты. 49 модулей, более 400 сайтов, API-ключи не требуются.

    500
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    # Приложение GhostLock с запуском в один клик (CVE-2026-43499)

    466
  • 3

    ARTEX

    baarai/artex

    Платформа автономного тестирования на проникновение на основе мультиагентной LLM с агентами-планировщиками и агентами-исполнителями, графами активов и исследования, записью MITM-трафика и повторной проверкой уязвимостей.

    339
  • 4

    opencti

    opencti-platform/opencti

    Открытая платформа киберразведки угроз

    317
  • 5

    redforge

    cybersecurity91/redforge

    Браузерный инструментарий для red team с 102 офлайн-инструментами для разведки, генерации полезной нагрузки, атак на учётные данные, криптографии, кодирования и отчётности по проектам.

    307
  • 6

    estorides

    grisuno/estorides

    Агрегирует 99+ бесплатных источников OSINT параллельно, преобразует сущности в граф знаний и экспортирует в STIX 2.1, MISP или GraphML с анализом при поддержке LLM.

    294

Изучить все инструменты

Просмотрите нашу коллекцию инструментов

Смотреть все инструменты →