
أداة فازر موجّهة بالتغطية لواجهات REST API، مطوّرة استنادًا إلى LibAFL
طوّرت TNO أداة WuppieFuzz، وهي أداة اختبار عشوائي (fuzzer) لواجهات REST API موجّهة بالتغطية (coverage-guided) مبنية فوق LibAFL، وتستهدف جمهورًا واسعًا من المستخدمين النهائيين، مع تركيز قوي على سهولة الاستخدام وقابلية تفسير العيوب المكتشفة والوحداتية (modularity). تدعم WuppieFuzz جميع أنماط الاختبار الثلاثة (الصندوق الأسود، والصندوق الرمادي، والصندوق الأبيض).
[!NOTE]
للحصول على إرشادات سريعة يمكنك اتباعها خطوة بخطوة، يُرجى اتباع البرنامج التعليمي!
ظهرت WuppieFuzz في:
إذا كنت ترغب في الاستشهاد بـ WuppieFuzz في عمل أكاديمي، فيُرجى استخدام المنشور المفضّل المدرج في CITATION.cff:
Rooijakkers, T., Nijsten, A., Daniele, C., Weitenberg, E., Groenewegen, R., & Melissen, A. (2026). WuppieFuzz: Coverage-Guided, Stateful REST API Fuzzing. In Proceedings of the 12th International Conference on Information Systems Security and Privacy (ICISSP), Volume 2, 221-231. SciTePress. https://doi.org/10.5220/0000217100004061
WuppieFuzz مرخّصة بموجب Apache-2.0؛ راجع LICENSE.
إشعارات تراخيص الأطراف الثالثة مدرجة في THIRD_PARTY_NOTICES.
للتثبيت السريع لـ WuppieFuzz على أنظمة التشغيل الشائعة (MacOS وWindows وLinux)، راجع الإصدارات أو استخدم brew install wuppiefuzz
يمكنك بناء صورة Docker باستخدام docker build . -t wuppiefuzz:local. لاستخدامها، يجب عليك تركيب مجلد يحتوي على مواصفات openapi الخاصة بك. عند اختبار خدمة تعمل محليًا (وليس في Docker)، تحتاج إلى تحديد شبكة المضيف (host networking):
docker run \
--network host \
-v ./fuzzing-folder:/fuzzing-folder \ # The folder will be populated with wuppiefuzz outputs
-w /fuzzing-folder \
wuppiefuzz:local fuzz --timeout 60 --report openapi.json
لبناء المشروع، تحتاج إلى تثبيت التبعيات والأدوات التالية:
sudo apt install -y build-essential pkg-config cmake # General build tools
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh # Rust
قبل تشغيل WuppieFuzz، يجب عليك بدء تطبيقك الهدف (المُجهَّز بالأدوات).
بالإضافة إلى ذلك، يجب عليك تزويد WuppieFuzz بـ مواصفة OpenAPI حتى يعرف كيفية توليد طلباته وتعديلها. للحصول على مساعدة بشأن وسائط سطر الأوامر، استخدم ما يلي:
$ cargo run -- --help # shows help for required parameters and flags
Usage: wuppiefuzz [OPTIONS] [OPENAPI_SPEC.YAML]
...
على سبيل المثال، لتشغيل WuppieFuzz ضد هدف Java مع وكيل JaCoCo مرفقًا، تحدد ملف OpenAPI الخاص به (الذي يحتوي على عنوان URL الذي يعمل عليه الهدف في مواصفات API). بالإضافة إلى ذلك، تحدد أن تنسيق التغطية هو JaCoCo، وتعطي دليل الفئات كما يلي:
cargo run -- fuzz openapi.yaml --coverage-format jacoco --jacoco-class-dir ../Targets/app/target/classes/
إذا كنت ترغب في استخدام ملف تكوين بدلاً من وسائط سطر الأوامر أو بالاشتراك معها، يمكنك استخدام العلامة --config <CONFIG_FILE>. في حال استخدامك لوسائط سطر الأوامر بالاشتراك مع ملف تكوين، فإن وسائط سطر الأوامر لها الأولوية.
يجب أن يكون ملف التكوين ملف yaml ويحتوي على سطر لكل وسيطة من وسائط سطر الأوامر التي تريد تحديدها، على سبيل المثال:
coverage_format: jacoco
output_format: human-readable
source_dir: "/swagger-petstore/src/main/java"
jacoco_class_dir: "/swagger-petstore/target"
timeout: 20
في هذه الحالة، يمكن أن يكون أمر التشغيل النموذجي كالتالي:
$ cargo run -- fuzz --config=config.yaml --report --coverage-host=localhost:6300 --timeout=10 ./openapi.yaml
هذا السطر سيجمع الوسائط من سطر الأوامر ومن ملف
الإعدادات. نظرًا لأن العلامة --timeout محددة في كليهما، فإن المهلة المحددة في
سطر الأوامر (10 ثوانٍ) ستكون لها الأولوية.
في الدليل example_configs/ ستجد ملفَّي إعدادات نموذجيين لاستخدامهما
في إنشاء تقارير التغطية باستخدام JaCoCo لشيفرة Java وإنشاء
تقارير التغطية باستخدام LCOV لشيفرة Python.
عند تشغيل WuppieFuzz مع العلامة --report، يُنشأ دليل فرعي داخل
reports/ باسم يمثل طابعًا زمنيًا. تُكتب جميع تقارير التغطية المدعومة
داخل هذا الدليل الفرعي. هناك نوعان من تقارير التغطية:
علاوة على ذلك، تُملأ قاعدة بيانات بجميع معلومات الطلبات المتعلقة بحملة الاختبار العشوائي (fuzzing) الخاصة بك. يمكن تصوّر قاعدة البيانات هذه واستكشافها من خلال لوحة تحكم Grafana.
تكتب العلامة --report نفسها أيضًا ملف report.json داخل
دليل reports/<timestamp>، وفقًا لـ مخطط تقرير Web Fuzzing Commons
،
مما يسمح باستهلاك النتائج بواسطة الأدوات المتوافقة مع WFC. وهو يلخّص
حالات الاختبار المُنشأة، ونقاط النهاية ورموز حالة HTTP المغطاة، وأي أخطاء
(أخطاء التحقق) تم العثور عليها، وإحصاءات التغطية الأساسية (تُضمَّن تغطية الشيفرة
فقط عند تكوين وكيل تغطية - مثل JaCoCo -؛ في
وضع الصندوق الأسود/نقاط النهاية فقط تُبلَّغ تغطية نقاط النهاية فقط).
لمزيد من المعلومات حول كل من هذه، راجع ملفات README في هذه الأدلة.
بشكل افتراضي، يضمّن WuppieFuzz اعتمادياته من C (OpenSSL وSQLite وZ3) بحيث
يعمل cargo build العادي مباشرةً. للحصول على ترجمة أسرع أثناء
التطوير، يمكنك تعطيل جميع الاعتماديات المضمّنة والربط مع
المكتبات المثبتة على النظام بدلاً من ذلك.
[!NOTE] تتطلب حزمة
z3الإصدار Z3 4.15+، وهو أحدث من الإصدار الذي توفره معظم مديري حزم توزيعات Linux. ثبّت Z3 عبر Homebrew (brew install z3) للحصول على إصدار متوافق.
ثبّت المكتبات التالية على نظامك:
Debian/Ubuntu:
sudo apt install libssl-dev libsqlite3-dev
brew install z3 # apt's libz3-dev is too old; use Homebrew instead