Skip to content
KitploitKITPLOIT
أدواتالمدونة
Log in
إرسال
أدواتالمدونة
إرسال

أدوات الاختراق واختبار الاختراق والأمن السيبراني لترسانتك الأمنية!

Kitploit هو دليل لأدوات الاختراق والأمن السيبراني واختبار الاختراق. اكتشف آخر تحديثات المشاريع للعثور على الثغرات وتحليل الأنظمة وأتمتة الاختبارات وتعزيز أمنك.

الخلاصاتاتصالالخصوصية© 2026 Kitploit

دليل الأدوات

الفئات

عرض جميع الفئات
Loading categories
ruzzy — مختبر إرشادي بالتغطية لرمز Ruby الخالص وامتدادات Ruby C | Kitploit
أدوات/GitHubGitHub/trailofbits/ruzzy
التحليل الديناميكي (عزل)تحليل الثغرات الأمنيةتحليل الكودالاختبار العشوائيتحليل الملفات الثنائيةالتعلم والتعليم
GitHubtrailofbits/ruzzy

ruzzy

مختبر إرشادي بالتغطية لرمز Ruby الخالص وامتدادات Ruby C

عرض المستودع
123741منذ 4 أيامتمت المراجعة من قبل Kitploit
مشاركة

Ruzzy

Test Gem Version

أداة 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.

جدول المحتويات:

  • التثبيت
  • الاستخدام
    • البدء
    • إجراء fuzzing لكود Ruby النقي
    • إجراء fuzzing لإضافات C الخاصة بـ Ruby
  • واجهة برمجة التطبيقات (API)
    • Ruzzy
    • FuzzedDataProvider
  • ملاحظات لمستخدمي macOS
  • حالات النجاح
  • التطوير
    • الترجمة البرمجية (Compiling)
    • الاختبار
    • فحص الكود (Linting)
    • الإصدار
  • قراءات إضافية

التثبيت

تدعم 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

  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

المعقّمات (sanitizers) التالية متاحة:

  • Ruzzy::ASAN_PATH لـ AddressSanitizer
  • Ruzzy::UBSAN_PATH لـ UndefinedBehaviorSanitizer

اختبار التغطية العشوائية (Fuzzing) لكود Ruby الخالص

لنقم باختبار التغطية العشوائية لسكربت 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 على إضافات Ruby C

لنطبّق الـ fuzzing على مكتبة msgpack-ruby كمثال. أولاً، ثبّت الـ gem:

تنزيل الأداة

الأكثر شعبية

عرض الكل →

اكتشف الأدوات الأكثر استخدامًا من قبل مجتمعنا.

  • 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

    مجموعة أدوات الفريق الأحمر في المتصفح مع 102 أداة دون اتصال للاستطلاع، وتوليد الحمولات، وهجمات بيانات الاعتماد، والتشفير، والترميز، وإعداد تقارير المهام.

    307
  • 6

    estorides

    grisuno/estorides

    يجمع أكثر من 99 مصدرًا مجانيًا من مصادر OSINT بالتوازي، ويحوّل الكيانات إلى رسم بياني معرفي، ويصدّر بصيغة STIX 2.1 أو MISP أو GraphML مع تحليل بمساعدة LLM.

    294

استكشف جميع الأدوات

تصفح مجموعتنا من الأدوات

عرض جميع الأدوات →