Ferret

الوكيل الوسيط (MITM) التعاوني لمختبرات الاختراق الأمني.

التقط حركة HTTP، وأضف تعليقات توضيحية للطلبات باستخدام الذكاء الاصطناعي، ونفذ جلسات صيد (hunt)، وأعد تشغيل حركة المرور، وتتبع النتائج من واجهة واحدة.

بداية سريعة · الميزات · لقطات الشاشة · الإعدادات · الأمان · المساهمة

بداية سريعة

التثبيت

git clone https://github.com/synlace/ferret.git
cd ferret

cp .env.example .env   # اختياري
just up

أو استخدم Docker Compose مباشرة:

docker compose up --build -d

فتح Ferret

افتح:

http://localhost:3000

سيطلب منك معالج الإعداد الأولي تعيين كلمة مرور واختيار مزود ذكاء اصطناعي.

المتطلبات

• Docker
• Docker Compose
• just

نظرة عامة

Ferret هو وكيل اعتراض HTTP بمساعدة الذكاء الاصطناعي، مصمم لمختبرات الاختراق الأمني.

وجّه متصفحك أو أداة سطر الأوامر أو سير عمل الاختبار إلى:

127.0.0.1:1337

يلتقط Ferret الطلبات والاستجابات، ويخزنها محلياً، ويضيف تعليقات توضيحية لحركة المرور باستخدام الذكاء الاصطناعي، ويمنحك أدوات لإعادة التشغيل والتعديل والاختبار وتحويل السلوك المثير للاهتمام إلى نتائج.

إنه مصمم لسير العمل حيث تريد أكثر من مجرد وكيل سلبي: تريد شيئاً يساعدك على التفكير والاختبار والتوثيق أثناء العمل.

الميزات

لقطات الشاشة

الصيد (Hunts) - جلسات صيد بمساعدة الذكاء الاصطناعي تبحث في سجل الطلبات، وتكتب وتشغل الاختبارات، وتنشئ النتائج.

السجل (History) - سجل كامل لطلبات الوكيل مع تعليقات AI والتوقيت ورموز الحالة ومحررين مدمجين للطلب/الاستجابة.

النتائج (Findings) - متتبع للثغرات مع درجة الخطورة والمضيف والنوع والأوصاف التي يولدها AI ومقتطفات الأدلة.

الإعدادات (Settings) - إدارة شهادة CA وكلمة المرور والمصادقة الثنائية (2FA) ومزود AI ومفاتيح API وحالة الوكيل.

معالج الإعداد (Setup wizard) - الإعداد الأولي لإنشاء كلمة المرور وتكوين مزود AI.

استخدام الوكيل

قم بتكوين متصفحك أو أداة سطر الأوامر أو عميل الاختبار لاستخدام:

HTTP proxy:  127.0.0.1:1337
HTTPS proxy: 127.0.0.1:1337

لاعتراض HTTPS، قم بتنزيل وتثبيت شهادة CA الخاصة بـ mitmproxy من صفحة الإعدادات (Settings).

المصادقة

يتطلب Ferret المصادقة في كل تثبيت.

تسجيل الدخول عبر المتصفح

1. افتح الواجهة لأول مرة.
2. قم بتعيين كلمة مرور في معالج الإعداد.
3. أكمل إعداد مزود AI.
4. سجل الدخول على /login.
5. يصدر Ferret ملف تعريف ارتباط جلسة HttpOnly و SameSite=Strict لمدة 24 ساعة.

المصادقة الثنائية

يمكن تفعيل 2FA القائمة على TOTP من صفحة الإعدادات.

بمجرد التفعيل، يلزم إدخال رمز مصادقة صالح عند تسجيل الدخول.

الوصول عبر API

قم بتعيين مفتاح API ثابت في .env:

FERRET_API_KEY=مفتاح-سري-عشوائي-خاص-بك

ثم استخدمه كرمز حامل (Bearer token):

curl -H "Authorization: Bearer مفتاح-سري-عشوائي-خاص-بك" \
  http://localhost:8000/api/requests

يتم فحص ملفات تعريف الارتباط للجلسة ورموز الحامل بشكل مستقل.

الإعدادات

انسخ .env.example إلى .env لتكوين Ferret مسبقاً.

يمكن أيضاً تكوين معظم إعدادات مزود AI من معالج الإعداد.

مزودات AI المدعومة

يمكن إكمال إعداد المزود من معالج التشغيل الأول.

أوامر just

العمارة

متصفح / أداة
      │
      ▼
127.0.0.1:1337
      │
      ▼
ferret-api :8000 / :1337
FastAPI + mitmproxy + SQLite
      │
      ├── docker exec
      ▼
ferret-lab
pytest, ffuf, sqlmap, scripts, tests, notes
      │
      ▼
ferret-ui :3000
Next.js

يتم تخزين جميع البيانات الدائمة تحت:

${FERRET_DATA_DIR:-./data}

يستخدم Ferret روابط ربط (bind mounts) بدلاً من وحدات تخزين Docker المسماة.

إعادة تعيين Ferret

لمسح الحالة المحلية وإعادة تشغيل معالج الإعداد:

just reset

يؤدي هذا إلى إزالة قاعدة البيانات المحلية، بما في ذلك بيانات الاعتماد.

يمكنك أيضاً إعادة تعيين الإعداد عبر API عند المصادقة:

curl -X DELETE \
  -H "Authorization: Bearer مفتاح-سري-عشوائي-خاص-بك" \
  http://localhost:8000/api/setup

التطوير

لتطوير الواجهة محلياً مع إعادة تحميل فوري (hot reload):

just dev

يؤدي هذا إلى تشغيل حاويات API و lab في Docker مع خدمة الواجهة على المضيف عبر npm run dev. يلزم تثبيت Node.js على المضيف لهذا الوضع.

قم بتشغيل الاختبارات باستخدام:

just test api    # اختبارات وحدة API (داخل حاوية api قيد التشغيل)
just test ui     # اختبارات Playwright للواجهة (يبدأ تلقائياً خادم Next.js dev + API وهمي)
just test shim   # اختبارات وحدة docker-shim للسماح/المنع (لا يحتاج Docker)
just test all    # تشغيل جميع المجموعات الثلاث بالتسلسل

الأمان

تم تصميم Ferret لسير عمل اختبار الأمان المحلي وليس مقواه للتعرض العام.

المخاطر

قبل تعريض Ferret خارج localhost، افهم ما يلي:

استخدم كلمة مرور قوية وقم بتفعيل 2FA من صفحة الإعدادات.

الإبلاغ عن ثغرة أمنية

لا تفتح مشكلة عامة للثغرات الأمنية.

راجع .github/SECURITY.md لسياسة الإفصاح الكاملة وتعليمات الإبلاغ.

التقارير المنشورة

يتم نشر الإفصاحات السابقة في security/ بمجرد توفر الإصلاحات.

شكر وتقدير

شكر للباحثين التاليين على الإبلاغ المسؤول عن الثغرات الأمنية:

المساهمة

يتم تطوير Ferret بنشاط.

نرحب بالأفكار وتقارير الأخطاء وطلبات الميزات والمساهمات.

هل تريد المساعدة في بنائه؟

البريد الإلكتروني: [email protected]

الترخيص

MIT - انظر LICENSE.