SNARE

نظام محاكاة متقدم وجيل جديد من الفخاخ التفاعلية

حول

SNARE هو حساس فخ تطبيقات ويب يجذب جميع أنواع الضرر من الإنترنت.

التوثيق

يمكن العثور على التوثيق هنا.

المفاهيم الأساسية

• السطح أولاً. التركيز على توليد سطح الهجوم.
• الحساسات والمتحكمات. مجمعات خفيفة الوزن (SNARE) ومتخذ القرار المركزي (tanner).

بدء الاستخدام

• تحتاج Python3.6 لتشغيل SNARE
• تم اختبار هذا مع نظام لينكس مبني على أوبونتو حديث.

خطوات الإعداد

1. احصل على SNARE: git clone https://github.com/mushorg/snare.git و cd snare
2. [اختياري] إنشاء بيئة افتراضية: python3 -m venv venv
3. [اختياري] تفعيل البيئة الافتراضية: . venv/bin/activate

ملاحظة: لا تستخدم sudo مع الأوامر التالية إذا كنت تشغل snare في بيئة افتراضية.

4. تثبيت المتطلبات: sudo pip3 install -r requirements.txt
5. إعداد snare: sudo python3 setup.py install
6. استنساخ صفحة: sudo clone --target http://example.com --path <path to base dir>
7. تشغيل SNARE: sudo snare --port 8080 --page-dir example.com --path <path to base dir>
8. اختبار: زيارة http://localhost:8080/index.html
9. (اختياري) تشغيل خدمة tanner الخاصة بك.

[ملاحظة: يقوم Cloner باستنساخ الموقع بأكمله، لتقييد عمق الاستنساخ أضف المعامل --max-depth]

تعليمات بناء Docker

1. تغيير الدليل الحالي إلى دليل مشروع snare
2. docker-compose build
3. docker-compose up
4. سيبدأ Snare على 0.0.0.0 بالمنفذ 80. يمكن العثور على مزيد من المعلومات حول تشغيل docker-compose هنا.

في حالة حدوث خطأ أثناء تشغيل docker-compose up، تحقق من توفر المنفذ 80، إذا كان مشغولاً فراجع توثيق Docker لتغيير المنفذ الافتراضي.

من الواضح أنك تريد الربط بـ 0.0.0.0 والمنفذ 80 عند التشغيل في الإنتاج.

الاختبار

لتشغيل الاختبارات والحصول على تقرير تغطية الاختبار، نوصي بتشغيل pytest:

    pip install pytest pytest-cov
    sudo pytest --cov-report term-missing --cov=snare snare/tests/

مثال على الإخراج

    # sudo snare --port 8080 --page-dir example.com

       _____ _   _____    ____  ______
      / ___// | / /   |  / __ \/ ____/
      \__ \/  |/ / /| | / /_/ / __/
     ___/ / /|  / ___ |/ _, _/ /___
    /____/_/ |_/_/  |_/_/ |_/_____/


    privileges dropped, running as "nobody:nogroup"
    serving with uuid 9c10172f-7ce2-4fb4-b1c6-abc70141db56
    Debug logs will be stored in /opt/snare/snare.log
    Error logs will be stored in /opt/snare/snare.err
    ======== Running on http://127.0.0.1:8080 ========
    (Press CTRL+C to quit)
    you are running the latest version