यदि आप Artemis को संशोधित/विकसित करना चाहते हैं, तो पहले Development पढ़ें।

Artemis प्रायोगिक सॉफ्टवेयर है, सक्रिय विकास के अंतर्गत - अपने जोखिम पर उपयोग करें।

Artemis के बारे में चर्चा करने के लिए, Discord सर्वर में शामिल हों!

सहयोग और सम्मेलन

Artemis को लास वेगास में BlackHat USA 2024 और लंदन में BlackHat Europe 2025 में प्रस्तुत किया गया था। BlackHat में Artemis के बारे में अधिक जानकारी के लिए यहाँ क्लिक करें और यहाँ.

यह परियोजना कोपेनहेगन में 71वें TF-CSIRT मीटिंग, बुखारेस्ट में 69वें TF-CSIRT मीटिंग और CONFidence सम्मेलन सहित अन्य में भी प्रस्तुत की गई थी।

सहयोग

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 के लिए, आप पूरे कंटेनर को रीलोड किए बिना पृष्ठ पर कोड संशोधनों के परिणाम भी देख पाएंगे।

परीक्षण

परीक्षण चलाने के लिए, उपयोग करें:

[!चेतावनी] python -m unittest को सीधे docker-compose.test.yaml में command: के रूप में उपयोग करने से बचें। जब Python PID 1 के रूप में चलता है, तो सबप्रोसेस, विशेष रूप से Nuclei जैसे Go बायनेरीज़, धीमे या खराब I/O से पीड़ित होते हैं क्योंकि 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. फ्रोज़न requirements.txt फ़ाइल(फ़ाइलें) उत्पन्न करने के लिए ./scripts/compile-requirements चलाएँ,
3. .in और .txt दोनों फ़ाइलों को कमिट करें।

दस्तावेज़ बनाना

दस्तावेज़ बनाने के लिए, उपयोग करें:

मैं अपना खुद का मॉड्यूल कैसे लिखूँ?

कृपया दस्तावेज़ीकरण देखें।

योगदान

योगदान का स्वागत है! हम नए Artemis मॉड्यूल के विचारों (जिन्हें GitHub issues के रूप में जोड़ा गया है) और नए मॉड्यूल या कोड सुधारों के साथ पुल अनुरोधों दोनों की सराहना करेंगे।

भले ही यह स्पष्ट लगे, हम विनम्रतापूर्वक आपको याद दिलाते हैं कि Artemis में योगदान करके, आप सहमत होते हैं कि BSD 3-Clause License आपके इनपुट पर स्वचालित रूप से लागू होगा, बिना किसी अतिरिक्त घोषणा की आवश्यकता के।

विकास

PR खोलने से पहले कृपया pre-commit स्थापित करना सुनिश्चित करें:

• pre-commit install

और इसे अपने परिवर्तनों के विरुद्ध चलाएँ।

योगदानकर्ता

उन सभी लोगों का बहुत-बहुत धन्यवाद जिन्होंने Artemis विकास में योगदान दिया, विशेष रूप से KN Cyber विज्ञान क्लब, वारसॉ विश्वविद्यालय प्रौद्योगिकी जिसने इस परियोजना की शुरुआत की!