फ्रेमवर्क-जागरूक स्थैतिक कोड विश्लेषण उपकरण जो प्लेटफ़ॉर्म-विशिष्ट नियमों, टेंट विश्लेषण, प्रयास अनुमान और दमन आधार रेखाओं के साथ स्वचालित स्रोत कोड समीक्षा के लिए है।
Author:
- Debasis Mohanty ([email protected])
- Twitter / X: @coffeensecurity
- www.coffeeandsecurity.com
Daksh SCRA (Source Code Review Assist) को स्रोत कोड समीक्षा प्रक्रिया की दक्षता बढ़ाने के लिए बनाया गया है, जो कोड समीक्षकों के लिए एक सुव्यवस्थित और संगठित दृष्टिकोण प्रदान करता है।
हर चीज़ को बिना सोचे-समझे संभावित समस्या के रूप में चिह्नित करने के बजाय, Daksh SCRA विचारशील विश्लेषण को बढ़ावा देता है, और संभावित समस्याओं की जाँच और पुष्टि करने का आग्रह करता है। यह दृष्टिकोण हर संभावित चिंता को बग के रूप में टैग करने की जल्दबाज़ी को कम करता है, जिससे भ्रम और गलत सकारात्मक परिणामों पर बर्बाद होने वाले समय में कमी आती है।
Daksh SCRA को पहली बार Black Hat USA 2022 (6-9 अगस्त) में एक स्रोत कोड समीक्षा प्रशिक्षण सत्र के दौरान पेश किया गया था, जहाँ इसे एक विशिष्ट दर्शक वर्ग के सामने सूक्ष्म रूप से प्रस्तुत किया गया। इसकी आधिकारिक सार्वजनिक शुरुआत लास वेगास में Black Hat USA 2023 में हुई।
DakshSCRA मैन्युअल स्रोत कोड समीक्षा के लिए विशिष्ट क्षमताओं को एक साथ लाता है, जो फ़ाइल-पथ रुचि के क्षेत्रों और प्रयास अनुमान से लेकर सॉफ़्टवेयर टोही, प्रासंगिक नियमों और क्रॉस-फ़ाइल विश्लेषण तक फैली हुई हैं।
| विशेषता | टैग | यह क्यों मायने रखता है |
|---|---|---|
| फ़ाइल पथ रुचि के क्षेत्र | विश्व का पहला* | कोड के साथ-साथ फ़ाइल और निर्देशिका नामों को भी स्कैन करता है, ताकि बैकअप फ़ाइलों, डिबग एंडपॉइंट्स, कॉन्फ़िगरेशन डंप और क्रेडेंशियल फ़ाइलों जैसे संदिग्ध पथों को चिह्नित किया जा सके, जिन्हें समीक्षक अक्सर अनदेखा कर देते हैं। |
| वैज्ञानिक प्रयास अनुमान | विश्व का पहला* | कोडबेस के आकार और परियोजना संकेतों के आधार पर मैन्युअल-समीक्षा प्रयास का मात्रात्मक अनुमान प्रदान करता है। कॉन्फ़िगर करने योग्य मान्यताएँ एंगेजमेंट योजना को स्पष्ट और दोहराने योग्य बनाती हैं। |
| सॉफ़्टवेयर टोही | विश्व का दूसरा* | स्कैनिंग से पहले फ़ाइल सामग्री और परियोजना संरचना से भाषाओं, फ़्रेमवर्क और अवसंरचना का पता लगाता है। प्रौद्योगिकी सूची को स्वचालित नियम चयन, सिमेंटिक विश्लेषण और समीक्षा योजना से जोड़ता है। |
| उन्नत सिमेंटिक और क्रॉस-फ़ाइल विश्लेषण | रिलीज़ के समय सबसे उन्नत ओपन सोर्स* | समर्पित विश्लेषण का उपयोग करके समर्थित फ़ाइल सीमाओं के पार उपयोगकर्ता-नियंत्रित डेटा को स्रोत से सिंक तक ट्रेस करता है। उन्नत विश्लेषण मार्च 2026 में मूल RDL के साथ जारी किया गया था; RDL v2 फ़ाइलों के पार सिमेंटिक नियम मूल्यांकन का विस्तार करता है। |
| विशेषता / मील का पत्थर | तिथि | रिलीज़ | प्रमाण / दायरा |
|---|---|---|---|
| प्रारंभिक बीटा और फ़ाइल-पथ नियम | 22 अक्टूबर 2022 | v0.1-beta | प्रारंभिक रिलीज़; संरक्षित स्रोत में समर्पित फ़ाइल-पथ नियम सूची शामिल है। |
| सॉफ़्टवेयर टोही (प्रकाशित परिचय) | 9 जुलाई 2023 | v0.3-beta | रिलीज़ नोट्स recon का परिचय देते हैं; पहले का रिपॉज़िटरी कोड अलग कार्यान्वयन प्रमाण है। |
| मैन्युअल-समीक्षा प्रयास अनुमान (कार्यान्वयन) | 29 जुलाई 2023 | कार्यान्वयन कमिट | समर्पित अनुमान मॉड्यूल जोड़ा गया; यह बाद के फ़िक्स रिलीज़ की तिथि नहीं है। |
| मूल RDL और अंतर-फ़ाइल उन्नत विश्लेषण | 2 मार्च 2026 | v0.31-beta | सशर्त नियम तर्क और स्वतंत्र क्रॉस-फ़ाइल विश्लेषण एक साथ जारी किए गए। रिलीज़ प्रदर्शन तिथि 2 मार्च है; प्रकाशन टाइमस्टैम्प 1 मार्च 2026 को 18:39 UTC है। |
तिथियाँ रिपॉज़िटरी या रिलीज़ मील के पत्थरों की पहचान करती हैं।
DakshSCRA को Black Hat USA 2022 प्रशिक्षण के दौरान पेश किया गया था और इसने Black Hat USA 2023 में सार्वजनिक रूप से शुरुआत की। ये तिथियाँ परियोजना की शुरुआत का वर्णन करती हैं, न कि हर वर्तमान सुविधा का।
सक्रिय संवर्द्धन जारी हैं। आगामी रिलीज़ के लिए कई नई सुविधाएँ और सुधार योजनाबद्ध हैं।
नए नियमों और भविष्य के विकास को अद्यतन करने या जोड़ने में योगदान देने के लिए स्वतंत्र महसूस करें।
यदि आपको कोई बग मिलता है, तो उन्हें [email protected] पर रिपोर्ट करें।
विस्तृत दस्तावेज़ीकरण: https://dakshlabs.com/#docs
Daksh SCRA चलाने के दो तरीके हैं - जो भी आपके वर्कफ़्लो में फिट बैठे उसे चुनें:
| किसके लिए सर्वोत्तम | यहाँ जाएँ | |
|---|---|---|
| 🌐 Web UI (Docker) | शुरुआत करने का सबसे आसान तरीका - एक कमांड, एक ब्राउज़र डैशबोर्ड, लाइव स्कैन प्रगति, और एक रिपोर्ट/आर्टिफ़ैक्ट ब्राउज़र। अधिकांश उपयोगकर्ताओं के लिए अनुशंसित। | Web UI (Docker) |
| 💻 CLI (Python) | स्क्रिप्टिंग, CI पाइपलाइन, या Docker के बिना स्कैन चलाना। | CLI Setup |
दोनों मार्ग बिल्कुल वही स्कैनिंग इंजन चलाते हैं - Web UI उसी CLI के ऊपर एक ब्राउज़र फ्रंट एंड है, इसलिए दोनों तरह से परिणाम समान होते हैं।
Daksh SCRA चलाने का सबसे तेज़ तरीका इसका ब्राउज़र-आधारित Web UI है, जिसे होस्ट-अवेयर Docker स्टार्टअप हेल्पर के माध्यम से लॉन्च किया जाता है। यह आपको एक स्कैन लॉन्चर, एक लाइव कंसोल फ़ीड, और पिछली रिपोर्टों का ब्राउज़ करने योग्य इतिहास देता है। स्टार्टअप हेल्पर को Python 3 चाहिए (केवल मानक लाइब्रेरी); एप्लिकेशन और इसकी निर्भरताएँ Docker में चलती हैं।
Docker सेटअप Web UI और CLI को एक ही इमेज से बनी स्वतंत्र सेवाओं के रूप में चलाता है, इसलिए आप एक ही कंटेनर से इनमें से किसी एक (या दोनों) का उपयोग कर सकते हैं।
GitHub से Daksh SCRA डाउनलोड करने के बाद, पहले ZIP संग्रह को निकालें।
निकाले गए प्रोजेक्ट फ़ोल्डर के अंदर एक टर्मिनल (Windows पर PowerShell या Command Prompt) खोलें
जिसमें docker-compose.yml और dakshscra.py शामिल हैं।
नीचे दिए गए सभी स्टार्टअप और Docker Compose कमांड उसी फ़ोल्डर से चलाएँ।
यदि आपका टर्मिनल कहीं और खुलता है, तो पहले निकाले गए फ़ोल्डर में जाएँ:
cd "path/to/extracted/DakshSCRA-folder"
उदाहरण पथ को अपने वास्तविक डाउनलोड स्थान और फ़ोल्डर नाम से बदलें।
यदि आपने इसके बजाय रिपॉज़िटरी को क्लोन किया है, तो उसके पैरेंट फ़ोल्डर से cd DakshSCRA चलाएँ।
स्टार्टअप हेल्पर Windows, WSL, Linux और macOS को पहचानता है, फिर कंटेनर शुरू करने से पहले होस्ट रूट, उपलब्ध Windows ड्राइव और सामान्य फ़ोल्डरों को केवल-पढ़ने के लिए माउंट करता है। इसे Docker चला रहे कंप्यूटर पर चलाएँ।
Linux, macOS या WSL (फ़ोरग्राउंड):
python3 tools/start_webui.py
Windows PowerShell या Command Prompt (foreground):
py tools/start_webui.py
डिटैच्ड (बैकग्राउंड) मोड में चलाने के लिए, --detach जोड़ें। स्टार्टअप कमांड लौटने के बाद भी कंटेनर चलते रहते हैं, जिससे आपका टर्मिनल उपलब्ध रहता है।
Linux, macOS या WSL (डिटैच्ड):
python3 tools/start_webui.py --detach
Windows PowerShell या Command Prompt (detached):
py tools/start_webui.py --detach
--dry-run का उपयोग कंटेनर शुरू किए बिना पहचाने गए पथों का निरीक्षण करने के लिए करें।
मौजूदा .env पथ ओवरराइड का सम्मान किया जाता है। कंटेनर फिर से बनाए जाने पर खाते, स्कैन और रनटाइम
वॉल्यूम संरक्षित रहते हैं।
Docker Desktop को चयनित होस्ट पथों को साझा करने की अनुमति की आवश्यकता हो सकती है। यदि यह किसी माउंट को अस्वीकार करता है, तो Docker Desktop में उस स्थान को अनुमति दें और हेल्पर को फिर से चलाएँ। एक रिमोट ब्राउज़र Docker होस्ट के फ़ोल्डर देखता है, अपने स्वयं के कंप्यूटर के ड्राइव नहीं। स्वचालित पहचान के लिए स्थानीय Docker इंजन आवश्यक है; रिमोट Docker कॉन्टेक्स्ट का उपयोग करते समय हेल्पर को इंजन होस्ट पर चलाएँ।