DarkGrid – वैश्विक खतरा खुफिया डैशबोर्ड

OSINT खतरा-खुफिया डैशबोर्ड: एक 3D ग्लोब और लाइव फ़ीड जो AbuseIPDB और OpenPhish जैसे सार्वजनिक स्रोतों से दुर्भावनापूर्ण बुनियादी ढांचे को दिखाता है।

https://github.com/user-attachments/assets/e4f6a4fa-6ff4-4ad1-8e5c-5b50ce6ad722

---

अवलोकन

DarkGrid वैश्विक स्तर पर संदिग्ध इंटरनेट बुनियादी ढांचे का दृश्य प्रस्तुत करता है:

• 3D खतरा ग्लोब जो संकेतक मात्रा के आधार पर स्पंदित देश 'पिंग्स' दिखाता है।
• खतरा फ़ीड OSINT संग्राहकों से नवीनतम IP/URLs का।
• 'खोजें/पता लगाएं' बार संकेतकों या भौगोलिक स्थानों पर जाने के लिए।
• इंटेल पैनल संदर्भ कार्ड के लिए (खतरा समूह, क्षेत्र डोजियर, समाचार, आदि)।

फोकस बुनियादी ढांचे की स्थितिजन्य जागरूकता पर है, व्यक्तियों पर नहीं।

---

परियोजना संरचना

• backend/ – FastAPI + SQLite OSINT API
  • संग्राहक: AbuseIPDB (IPs), OpenPhish (URLs)
  • शेड्यूलर स्टार्टअप पर और हर 15 मिनट में संग्राहक चलाता है
  • /api/indicators/latest – फ़ीड के लिए नवीनतम संकेतक
  • /api/map – ग्लोब के लिए प्रति-देश बकेट
• frontend/ – Next.js 16 ऐप (DarkGrid UI)
  • src/app/page.tsx – मुख्य डैशबोर्ड लेआउट
  • src/components/ThreatGlobeViewer.tsx – 3D ग्लोब
  • src/hooks/useThreatDataPolling.ts – खतरा API को पोल करता है
• docker-compose.yml – स्थानीय स्टैक (बैकएंड + फ्रंटएंड)

---

त्वरित आरंभ (Docker)

1. इस निर्देशिका में .env बनाएं (docker-compose.yml वाले फ़ोल्डर में):

   copy .env.example .env
   

   .env संपादित करें और सेट करें:

   • ABUSEIPDB_API_KEY – https://www.abuseipdb.com/ से एक निःशुल्क कुंजी प्राप्त करें।

2. स्टैक शुरू करें:

   docker-compose up -d
   

   या लॉग देखने के लिए अग्रभूमि में चलाएं:

   docker-compose up
   

3. UI और API खोलें:

   • डैशबोर्ड: http://localhost:3000
   • बैकएंड API: http://localhost:8000
   • स्वास्थ्य: http://localhost:8000/health

4. कोड परिवर्तन के बाद पुनर्निर्माण करें:

   docker-compose up -d --build
   

---

डेटा और अंतर्ग्रहण

• डेटाबेस: SQLite, पहली बैकएंड शुरू होने पर स्वचालित रूप से बनाया जाता है।

  • Docker में, डेटा /app/data/threat_intel.db पर backend_data वॉल्यूम में है।
  • स्थानीय डेवलपमेंट (Docker के बिना) में, डेटा backend/data/threat_intel.db पर है।

• संग्राहक (स्टार्टअप पर और हर 15 मिनट में चलते हैं):

  • AbuseIPDB (ABUSEIPDB_API_KEY आवश्यक है):

    • type=ip, source=abuseipdb संकेतक geo.country के साथ उत्पन्न करता है।
    • खतरा फ़ीड और ग्लोब पिंग्स (देश बकेट) दोनों को फ़ीड करता है।

  • OpenPhish (कोई कुंजी आवश्यक नहीं):

    • type=url, source=openphish संकेतक उत्पन्न करता है (कोई भू-डेटा नहीं)।
    • केवल खतरा फ़ीड में दिखाई देता है (कोई ग्लोब पिंग्स नहीं)।

• खाली ग्लोब/फ़ीड समस्या निवारण:

  • यदि ग्लोब में कोई पिंग्स नहीं हैं और फ़ीड खाली है:
    • .env जांचें और सुनिश्चित करें कि ABUSEIPDB_API_KEY सेट और मान्य है।
    • पुनरारंभ करें: docker-compose up -d।
    • पहले संग्राहक चलने के लिए कुछ मिनट प्रतीक्षा करें, फिर UI को ताज़ा करें।

---

स्थानीय विकास (Docker के बिना)

आवश्यकताएँ:

• Python 3.11+
• Node.js 20+

बैकएंड

cd backend
python -m venv .venv
.venv\Scripts\activate  # on Windows
pip install -r requirements.txt
python main.py  # serves on http://localhost:8000

सुनिश्चित करें कि आपकी रूट .env फ़ाइल में अंतर्ग्रहण के लिए ABUSEIPDB_API_KEY है।

फ्रंटएंड

cd frontend
npm install

frontend/.env.local बनाएं (केवल स्थानीय विकास के लिए):

NEXT_PUBLIC_THREAT_API_URL=http://localhost:8000

फिर चलाएं:

npm run dev

http://localhost:3000 खोलें।

---

स्थिति

यह प्रोजेक्ट कार्य प्रगति पर है और DarkGrid खतरा खुफिया डैशबोर्ड का मोटा MVP है। बैकएंड, संग्राहक और UI को परिष्कृत करने पर ब्रेकिंग परिवर्तनों की उम्मीद करें।

नियोजित भविष्य के चरणों में शामिल हैं:

• समृद्ध ग्लोब पिंग्स: अधिक दानेदार बकेट, परिष्कृत आकार/एनीमेशन, और बेहतर क्लिक-थ्रू व्यवहार।
• अतिरिक्त OSINT स्रोत: AbuseIPDB और OpenPhish से परे अधिक IP/URL/डोमेन प्रतिष्ठा और मैलवेयर फ़ीड।
• गहन संकेतक खुफिया: प्रत्येक संकेतक और देश समूह के लिए विस्तृत विवरण।