ICS/OT प्रोटोकॉल के लिए सुरक्षा-प्राथमिकता वाला भेद्यता स्कैनर।
ICS/OT प्रोटोकॉल के लिए एक सुरक्षा-प्राथमिकता वाला भेद्यता स्कैनर। यह डिवाइसों की पहचान करता है और उन्हें ज्ञात CVE और असुरक्षित डिफ़ॉल्ट के विरुद्ध जाँचता है — सक्रिय रूप से (एक स्पष्ट, अधिकृत लक्ष्य सूची की जाँच करके) या निष्क्रिय रूप से (SPAN/TAP या pcap पढ़कर और कुछ भी प्रसारित किए बिना) — निष्कर्षों को CVE से सहसंबंधित करता है, और Zeek, Suricata, Sigma, और Splunk के लिए तैनात करने योग्य डिटेक्शन सामग्री उत्पन्न कर सकता है।
जिम्मेदार उपयोग। icsScanner लाइव औद्योगिक प्रणालियों को सक्रिय प्रोब और प्रमाणीकरण प्रयास भेज सकता है, जहाँ अप्रत्याशित ट्रैफ़िक भौतिक प्रक्रियाओं को बाधित कर सकता है। केवल उन्हीं डिवाइसों को स्कैन करें जिनके आप स्वामी हैं या जिन्हें परीक्षण के लिए स्पष्ट रूप से अधिकृत किया गया है। सक्रिय जाँचें डिफ़ॉल्ट रूप से बंद हैं (सुरक्षित मोड केवल फ़िंगरप्रिंट रिपोर्ट करता है); निष्क्रिय मोड (
discover sniff) कुछ भी प्रसारित नहीं करता और लाइव OT नेटवर्क पर सही विकल्प है। देखें SECURITY.md।
जाँच संग्रह कई ICS/OT प्रोटोकॉल में फैला है। अधिकांश जाँचें फ़ैक्टरी-डिफ़ॉल्ट क्रेडेंशियल और असुरक्षित
डिफ़ॉल्ट को लक्षित करती हैं; CVE-सहसंबंध उम्मीदवार संरचित भेद्यता फ़ीड से बनाए जाते हैं — ICS Advisory
Project, जापान का MyJVN, CISA के CSAF 2.0 OT सलाहकार, और ENISA का EU Vulnerability Database। रिपोर्टिंग
JSONL + एक टेक्स्ट सारांश है, जिसमें HTML / CSV / SVG निर्यात है। पूरी जानकारी के लिए 04-USAGE-GUIDE.md देखें, या
संक्षिप्त संस्करण के लिए नीचे "Running a scan" देखें।
पूर्व-कला अनुसंधान ने वास्तविक ICS/OT भेद्यता-स्कैनिंग कवरेज अंतराल पाए: Nessus का SCADA प्लगइन परिवार परिपक्व है लेकिन बंद/व्यावसायिक है; Nuclei और Metasploit की ICS सामग्री पतली है; nmap NSE फ़िंगरप्रिंटिंग को अच्छी तरह कवर करता है लेकिन इसमें CVE-स्तरीय जाँचें नहीं हैं। ICS के लिए कोई भी खुली, सुरक्षा-प्राथमिकता वाली, सक्रिय रूप से विस्तारणीय सक्रिय-CVE-जाँच परत नहीं है। icsScanner उस अंतराल को भरता है।
| फ़ाइल | उद्देश्य |
|---|---|
00-PROJECT-CHARTER.md | दायरा, निर्णय, चरणबद्ध माइलस्टोन (0–5), LOE |
01-METHODOLOGY-AND-CHECKLISTS.md | सुरक्षित सक्रिय-जाँच विकास विधि + "क्या यह एक सुरक्षित जाँच है?" गेट |
02-DISCLOSURE-PLAYBOOK.md | अपस्ट्रीम निष्कर्षों को सुरक्षित रूप से उपभोग करने के लिए disclosure_status अनुबंध |
03-STYLE-AND-DECISIONS.md | पहचान, नामकरण, और अभी-के-लिए-निजी प्रकाशन निर्णय |
04-USAGE-GUIDE.md | पूरी जानकारी: CLI + वेब UI, लक्ष्य इन्वेंटरी/स्कैन नीति प्रारूप, सुरक्षा मॉडल, API संदर्भ, समस्या निवारण |
lab-notes/gap-survey-and-prior-art.md | 2026-08-12 पूर्व-कला सर्वेक्षण (Nessus, Nuclei, Metasploit, nmap NSE, geeknik/scada-scanner, ICS Advisory Project) |
lab-notes/check-inventory.md | अपने स्वयं के निष्कर्षों (दोनों सहोदर परियोजनाओं) का नियोजित जाँचों से मानचित्रण, प्रकटीकरण स्थिति सहित |
lab-notes/default-credentials-sweep.md | डिफ़ॉल्ट-क्रेडेंशियल स्वीप का चरण-दर-चरण लॉग — 98 जाँचों की अधिकांश उत्पत्ति कथा |
core/ | इंजन — रजिस्ट्री, लक्ष्य/नीति लोडिंग, सुरक्षा/थ्रॉटलिंग परत, लॉगिंग, रिपोर्टिंग |
core/passive.py / core/detect_match.py / core/detections.py | शून्य-प्रसारण निष्क्रिय मोड — कैप्चर/विच्छेदन/इन्वेंटरी, नेटिव डिटेक्शन मिलान, Observed-Activity रिपोर्ट अनुभाग |
checks/ | जाँच रजिस्ट्री सामग्री, प्रोटोकॉल द्वारा संगठित; checks/candidates/ में अनुसंधान-चरण स्टब्स हैं, जो कभी निष्पादन योग्य नहीं होते |
detection-gen/ | उसी checks/ detection_hints से तैनात करने योग्य डिटेक्शन (Sigma / Splunk-ESCU / Suricata / Zeek सिग्नेचर + ATT&CK-for-ICS नीति) उत्पन्न करता है |
icsscanner.py | CLI ड्राइवर — सक्रिय scan और निष्क्रिय discover sniff; ऊपर देखें |
icsscanner-web.py / web/ | वेब UI — उसी इंजन पर एक स्थानीय नियंत्रण पैनल |
templates/ | उदाहरण लक्ष्य-इन्वेंटरी और स्कैन-नीति YAML फ़ाइलें |
lab-notes/passive-mode.md | निष्क्रिय-मोड आर्किटेक्चर + TSA सिस्टम-आवश्यकताएँ (PNNL OT-IDS डेटासेट से आकार निर्धारण) |
इसे चलाने के तीन तरीके हैं, जिन्हें इस आधार पर समूहित किया गया है कि वे नेटवर्क को कितना छूते हैं। जो चुनें जो लक्ष्य वातावरण अनुमति देता है — ट्रांसमिट पोस्चर ही सुरक्षा-महत्वपूर्ण अंतर है:
| मोड | ट्रांसमिट करता है? | कब उपयोग करें | कमांड |
|---|---|---|---|
| Passive | नहीं — केवल RX, शून्य पैकेट (discover sniff) | लाइव OT जहाँ सक्रिय प्रोबिंग की अनुमति नहीं है (सुरक्षा, नाज़ुक लीगेसी डिवाइस, परिवर्तन नियंत्रण) | discover sniff (SPAN/TAP/pcap/Zeek-logs); discover passive (ARP-listen + Sparkplug — नीचे दी गई चेतावनी देखें) |
| Active scan | हाँ — प्रोब भेजता है, और ऑप्ट-इन लॉगिन | वे एसेट जो आपके स्वामित्व में हैं या जिन्हें परीक्षण करने की स्पष्ट लिखित अनुमति है | scan (डिफ़ॉल्ट CLI / पॉलिसी फ़ाइल / वेब UI); discover active (पहले होस्ट खोजने के लिए ARP स्वीप) |
| Malcolm interop | आपके अपने Malcolm के लिए केवल-पढ़ने वाली API कॉल | आप पहले से ही Malcolm / Hedgehog पैसिव स्टैक चलाते हैं | discover malcolm (इन्वेंटरी पढ़ें + सहसंबंधित करें; --push निष्कर्ष वापस भेजता है); discover sniff --push-malcolm (पैसिव रन के निष्कर्ष पुश करें) |
प्रत्येक मोड का विवरण नीचे दिया गया है। scan और discover sniff प्राथमिक कमांड हैं; discover active /
discover passive Active / Passive मोड के भीतर द्वितीयक डिस्कवरी सहायक हैं। Safe mode
(केवल-फ़िंगरप्रिंट, कोई विनाशकारी जाँच नहीं) डिफ़ॉल्ट है हर उस मोड में जो ट्रांसमिट कर सकता है।
पूरा विवरण 04-USAGE-GUIDE.md में है। संक्षिप्त संस्करण — प्रवेश के तीन तरीके, सभी एक ही इंजन चलाते हैं:
# Ad hoc CLI: just point at a target inventory, optionally narrow by protocol/check-id.
python3 icsscanner.py --inventory templates/target-inventory.example.yaml --protocol http
# Policy-file CLI: bundles target inventory + check selection + rate profile + output dir into
# one reusable YAML (00-PROJECT-CHARTER.md § Scope — the decided invocation model). CLI flags
# below still override individual policy fields for a one-off tweak.
python3 icsscanner.py --policy templates/scan-policy.example.yaml
# Web UI: a form + run view at http://127.0.0.1:8807/ — same policy/inventory model, same
# safe-mode default, a two-step confirm click in place of the CLI's interactive prompt.
python3 icsscanner-web.py
संपादन से पहले templates/target-inventory.example.yaml (और वैकल्पिक रूप से templates/scan-policy.example.yaml) की प्रतिलिपि बनाएँ — सीधे टेम्पलेट से स्कैन न करें। केवल उन्हीं डिवाइसों की सूची बनाएँ जिनका आप स्वामी हैं या जिन्हें परीक्षण करने की स्पष्ट लिखित अनुमति आपके पास है। प्रत्येक लक्ष्य एक सटीक host: है — एक IP या FQDN, कभी भी CIDR रेंज नहीं; यह एक जानबूझकर लिया गया स्कोप निर्णय है (छोटी ज्ञात एसेट सूचियाँ, न कि नेटवर्क स्वीप टूल), कोई अनुपलब्ध सुविधा नहीं — देखें 04-USAGE-GUIDE.md।
प्रत्येक जाँच जो वास्तव में कुछ करती है (एक वास्तविक लॉगिन प्रयास, आदि) वह destructive: true है। सेफ मोड डिफ़ॉल्ट है — विनाशकारी जाँचें केवल फ़िंगरप्रिंट रिपोर्ट करती हैं और कभी नहीं चलतीं जब तक आप --include-destructive पास न करें (या किसी पॉलिसी फ़ाइल में include_destructive: true सेट न करें), और तब भी icsscanner.py को कुछ भी लाइव होने से पहले एक इंटरैक्टिव पुष्टिकरण प्रॉम्प्ट पर स्पष्ट y की आवश्यकता होती है (या इसे छोड़ने के लिए --yes/-y)। वेब UI टर्मिनल प्रॉम्प्ट के बजाय एक स्पष्ट दूसरे "Confirm and Run" क्लिक के रूप में वही चीज़ लागू करता है — पहला सबमिशन केवल दिखाता है कि क्या चलेगा। वेब UI में कोई प्रमाणीकरण भी नहीं है और इसी कारण से डिफ़ॉल्ट रूप से 127.0.0.1 (केवल localhost) पर बाइंड होता है — इसे और व्यापक रूप से उजागर करने से पहले 04-USAGE-GUIDE.md देखें।
python3 icsscanner.py --help हर फ़्लैग की सूची दिखाता है। परिणाम --output की डायरेक्टरी (डिफ़ॉल्ट ./output, पहले से gitignored) में एक टाइमस्टैम्प वाली icsscanner-*.jsonl के रूप में, साथ ही एक प्रिंटेड टेक्स्ट सारांश के रूप में आते हैं।