
مختبر إرشادي بالتغطية لرمز Ruby الخالص وامتدادات Ruby C
أداة fuzzing موجّهة بالتغطية لكود Ruby النقي وإضافات C الخاصة بـ Ruby.
Ruzzy مستوحاة بشكل كبير من Atheris من Google، وهي أداة fuzzing للغة Python. تستخدم Ruzzy مكتبة libFuzzer (أو LibAFL) لأدوات قياس التغطية ومحرك الـ fuzzing الخاص بها. تدعم Ruzzy أيضًا AddressSanitizer وUndefinedBehaviorSanitizer عند إجراء fuzzing لإضافات 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، وهي ضرورية للـ fuzzing السليم.إذا واجهت مشكلات أثناء التثبيت، فيمكنك تشغيل الأمر التالي للحصول على مخرجات التصحيح:
RUZZY_DEBUG=1 gem install --verbose ruzzy
إذا كان هدفك في الاختبار العشوائي (fuzzing) بلغة Ruby النقية يستخدم التعبيرات النمطية (regexps) بكثافة، فقم بتثبيت 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
المعقّمات (sanitizers) التالية متاحة:
Ruzzy::ASAN_PATH لـ AddressSanitizerRuzzy::UBSAN_PATH لـ UndefinedBehaviorSanitizerلنقم باختبار التغطية العشوائية لسكربت Ruby صغير كمثال. يتطلب اختبار التغطية العشوائية لكود Ruby الخالص سكربتين من Ruby: سكربت تتبّع (tracer script) وحاوية اختبار التغطية العشوائية (fuzzing harness). يُشترط وجود سكربت التتبّع بسبب تفصيل تنفيذي في مفسّر 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
يجب أن يُنتج سريعًا تعطلًا كالتالي:
INFO: Running with entropic power schedule (0xFF, 100).
INFO: Seed: 2311041000
...
/app/ruzzy/bin/test_harness.rb:12:in `block in <top (required)>': unhandled exception
from /var/lib/gems/3.1.0/gems/ruzzy-0.9.0/lib/ruzzy.rb:15:in `c_fuzz'
from /var/lib/gems/3.1.0/gems/ruzzy-0.9.0/lib/ruzzy.rb:15:in `fuzz'
from /app/ruzzy/bin/test_harness.rb:35:in `<top (required)>'
from bin/test_tracer.rb:7:in `require_relative'
from bin/test_tracer.rb:7:in `<main>'
...
SUMMARY: libFuzzer: fuzz target exited
MS: 1 CopyPart-; base unit: 24b4b428cf94c21616893d6f94b30398a49d27cc
0x46,0x55,0x5a,0x5a,
FUZZ
artifact_prefix='./'; Test unit written to ./crash-aea2e3923af219a8956f626558ef32f30a914ebc
Base64: RlVaWg==
يمكننا أن نرى أنه وجد بشكل صحيح المدخل ("FUZZ") الذي أنتج استثناءً.
لتطبيق الـ fuzzing على هدفك الخاص، عدّل lambda الخاص بـ test_one_input لاستدعاء دالة هدفك.
لنطبّق الـ fuzzing على مكتبة msgpack-ruby كمثال. أولاً، ثبّت الـ gem: