🍕 مرحبًا بكم في متجر PwnzzAI(/pəʊnzɑː/) – متجر البيتزا القابل للاختراق! 💻

في متجر PwnzzAI، تقدم كل شريحة بيتزا جرعة من التعليم الشامل لأمن الذكاء الاصطناعي. تُعِدّ هذه المنصة التعليمية العملية المتخصصين لفهم حماية تقنيات الذكاء الاصطناعي على نطاق واسع عبر سيناريو متجر بيتزا ممتع وعملي.

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

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

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

• نبذة
  • النطاق والأهداف التعليمية
• تعليمات الإعداد
  • الخيار 1: Docker (PwnzzAI + Ollama)
  • إذا لم يتم سحب الصورة الافتراضية (البناء محليًا)
  • الخيار 2: Docker (Ollama خاص بك + صورة PwnzzAI)
  • الخيار 3: تشغيل الكود المصدري بنفسك
  • استكشاف الأخطاء: اتصال Ollama (WSL + Docker)
  • مضيفو ورش العمل: اختيار OpenAI أو Claude أو Gemini أو نماذج سحابية أخرى
• الميزات
• التغطية الأمنية للذكاء الاصطناعي
  • الإطار التعليمي
  • الثغرات المُنفَّذة
  • دعم النماذج

نبذة

يمثل متجر PwnzzAI منصة تعليمية عملية صُممت عمدًا للتدريب على حماية تقنيات الذكاء الاصطناعي. يعرض هذا التطبيق القائم على Flask والمُعرَّض عمدًا للثغرات مجموعة واسعة من نقاط الضعف في أمن الذكاء الاصطناعي عبر تجربة متجر بيتزا غامرة.

الشريك المؤسس: OWASP AI Exchange

النطاق والأهداف التعليمية

صُمم PwnzzAI كمنصة تعليمية شاملة ومتطورة تتوافق مع التصنيف المرجعي للمخاطر في AI Exchange. ويتوسع نطاقه تدريجيًا بما يتوافق مع أطر تحليل الأمان وإرشادات الدفاع الخاصة بـ OWASP AI Exchange، مما يضمن استمرار ملاءمته على المدى الطويل مع نضوج ممارسات أمن الذكاء الاصطناعي. يدرج المشروع حاليًا OWASP Top 10 لأنظمة LLM، مع بنية مُخطط لها عمدًا لتتوافق مع تصنيفات مخاطر AI Exchange. وبمرور الوقت، يهدف PwnzzAI إلى النضوج ليصبح نظامًا تعليميًا منظمًا يدعم:

• التدريب على حماية الذكاء الاصطناعي والدفاع عنه، بما في ذلك مسارات التعلم الذاتي

• برامج تدريب أمني عملي مع تمارين قائمة على سيناريوهات واقعية

• مبادرات تعلم جماعية لمهندسي الأمن والممارسين

• تعليم أمني شامل للذكاء الاصطناعي، يمتد من التصميم والتطوير إلى النشر والتشغيل

تعليمات الإعداد

اختر إحدى هذه الطرق الثلاث لتشغيل PwnzzAI:

1. Docker مع كلتا الصورتين (PwnzzAI + Ollama)
2. Docker مع Ollama محلي/بعيد خاص بك وصورة PwnzzAI فقط
3. تشغيل الكود المصدري بنفسك

قبل البدء (جميع الخيارات)

1. ثبّت Docker Desktop من https://www.docker.com/products/docker-desktop.
2. افتح Docker Desktop وانتظر حتى تظهر رسالة أن Docker يعمل.
3. ثبّت Git إذا لم يكن مثبتًا لديك بالفعل.
4. استنسخ هذا المستودع وادخل إليه:

git clone https://github.com/OWASP/PwnzzAI.git
cd PwnzzAI

اختياري: إعداد نموذج سحابي (OpenAI / Gemini / Claude)

تعمل المختبرات على نموذج محلي مجاني بشكل افتراضي. لاستخدام علامات تبويب النموذج السحابي أيضًا (OpenAI / Gemini / Claude)، ستحتاج إلى شيئين — مفتاح API و اسم نموذج:

• مفتاح API — يمكن إدخاله وقت التشغيل عبر صفحة Lab Setup داخل التطبيق، أو تعيينه في .env (OPENAI_API_KEY=...). المفتاح المُدخل عبر Lab Setup له الأولوية.
• اسم النموذج — لا توجد واجهة مستخدم له؛ يجب أن يأتي من .env. لا يوجد إعداد افتراضي في الكود، لذا تفشل الاستدعاءات برسالة LLM Provider NOT provided إذا لم يتم تعيينه.

أنشئ .env من القالب وأزل التعليق عن سطر النموذج:

cp .env.example .env
# then edit .env and set, for example:
#   OPENAI_MODEL=gpt-4o-mini
#   (or LITELLM_MODEL=gemini/gemini-2.5-flash, etc.)

أعد تشغيل التطبيق بعد تعديل .env. للحصول على شرح كامل للمزوّد/النموذج، راجع مضيفو ورش العمل: اختيار OpenAI أو Claude أو Gemini أو نماذج سحابية أخرى.

الخيار 1: Docker (PwnzzAI + Ollama)

استخدم هذا الخيار إذا كنت تريد أن يشغّل Docker كلاً من تطبيق PwnzzAI وOllama نيابة عنك.

1. ابدأ تشغيل الحاويتين:

docker compose up -d

2. تحقق من أن كلا الخدمتين تعملان:

docker compose ps

3. افتح التطبيق في متصفحك:

http://localhost:8080

4. داخل التطبيق، انتقل إلى صفحة Basics وشغّل إعداد Ollama لسحب النماذج.

5. تابع السجلات إذا لزم الأمر:

# App logs
docker compose logs -f pwnzzai-app

# Ollama logs (optional)
docker compose logs -f ollama

6. أوقف كل شيء عند الانتهاء:

docker compose down

7. إعادة تعيين كاملة اختيارية (تزيل أيضًا نماذج Ollama المحفوظة):

docker compose down -v

إذا نشرت صورة التطبيق تحت مسار سجل آخر، فاستبدل اسم الصورة عند البدء:

PWNZZAI_IMAGE=ghcr.io/owasp/pwnzzai:latest docker compose up -d

إذا لم يتم سحب الصورة الافتراضية (البناء محليًا)

يستخدم docker compose الصورة الافتراضية pwnzzai-app من docker-compose.yml (قابلة للاستبدال بواسطة PWNZZAI_IMAGE). إذا فشل docker compose up برسالة denied أو unauthorized أو ما شابه ذلك عند سحب تلك الصورة، فقد يتطلب السجل تسجيل الدخول أو قد لا يمتلك حسابك صلاحية السحب. لا يزال بإمكانك تشغيل كل شيء من هذا المستودع عن طريق بناء صورة التطبيق محليًا وتوجيه compose إليها.

من جذر المستودع:

docker build -t pwnzzai-local:dev .
PWNZZAI_IMAGE=pwnzzai-local:dev docker compose up -d

Windows PowerShell:

docker build -t pwnzzai-local:dev .
$env:PWNZZAI_IMAGE="pwnzzai-local:dev"; docker compose up -d

ثم افتح http://localhost:8080. قد يفشل التحميل الأول لفترة وجيزة أثناء بدء تشغيل Flask داخل الحاوية؛ انتظر بضع ثوانٍ وأعد التحديث إذا رأيت خطأ في الاتصال.

إذا كنت تملك صلاحية الوصول إلى صورة السجل، يمكنك المصادقة أولاً (مثال لـ GitHub Container Registry):

docker login ghcr.io

ينطبق نهج PWNZZAI_IMAGE=pwnzzai-local:dev نفسه على الخيار 2 إذا كنت تستخدم docker-compose.external-ollama.yml وواجهت نفس خطأ السحب.

الخيار 2: Docker (Ollama خاص بك + صورة PwnzzAI)

استخدم هذا الخيار إذا كان Ollama يعمل بالفعل في مكان آخر وتريد فقط تشغيل PwnzzAI في Docker.

إذا كنت تشغّل Ollama على WSL وPwnzzAI في Docker، فراجع OLLAMA_CONNECTION_TROUBLESHOOTING.md للحصول على إصلاحات الاتصال (Connection refused، host.docker.internal، الربط، والتحقق من المتغيرات البيئية).

1. أبقِ خدمة Ollama لديك قيد التشغيل.

2. إذا كان Ollama على جهاز بعيد، عيّن OLLAMA_HOST قبل البدء (تخطَّ هذه الخطوة إذا كان Ollama على نفس جهاز Docker ويمكن الوصول إليه عبر العنوان الافتراضي في docker-compose.external-ollama.yml، وهو http://host.docker.internal:11434).

Linux/macOS:

export OLLAMA_HOST=http://your-ollama-server:11434

Windows PowerShell:

$env:OLLAMA_HOST="http://your-ollama-server:11434"

3. شغّل PwnzzAI باستخدام ملف compose الخاص بـ Ollama الخارجي:

docker compose -f docker-compose.external-ollama.yml up -d

إذا لم يتم سحب صورة التطبيق الافتراضية من GHCR، فابنِها محليًا وعيّن PWNZZAI_IMAGE كما في إذا لم يتم سحب الصورة الافتراضية (البناء محليًا).

4. افتح http://localhost:8080 في متصفحك لرؤية التطبيق. ابدأ من صفحة Basic وجهّز مختبرك.