SentinelNav

SentinelNav एक शून्य-निर्भरता (zero-dependency), शुद्ध Python बाइनरी विज़ुअलाइज़ेशन और फोरेंसिक टूल है। यह बाइनरी डेटा को एक इंटरैक्टिव स्पेक्ट्रल मैप में बदल देता है, जिससे विश्लेषक फ़ाइल संरचनाओं, एन्ट्रॉपी विसंगतियों, कोड अनुभागों और संभावित क्रिप्टोग्राफ़िक ब्लॉब्स की दृश्य रूप से पहचान कर सकते हैं।

यह तेज़ फ़ाइल स्कैनिंग के लिए एक मल्टीप्रोसेसिंग बैकएंड को इंटरैक्टिव अन्वेषण, हेक्स निरीक्षण और आर्किटेक्चर फ़िंगरप्रिंटिंग के लिए स्थानीय वेब-आधारित फ्रंटएंड के साथ जोड़ता है।

---

त्वरित आरंभ

चूँकि SentinelNav केवल Python Standard Library पर निर्भर करता है, इसलिए किसी बाहरी पैकेज की स्थापना आवश्यक नहीं है।

1. स्क्रिप्ट को sentinelnav.py के रूप में सहेजें।
2. स्क्रिप्ट को इंटरैक्टिव मोड में चलाएँ:

python3 sentinelnav.py

3. संकेत मिलने पर टर्मिनल विंडो में लक्ष्य फ़ाइल खींचकर छोड़ें (drag and drop)।
4. अपने ब्राउज़र में http://localhost:8000 खोलें।

---

---

विशेषताएँ

मुख्य विश्लेषण

• शून्य-निर्भरता: बिना pip install के किसी भी मानक Python 3 इंस्टॉलेशन पर चलता है।
• संकर स्कैनिंग मोड (Hybrid Scanning Modes):
  • फिक्स्ड ब्लॉक (Fixed Block): फ़ाइलों को एकसमान हिस्सों में काटता है (जैसे, 1024 बाइट्स)। बाइनरी और डिस्क इमेज के लिए आदर्श।
  • सेंटिनल (Sentinel): फ़ाइलों को एक सीमांकक (delimiter) के आधार पर काटता है (जैसे, लॉग या टेक्स्ट-आधारित प्रोटोकॉल के लिए 0x0A)।
• आर्किटेक्चर फ़िंगरप्रिंटिंग (ArchID):
  • फ़ाइल हेडर (MZ, ELF, Mach-O, PDF, PNG, JPEG) का पता लगाता है।
  • कच्चे बाइनरी हिस्सों पर CPU आर्किटेक्चर (x86, x64, ARM64) का अनुमान लगाने के लिए ह्यूरिस्टिक आवृत्ति विश्लेषण करता है।
• एन्ट्रॉपी और विसंगति पहचान:
  • प्रति ब्लॉक शैनन एन्ट्रॉपी की गणना करता है।
  • "फ्लक्स" घटनाओं का पता लगाता है: अचानक वृद्धि (एन्क्रिप्शन/कोड की शुरुआत) या गिरावट (डेटा स्ट्रीम का अंत)।

विज़ुअलाइज़ेशन

• स्पेक्ट्रल मैपिंग: डेटा प्रकारों (टेक्स्ट बनाम कोड बनाम पैडिंग) को दृश्य रूप से अलग करने के लिए बाइट वितरण को RGB रंगों में मैप करता है।
• कैनवास रेंडरिंग: उच्च-प्रदर्शन HTML5 कैनवास रेंडरिंग, जो पेजिनेशन के माध्यम से लाखों हिस्सों को संभालने में सक्षम है।
• लाइव हेक्स इंस्पेक्टर: किसी भी ब्लॉक पर क्लिक करके रॉ हेक्स डंप, ASCII डिकोडिंग और ArchID विश्लेषण देखें।
• BMP निर्यात: बाहरी रिपोर्टिंग के लिए फ़ाइल की पूर्ण हीटमैप छवि उत्पन्न करें।

प्रदर्शन

• समानांतर प्रोसेसिंग: स्कैनिंग के दौरान सभी CPU कोर का उपयोग करने के लिए concurrent.futures.ProcessPoolExecutor का उपयोग करता है।
• SQLite बैकएंड: विश्लेषण परिणामों को एक अस्थायी SQLite डेटाबेस में संग्रहीत करता है, ताकि बड़ी फ़ाइलों (GB+) की कुशल पेजिनेशन और क्वेरीिंग संभव हो सके।

---

आर्किटेक्चर डिज़ाइन

SentinelNav एक Producer-Consumer आर्किटेक्चर का पालन करता है जिसमें Client-Server इंटरफ़ेस है।

1. फोरेंसिक इंजन (बैकएंड)

• स्कैनर इंटरफ़ेस:
  • फ़ाइल पढ़ने की प्रक्रिया को अमूर्त (abstract) करता है।
  • FixedScanner: पुनरावृत्त रूप से N बाइट्स पढ़ता है।
  • SentinelScanner: बफ़र में पढ़ता है और विशिष्ट बाइट्स (जैसे, नल बाइट्स या नई पंक्तियाँ) मिलने पर हिस्सों (chunks) को उत्पन्न करता है।
• वर्कर प्रोसेस:
  • Processor CPU संख्या के आधार पर वर्करों का एक पूल तैयार करता है।
  • FastMath: एन्ट्रॉपी और बाइट आवृत्ति गणनाएँ (स्पेक्ट्रल डेटा) की गणना करता है।
  • ह्यूरिस्टिक्स: यह निर्धारित करता है कि कोई हिस्सा ASCII-भारी, Null-भारी या High-Bit-भारी है।
• डेटा इंजन (भंडारण):
  • एक अस्थायी sqlite3 डेटाबेस बाइनरी फ़ाइल का एक संरचित अनुक्रमणिका बनाता है।
  • संग्रहीत करता है: Offset, Length, Entropy, RGB मान, Anomaly Scores.
  • यह टूल को माँग पर डेटा पेजिनेट करके उपलब्ध RAM से बड़ी फ़ाइलों को संभालने की अनुमति देता है।

2. वेब सर्वर

• HTTP अनुरोधों के समवर्ती संचालन के लिए http.server.ThreadingMixIn लागू करता है।
• API एंडपॉइंट्स:
  • /data: हिस्सों के डेटा (Color + Entropy) के JSON पेज लौटाता है।
  • /read: Inspector पैनल के लिए विशिष्ट हेक्स डंप।
  • /search: हेक्स अनुक्रमों के लिए भौतिक फ़ाइल को स्कैन करता है।
  • /download: रॉ बाइनरी ब्लॉब्स निकालता है या BMP विज़ुअलाइज़ेशन उत्पन्न करता है।

3. फ्रंटएंड

• सिंगल-पेज एप्लिकेशन (SPA) सीधे Python स्क्रिप्ट में एम्बेडेड है।
• रेंडरिंग: पिक्सेल-परफेक्ट ब्लॉक रेंडरिंग के लिए HTML5 Canvas API का उपयोग करता है।
• नेविगेशन: कीबोर्ड इनपुट्स (WASD) को ग्रिड समन्वय प्रणाली में मैप करने के लिए स्थानिक नेविगेशन लॉजिक लागू करता है।

---

विज़ुअल मैपिंग गाइड

यह टूल बाइनरी डेटा प्रकारों को दर्शाने के लिए एक विशिष्ट RGB एल्गोरिदम का उपयोग करता है।

रंग	घटक	अर्थ
लाल	उच्च बिट	बाइट्स 0x80 - 0xFF. संकलित मशीन कोड, संपीड़ित डेटा, एन्क्रिप्टेड ब्लॉब्स या इमेज डेटा को दर्शाता है।
हरा	ASCII	बाइट्स 0x20 - 0x7E. सादा पाठ, स्रोत कोड, JSON, XML या लॉग को दर्शाता है।
नीला	नियंत्रण	बाइट्स 0x00 - 0x1F. नल पैडिंग, हेडर या प्रोटोकॉल नियंत्रण वर्णों को दर्शाता है।

सामान्य पैटर्न:

• चमकीला हरा: टेक्स्ट फ़ाइल या स्रोत कोड।
• गुलाबी/बैंगनी: मिश्रित कोड और डेटा (निष्पादन योग्य अनुभाग)।
• ठोस नीला: शून्य-भरा पैडिंग या खाली स्थान।
• स्थिर/धूसर: उच्च एन्ट्रॉपी शोर (एन्क्रिप्टेड डेटा)।

---

स्थापना

पूर्वापेक्षाएँ

• Python 3.6 या उच्चतर।

सेटअप

किसी भी लाइब्रेरी को स्थापित करने की आवश्यकता नहीं है। बस फ़ाइल डाउनलोड करें।

# Clone or download the script
wget https://raw.githubusercontent.com/smolfiddle/SentinelNav/main/sentinelnav.py

---

उपयोग और CLI तर्क

आप टूल को इंटरैक्टिव रूप से या कमांड-लाइन तर्कों के माध्यम से चला सकते हैं।

इंटरैक्टिव विज़ार्ड

बिना तर्कों के चलाने पर विज़ार्ड प्रारंभ हो जाता है:

python3 sentinelnav.py

CLI तर्क

स्वचालन या पावर उपयोगकर्ताओं के लिए, विज़ार्ड को छोड़ने हेतु फ्लैग का उपयोग करें।

python3 sentinelnav.py <target_file> [options]

तर्क	विवरण	डिफ़ॉल्ट
--mode	स्कैन मोड: fixed या sentinel।	fixed
--size	फिक्स्ड मोड के लिए ब्लॉक आकार (बाइट्स में), या sentinel के लिए अधिकतम बफ़र।	1024
--hex	सेंटिनल मोड के लिए सीमांकक बाइट (जैसे, नई पंक्ति के लिए 0A)।	00
--port	वेब सर्वर पोर्ट।	8000
--window	विसंगति पहचान गणनाओं के लिए स्लाइडिंग विंडो आकार।	5

उदाहरण:

पोर्ट 8080 पर 256-बाइट रिज़ॉल्यूशन के साथ एक फ़र्मवेयर इमेज स्कैन करें:

python3 sentinelnav.py firmware.bin --size 256 --port 8080

---

कीबोर्ड नियंत्रण

वेब इंटरफ़ेस लोड होने के बाद, निम्नलिखित नियंत्रण उपलब्ध हैं:

कुंजी	कार्य
W / A / S / D	चयन कर्सर को ले जाएँ (ऊपर/बाएँ/नीचे/दाएँ)।
बायाँ तीर (Arrow Left)	पिछला पृष्ठ।
दायाँ तीर (Arrow Right)	अगला पृष्ठ।
Shift + WASD	ब्लॉकों की एक श्रेणी चुनें (मल्टी-सेलेक्ट)।
Shift + Click	पिछले एंकर से क्लिक किए गए ब्लॉक तक एक श्रेणी चुनें।

माउस नियंत्रण

• होवर (Hover): कर्सर के नीचे स्थित ब्लॉक के लिए लाइव एन्ट्रॉपी और स्पेक्ट्रल आँकड़े देखें।
• क्लिक: Inspector पैनल में Hex Dump और Architecture Analysis देखने के लिए किसी ब्लॉक पर चयन लॉक करें।