
Фаззер, управляемый покрытием, для чистого кода Ruby и C-расширений Ruby
Фаззер с покрытийной обратной связью для чистого кода на Ruby и C-расширений Ruby.
Ruzzy во многом вдохновлён Atheris от Google — фаззером для Python. Ruzzy использует libFuzzer (или LibAFL) для инструментирования покрытия и в качестве движка фаззинга. Ruzzy также поддерживает AddressSanitizer и UndefinedBehaviorSanitizer при фаззинге C-расширений. Если вы хотите узнать больше о том, что вдохновило создание Ruzzy, см. нашу статью: Design and Implementation of a Coverage-Guided Ruby Fuzzer.
Содержание:
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Затем вы можете запустить пример с помощью следующей команды:
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 для AddressSanitizerRuzzy::UBSAN_PATH для UndefinedBehaviorSanitizerДавайте в качестве примера проведём фаззинг небольшого скрипта на 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
Он должен быстро вызвать сбой, подобный следующему: