WraithWall Open-Source Toolkit

أربع أدوات لهندسة الخداع، مقتطعة من منصة أمنية إنتاجية تستقبل حركة إنترنت حية، ومنقّاة من كل ارتباط بالمنتج/الأسرار، ومُصدَرة تحت رخصة MIT.

هذا ليس عرضًا تجريبيًا مختبريًا. كل أداة هي جزء من WraithWall — منصة خداع بُنيت فرديًا وتعمل خلف وكيل عكسي مع مصيدة عسل تغذيها على مدار الساعة. هذه هي الأجزاء القابلة لإعادة الاستخدام فعليًا بحد ذاتها: إن كنت تشغّل مصيدة عسل، أو تزرع رموز كناري، أو تريد إدارة إعدادات الخداع لديك بإصدارات كأنها شيفرة، فهي لك.

كل مشروع هو حزمة مستقلة قابلة للتثبيت عبر pip install، مع README خاص به وأمثلة واختبارات وواجهة سطر أوامر. لا اعتماد على المنصة — لا Flask، ولا قاعدة بيانات، ولا أسرار.

WraithWall Open-Source Toolkit architecture

الأدوات

Project	What it does	Install	PyPI
canary-kit	إنشاء رموز كناري لسلسلة التوريد وتسجيلها وكشفها — مطابقة أي منارة واردة مباشرةً بالرمز الذي زرعته. تخزين قابل للتوصيل، وRedis اختياري.	`pip install canary-kit`	Published 0.1.0
honeypot-mitre	تحويل سجلات مصيدة العسل Cowrie الخام إلى تقنيات MITRE ATT&CK منظمة، ودرجة حتمية، وإزالة تكرار إعادة التشغيل — دون الحاجة إلى LLM (فهو إضافة اختيارية).	`pip install honeypot-mitre`	Published 0.1.0
dml-spec	Deception Markup Language — مواصفة مُصدَّرة بإصدارات وموقّعة بـ HMAC لإعدادات الفخاخ/الكناري. تحقّق ووقّع وتحقق من التوقيع كي يصبح خداعك قابلًا للمقارنة وكاشفًا للتلاعب.	`cd dml-spec && pip install .`	v2 (0.2.0 ready, not uploaded yet)
wraithmesh	شبكة استشعار موزعة — تتبّع سجلات Cowrie، ودمج الحملات محليًا، ورفع ملاحظات فئات التكافؤ الموقّعة إلى مجمّعات مُصدِّقة. خروج يحافظ على الخصوصية افتراضيًا.	`cd honeypot-mitre && pip install . && cd ../wraithmesh && pip install .`	v2 (0.2.0 ready, not uploaded yet)

حزم منشورة ذات صلة خارج هذا المجلد: wraithwall (المنصة)، ravenscan (واجهة raven).
عميل HTTP API سيكون wraithwall-sdk (قيد البناء؛ ليس هذه المجموعة).

راجع PACKAGE_INVENTORY.md للاطلاع على قائمة تحقق الإصدار v2 الكاملة.

لمحة سريعة

# 1. Canary Kit — mint a token, then detect its beacon
cd canary-kit && pip install .
canary-kit --registry demo.json mint internal-sdk 2.4.1 --type runtime
# ...the token later beacons home from an environment you don't control:
canary-kit --registry demo.json beacon <token-from-mint> --ip 198.51.100.23

# 2. Honeypot → MITRE — raw cowrie log to scored, mapped sessions
cd ../honeypot-mitre && pip install .
honeypot-mitre examples/sample_cowrie.json     # → per-session techniques + score + dedup key

# 3. DML — validate, sign, and verify a deception document
cd ../dml-spec && pip install .
export DML_KEY="your-signing-key"
dml validate examples/example_traps.yaml
dml sign     examples/example_traps.yaml --key-env DML_KEY > signed.yaml
dml verify   signed.yaml --key-env DML_KEY

# 4. WraithMesh — Cowrie tail to signed campaign observations
cd ../wraithmesh && pip install .
export WRAITHMESH_KEY="demo-key"
wraithmesh init-manifest --output /tmp/mesh.json
wraithmesh sensor run --config /tmp/mesh.json --once --log ../honeypot-mitre/examples/sample_cowrie.json

راجع README الخاص بكل مشروع للاطلاع على واجهة API الكاملة، وواجهة سطر الأوامر (CLI)، وملاحظات التصميم.

مبادئ التصميم (مشتركة بين المشاريع الأربعة)

نواة حتمية. الدرجات والخرائط والتوقيعات عبارة عن حسابات رياضية شفافة وتشفير قياسي يمكنك تشغيله ذهنيًا أو تدقيقه سطرًا بسطر — وليست صندوقًا أسود. وحيثما يساعد نموذج لغوي كبير (LLM)، فإن ذلك اختياري تمامًا.
لا اقتران خفي. كل حزمة تُستورد وتعمل دون أي اعتماد على المنصة الأم، أو Flask، أو قاعدة بيانات، أو Redis. الخدمات الخارجية (Redis، أو LLM، أو الاستمرارية) هي واجهات قابلة للتوصيل مع إعدادات افتراضية معقولة في الذاكرة.
لا أسرار، أبدًا. مفاتيح التوقيع وبيانات الاعتماد تأتي من المستدعي (وسيط المُنشئ أو متغير بيئة يضبطه المستدعي). لا شيء مضمّن بشكل ثابت.
صريح بشأن القيود. مطابقة ATT&CK القائمة على السلاسل النصية بدائية؛ والربط شبه فوري، وليس شاملًا. توضح الوثائق ذلك بصراحة بدلًا من الإيحاء بتغطية غير موجودة.

المتطلبات

Python 3.10+
هذا كل شيء تقريبًا — الاعتماديات قليلة ومُعلنة لكل مشروع في ملف pyproject.toml الخاص به.

الترخيص

جزء من مشروع WraithWall · بواسطة Niffy_hunt · @wraithwalll على X · wraithwall على GitHub

الأكثر شعبية

wraithwall-toolkit