PyGoat

تطبيق ويب ضعيف أمنيًا عن عمد في Django. خريطة طريقنا: بناء تطبيق ويب ضعيف أمنيًا عن عمد في Django. يمكن أن تستند الثغرات إلى قائمة OWASP العشر الأوائل.

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

• pygoat
  • التثبيت
    • من المصدر
    • حاوية Docker
    • فيديو التثبيت
  • إلغاء التثبيت
  • الحلول
  • للمطورين

التثبيت

من المصدر

لإعداد المشروع على جهازك المحلي:

أولاً، استنسخ المستودع باستخدام موقع GitHub أو git في الطرفية

  git clone https://github.com/adeyosemanputra/pygoat.git
  ### To Download a specific branch
  git clone -b <branch_name> https://github.com/adeyosemanputra/pygoat.git

ملاحظات ويندوز (مستخدمو PowerShell)

• تم اختبار PyGoat بشكل أساسي على Linux/macOS. يُنصح مستخدمو ويندوز باستخدام:
  • Docker Desktop (مفضل)، أو
  • WSL2 (Ubuntu) لإعداد أكثر سلاسة.
• في بعض بيئات ويندوز، قد لا يكون الأمر python3 متاحًا افتراضيًا.
  • إذا لم يتم التعرف على python3، جرب استخدام python بدلاً منه (تأكد من أنه يشير إلى Python 3.x).
• تأكد من أن إصدار Python هو 3.10 أو 3.11 للحصول على أفضل توافق.
• تعتمد بعض المختبرات على أوامر بنمط Unix وقد تتصرف بشكل مختلف على واجهات Windows الأصلية.

الطريقة الأولى

1. قم بتثبيت جميع متطلبات التطبيق وPython باستخدام ملف التثبيت - bash installer.sh
2. قم بتطبيق الترحيلات python3 manage.py migrate.
   
3. أخيرًا، قم بتشغيل خادم التطوير python3 manage.py runserver.
   
4. سيكون المشروع متاحًا على http://127.0.0.1:8000

الطريقة الثانية

1. قم بتثبيت متطلبات Python3 pip install -r requirements.txt.
   
2. قم بتطبيق الترحيلات python3 manage.py migrate.
   
3. أخيرًا، قم بتشغيل خادم التطوير python3 manage.py runserver.
   
4. سيكون المشروع متاحًا على http://127.0.0.1:8000

الطريقة الثالثة

1. قم بتثبيت جميع متطلبات التطبيق وPython باستخدام ملف setup.py - pip3 install .
2. قم بتطبيق الترحيلات python3 manage.py migrate.
   
3. أخيرًا، قم بتشغيل خادم التطوير python3 manage.py runserver.
   
4. سيكون المشروع متاحًا على http://127.0.0.1:8000

حاوية Docker

1. قم بتثبيت Docker
2. قم بتشغيل docker pull pygoat/pygoat أو docker pull pygoat/pygoat:latest
3. قم بتشغيل docker run --rm -p 8000:8000 pygoat/pygoat:latest
4. تصفح إلى http://127.0.0.1:8000
5. قم بإزالة الصورة الموجودة باستخدام docker image rm pygoat/pygoat واسحبها مرة أخرى في حالة وجود أي خطأ

من Docker-Compose

1. قم بتثبيت Docker
2. قم بتشغيل docker-compose up أو docker-compose up -d

تعبئة بيانات التحدي

يخزن PyGoat تعريفات التحديات في challenge/challenge.json. لتعبئة جدول Challenge في قاعدة البيانات من هذا الملف، استخدم أمر إدارة Django المدمج:

باستخدام Docker Compose

docker compose exec web python manage.py populate_challenges

بناء صورة Docker وتشغيلها

1. استنسخ المستودع   git clone https://github.com/adeyosemanputra/pygoat.git
2. قم ببناء صورة Docker من Dockerfile باستخدام   docker build -f Dockerfile -t pygoat .
3. قم بتشغيل صورة Docker  docker run --rm -p 8000:8000 pygoat:latest
4. تصفح إلى http://127.0.0.1:8000 أو http://0.0.0.0:8000

فيديو التثبيت

1. من المصدر باستخدام installer.sh

• تثبيت PyGoat من المصدر

2. بدون استخدام installer.sh

3. التثبيت على Mac M1 (باستخدام Virtualenv)

إلغاء التثبيت

على أنظمة Debian/Ubuntu

• على أنظمة Debian/Ubuntu، يمكنك استخدام السكربت uninstaller.sh لإلغاء تثبيت pygoat مع جميع تبعياته.
• لإلغاء تثبيت pygoat، قم بتشغيل:

$ bash ./uninstaller.sh

على أنظمة أخرى

• على أنظمة أخرى، يمكنك استخدام السكربت uninstaller.py لإلغاء تثبيت pygoat مع جميع تبعياته
• لإلغاء تثبيت pygoat، قم بتشغيل:

$ python3 uninstaller.py

الحلول

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

المساهمون ✨

شكرًا لهؤلاء الأشخاص الرائعين (مفتاح الرموز التعبيرية):

يتبع هذا المشروع مواصفات all-contributors. أرحب بالمساهمات من أي نوع!