معلومة: هذا الدليل مخصص للمستخدمين ذوي الاحتياجات الخاصة، الذين يريدون تجربة جاهزة وبسيطة.

يأتي كل إصدار في مجلد باسم riotpot مع ملف تنفيذي ثنائي (أيضًا) باسم riotpot ومجلد plugins مملوء بالعديد من الخدمات (أو الأوعية منخفضة التفاعل). من المهم الحفاظ على بنية المجلد الداخلية لكي يعمل RIoTPot كما هو مقصود.

📁 riotpot
    ┕ riotpot
    ┕ 📁 plugins

1. أولاً، قم بتنزيل الإصدار الذي تفضله من صفحة الإصدارات. اختر الإصدار الذي يناسب نظام التشغيل الخاص بك.
2. قم باستخراج مجلد riotpot.
3. قم بتشغيل الملف التنفيذي riotpot. سيؤدي ذلك إلى بدء تشغيل RIoTPot مع تمكين واجهة API، وجميع الملحقات جاهزة للاستخدام، وخادم الواجهة الرسومية.
   • يمكن الوصول إلى واجهة API والواجهة الرسومية عبر العنوان localhost:2022

معلومة: هذا الدليل مخصص للمستخدمين المتقدمين والمريحين في بيئات التطوير.

المتطلبات

• Golang - مطلوب لبناء المشروع
• Node - مطلوب لبناء الواجهة الرسومية

اختياري:

• Git - يستخدم لتنزيل الكود المصدري
• Make - لتشغيل الأوامر المُعدة مسبقًا

1. قم بتنزيل الكود المصدري لـ RIoTPot من GitHub. افتح وحدة تحكم وأدخل السطر التالي.

   root@kitploit:~

   git clone [email protected]:aau-network-security/riotpot.git
   

2. انتقل إلى المجلد الذي قمت بتنزيل الكود المصدري لـ RIoTPot فيه وقم بتثبيت حزم Node المطلوبة.

   root@kitploit:~

   npm install
   

3. إذا كان لديك Make مثبتًا، فقد قمنا بتضمين العديد من مساعدات الأوامر لمساعدتك في بناء المشروع. ببساطة، يمكنك تشغيل أمرين بسيطين سيبنيان الملف الثنائي لـ RIoTPot والملحقات (ويضعانها في المجلد الصحيح).

   root@kitploit:~

   # بناء الخادم
   make build-ui
   # بناء RIoTPot والملحقات
   make riotpot-build
   

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

معلومة: هذا الدليل مخصص للمستخدمين المتقدمين الذين يفضلون استخدام RIoTPot في بيئة افتراضية.

المتطلبات

• Docker - يستخدم لبناء صورة لمثيل RIoTPot وخادم الواجهة الرسومية.
• Docker-compose - يستخدم لإنشاء حاوية واحدة تحتوي على مثيل RIoTPot والواجهة الرسومية والتطبيقات والخدمات الأخرى.

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

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

تحذير: من الناحية الفنية، قد يدرك المهاجم المخصص أن RIoTPot هو في الواقع وعاء من خلال تحليل ومقارنة تأخيرات وقت الاستجابة التي تقدمها الافتراضية مع الخوادم الحقيقية (!!). بينما تمت دراسة هذا النوع من بصمات الأوعية من قبل، فإن النتائج لخدمات الإنترنت الشائعة لا تزال غير حاسمة (مثل HTTP وTelnet وSSH)، بسبب تسليع خدمات الاستضافة السحابية باستخدام الآلات الافتراضية والتكوينات التفصيلية للخوادم.

يتضمن ملف docker-compose خدمات إضافية لتعزيز تجربة RIoTPot. يلخص الجدول التالي قائمة الخدمات والتطبيقات المجمعة في هذه الحاوية.

الخدمات