
Un fuzzer guidato dalla copertura per codice Ruby puro ed estensioni C di Ruby.
Un fuzzer guidato dalla copertura per codice Ruby puro e per le estensioni C di Ruby.
Ruzzy è fortemente ispirato ad Atheris di Google, un fuzzer per Python. Ruzzy utilizza libFuzzer (o LibAFL) per la strumentazione della copertura e come motore di fuzzing. Ruzzy supporta anche AddressSanitizer e UndefinedBehaviorSanitizer durante il fuzzing delle estensioni C. Se desideri saperne di più sull'ispirazione alla base di Ruzzy, consulta il nostro articolo: Design and Implementation of a Coverage-Guided Ruby Fuzzer.
Indice:
Ruzzy supporta Linux (x86-64, AArch64/ARM64) e macOS (Apple Silicon). Su Windows, puoi compilare il Dockerfile e/o utilizzare l'ambiente di sviluppo. Ruzzy richiede una versione recente di clang (testata a partire dalla 14.0.0), preferibilmente l'ultima release. Per la configurazione specifica di macOS, consulta le note per gli utenti macOS.
Installa Ruzzy con il seguente comando:
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
Ci sono molte cose in gioco qui, quindi analizziamole:
MAKE sovrascrive il comando make durante la compilazione dell'estensione C di Ruzzy. Questo indica a make di rispettare le variabili d'ambiente successive durante la compilazione dell'estensione.clang corretti. Questo assicura di disporre delle funzionalità più recenti di clang, necessarie per un corretto fuzzing.Se riscontri problemi durante l'installazione, puoi eseguire il seguente comando per ottenere l'output di debug:
RUZZY_DEBUG=1 gem install --verbose ruzzy
Se il tuo target di fuzzing in puro Ruby fa un uso intensivo di regexp, allora installa regexp_parser:
gem install regexp_parser
Una volta installato, Ruzzy utilizzerà automaticamente questa funzionalità per campionare (cioè risolvere) le regexp che incontra durante il fuzzing. Ciò consente al fuzzer di superare le condizioni delle regexp e sbloccare una copertura aggiuntiva.
Ruzzy include un esempio giocattolo per dimostrarne il funzionamento. Innanzitutto, impostare la seguente variabile d'ambiente:
export ASAN_OPTIONS="allocator_may_return_null=1:detect_leaks=0:use_sigaltstack=0"
ASAN_OPTIONSPuoi quindi eseguire l'esempio con il seguente comando:
LD_PRELOAD=$(ruby -e 'require "ruzzy"; print Ruzzy::ASAN_PATH') \
ruby -e 'require "ruzzy"; Ruzzy.dummy'
LD_PRELOAD è necessario per gli stessi motivi di Atheris. Tuttavia, a differenza di ASAN_OPTIONS, probabilmente non vuoi eseguirne l'export poiché potrebbe interferire con altri programmi.
Dovrebbe produrre rapidamente un crash come il seguente:
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=
Vediamo che ha trovato correttamente l'input ("HI") che ha prodotto una violazione di memoria. Per maggiori informazioni, consulta dummy.c per capire perché si è verificata questa violazione.
Puoi rieseguire il caso di crash con il seguente comando:
LD_PRELOAD=$(ruby -e 'require "ruzzy"; print Ruzzy::ASAN_PATH') \
ruby -e 'require "ruzzy"; Ruzzy.dummy' \
./crash-253420c1158bc6382093d409ce2e9cff5806e980
I seguenti sanitizer sono disponibili:
Ruzzy::ASAN_PATH per AddressSanitizerRuzzy::UBSAN_PATH per UndefinedBehaviorSanitizerFacciamo il fuzzing di un piccolo script Ruby come esempio. Il fuzzing di codice Ruby puro richiede due script Ruby: uno script tracer e un fuzzing harness. Lo script tracer è necessario a causa di un dettaglio implementativo dell'interprete Ruby.
Innanzitutto, lo script tracer, chiamiamolo test_tracer.rb:
# frozen_string_literal: true
require 'ruzzy'
Ruzzy.trace('test_harness.rb')
Successivamente, l'harness di fuzzing, chiamiamolo 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)
Puoi eseguire questo file e iniziare il fuzzing con il seguente comando:
LD_PRELOAD=$(ruby -e 'require "ruzzy"; print Ruzzy::ASAN_PATH') \
ruby test_tracer.rb
Dovrebbe produrre rapidamente un crash come il seguente:
Scopri gli strumenti più utilizzati dalla nostra community.
Nessun dato di popolarità ancora.