إذا كنت ترغب في تعديل/تطوير Artemis، اقرأ التطوير أولاً.

Artemis هو برنامج تجريبي، قيد التطوير النشط - استخدمه على مسؤوليتك الخاصة.

للدردشة حول Artemis، انضم إلى خادم Discord!

التعاون والمؤتمرات

تم تقديم Artemis في BlackHat USA 2024 في لاس فيغاس وBlackHat Europe 2025 في لندن. لمزيد من المعلومات حول Artemis في BlackHat انقر هنا وهنا.

كما تم تقديم المشروع في الاجتماع 71 لـ TF-CSIRT في كوبنهاغن، والاجتماع 69 لـ TF-CSIRT في بوخارست ومؤتمر CONFidence ، من بين آخرين.

Cooperation

تم دعم تطوير Artemis من قبل Google Summer of Code 2024 و2025.

الميزات

للحصول على قائمة محدثة بالميزات، يرجى الرجوع إلى الوثائق. أهمها هي إمكانية تصدير التقارير بسهولة مثل:

العناوين التالية تحتوي على بيانات نظام التحكم في الإصدارات:

• https://subdomain1.example.com:443/.git/

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

العناوين التالية تحتوي على إصدارات قديمة من Joomla:

• https://subdomain2.example.com:443 - Joomla 2.5.4

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

أتاحت لنا إمكانية إعداد مثل هذه التقارير تلقائيًا إخطار الكيانات في دائرتنا الانتخابية حول مئات الآلاف من الثغرات.

لقطات الشاشة

التطوير

لتشغيل نسخة معدلة محليًا من Artemis، شغّل:

يقوم هذا البرنامج النصي بنسخ ملف البيئة النموذجي (env.example) تلقائيًا إلى .env إذا لم يكن موجودًا. يمكنك بعد ذلك تهيئة الإعدادات في ملف .env وفقًا لاحتياجاتك. يتضمن ذلك تخصيص وكيل المستخدم عن طريق تعيين متغير CUSTOM_USER_AGENT، بالإضافة إلى معايير أخرى ذات صلة. للحصول على قائمة كاملة بمتغيرات التهيئة وأوصافها، يرجى الرجوع إلى قسم التهيئة في الوثائق.

ثم يتم بناء صورة Artemis محليًا (من الكود الذي تطوره) وليس تنزيلها من Docker Hub. بالنسبة لـ web، ستتمكن أيضًا من رؤية نتائج تعديلات الكود على الصفحة دون إعادة تحميل الحاوية بأكملها.

الاختبارات

لتشغيل الاختبارات، استخدم:

[!WARNING] تجنب استخدام python -m unittest مباشرة كـ command: في docker-compose.test.yaml. عندما يعمل Python كـ PID 1، تعاني العمليات الفرعية، خاصة ملفات Go الثنائية مثل Nuclei، من بطء أو تدهور في الإدخال/الإخراج لأن PID 1 يتعامل مع الإشارات و stdout/stderr بشكل مختلف. استخدم unittest-parallel بدلاً من ذلك، لأن عمليات العامل الخاصة به تتجنب مشكلة PID 1.

تنسيق الكود

يستخدم Artemis pre-commit لتشغيل المدققات وتنسيق الكود. يتم تنفيذ pre-commit على CI للتحقق من أن الكود منسق بشكل صحيح.

لتشغيله محليًا، استخدم:

لإعداد pre-commit بحيث يتم تشغيله قبل كل التزام، استخدم:

تعديل التبعيات

نستخدم pip-tools لإدارة التبعيات. لإضافة أو تحديث تبعية:

1. قم بتعديل requirements.in (أو docs/requirements.in لتبعيات التوثيق)،
2. قم بتشغيل ./scripts/compile-requirements لإنشاء ملف(ملفات) requirements.txt المجمدة،
3. قم بالتزام كلا من ملفي .in و .txt.

بناء الوثائق

لبناء الوثائق، استخدم:

كيف أكتب وحدتي الخاصة؟

يرجى الرجوع إلى الوثائق.

المساهمة

نرحب بالمساهمات! سنقدر كل من الأفكار لوحدات Artemis الجديدة (المضافة كـ قضايا GitHub) وكذلك طلبات السحب مع وحدات جديدة أو تحسينات في الكود.

ومع أنه قد يبدو واضحًا، نذكرك بلطف أنه بالمساهمة في Artemis، فإنك توافق على أن ترخيص BSD 3-Clause ينطبق تلقائيًا على مدخلاتك، دون الحاجة إلى أي تصريحات إضافية.

التطوير

قبل فتح طلب السحب، يرجى التأكد من تثبيت pre-commit:

• pre-commit install

وتشغيله على تغييراتك.

المساهمون

شكر جزيل للأشخاص التاليين الذين ساهموا في تطوير Artemis، وخاصة نادي KN Cyber العلمي في جامعة وارسو للتكنولوجيا الذي بدأ المشروع!