BHEU डेमो

इस रिपॉजिटरी में Black Hat Europe 2025 के The Forensic Trail On GitHub: Hunting For Supply Chain Activity के लिए तीन डेमो शामिल हैं।

1. potential_attacks_demo: एक Flask वेब एप्लिकेशन जो सार्वजनिक GH फायरहोज़ के आधार पर हमले की पहचान और जांच के डेमो को दर्शाता है।
2. ghdig: GitHub गतिविधि की जांच के लिए एक कमांड-लाइन टूल।
3. gitthrunter: एक खिलौना उपकरण जो संदिग्ध GitHub गतिविधि की पहचान करता है, उसे समृद्ध करता है, और आगे की जांच के लिए प्रस्तुत करता है।

potential_attacks_demo

डेमो चलाना

1. potential_attacks_demo निर्देशिका पर जाएँ:
   root@kitploit:~

   cd potential_attacks
   

2. आवश्यक निर्भरताएँ स्थापित करें:
   root@kitploit:~

   pip install -r requirements.txt
   

3. Flask एप्लिकेशन चलाएँ:
   root@kitploit:~

   flask run
   

4. अपना वेब ब्राउज़र खोलें और http://127.0.0.1:5000 पर जाएँ ताकि डेमो देख सकें।

ghdig

स्थापना

1. ghdig निर्देशिका पर जाएँ:
   root@kitploit:~

   cd ghdig
   

2. आवश्यक निर्भरताएँ स्थापित करें:
   root@kitploit:~

   pip install -r requirements.txt
   

कॉन्फ़िगरेशन

GitHub API के साथ इंटरैक्ट करने के लिए ghdig को एक GitHub पर्सनल एक्सेस टोकन की आवश्यकता होती है।

1. ghdig निर्देशिका में .env नामक फ़ाइल बनाएँ।

2. अपना GitHub टोकन इस प्रकार फ़ाइल में जोड़ें:

   root@kitploit:~

   GITHUB_TOKEN=your_github_token_here
   

उपयोग

टूल प्रोजेक्ट के रूट से एक Python मॉड्यूल के रूप में चलाया जाता है।

python -m ghdig <command> [options]

कमांड

यहाँ उपलब्ध कमांड और उनके उपयोग के उदाहरण दिए गए हैं:

• gist: GitHub Gists को संभालता है।

  • उपयोग: python -m ghdig gist <gist_id_or_url>
  • उदाहरण: python -m ghdig gist https://gist.github.com/mmvojwip/e9975a3a16acc492e3e7f677b6276cb2

• pr: GitHub पुल रिक्वेस्ट को संभालता है।

  • उपयोग: python -m ghdig pr <repo_url>
  • उदाहरण: python -m ghdig pr https://github.com/7finney/ethcode

• commit: GitHub कमिट को संभालता है।

  • उपयोग: python -m ghdig commit <commit_url>
  • उदाहरण: python -m ghdig commit https://github.com/mmvojwip/agentkit/commit/023f11f08cc7b82036a78580202143381d703b9a

• user: एक GitHub उपयोगकर्ता का विश्लेषण करता है।

gitthrunter

स्थापना

1. gitthrunter निर्देशिका पर जाएँ:
   root@kitploit:~

   cd gitthrunter
   

2. आवश्यक निर्भरताएँ स्थापित करें:
   root@kitploit:~

   pip install -r requirements.txt
   

उपयोग

एक क्वेरी चलाने के लिए, main.py स्क्रिप्ट चलाएँ और अपनी SQL क्वेरी फ़ाइल का पथ प्रदान करें, जो queries/ निर्देशिका में स्थित है।

python main.py potential_attacks.sql --start_date "2025-09-01 00:00:00"

नोट: क्वेरी के आकार को कम करने के लिए --start_date आवश्यक हो सकता है

फिर, अभिनेता डेटा को समृद्ध करें:

python main.py potential_attacks.sql --enrich

नोट: यदि github टोकन कॉन्फ़िगर नहीं है तो समृद्धि में संभवतः रेट लिमिट के साथ समस्याएँ होंगी

अंत में, एप्लिकेशन प्रारंभ करें:

python app.py