HASH (HTTP एग्नोस्टिक सॉफ्टवेयर हनीपॉट)

HASH एक ढांचा है जो कम इंटरैक्टिव हनीपॉट बनाने और चलाने के लिए है।

🌟 HASH क्यों?

HASH का मुख्य दर्शन कॉन्फ़िगर करने में आसान और HTTP/HTTPS पर चलने वाले किसी भी सॉफ़्टवेयर की नकल करने में लचीला होना है। न्यूनतम संभावित फुटप्रिंट के साथ ताकि हनीपॉट के रूप में पहचाना जाने से बचा जा सके।

⚡ विशेषताएँ

• HTTP/HTTPS आधारित हनीपॉट तैनात करने के लिए एकल ढांचा
• YAML फ़ाइलों के माध्यम से आसानी से कॉन्फ़िगर करने योग्य
• अंतर्निहित हनीट्रैप
• हनीपॉट का पता लगने से बचने के लिए fakerjs पर आधारित शक्तिशाली यादृच्छिकीकरण
• वैकल्पिक रूप से, APM के माध्यम से हनीपॉट लॉग और HTTP अनुरोधों को摄取 और विश्लेषण करने के लिए Datadog के साथ एकीकरण

🚀 आरंभ करना

HASH Node.js का उपयोग करके बनाया गया है, लेकिन यह कॉन्फ़िगरेशन के आधार पर किसी भी वेब-आधारित भाषा / सर्वर की नकल कर सकता है। नीचे पूर्ण दस्तावेज़ पढ़ें।

स्थापना

आप इसे NPM के माध्यम से स्थापित कर सकते हैं

npm install -g hash-honeypot

या आप इसे सीधे डॉकर से उपयोग कर सकते हैं

docker run --rm ghcr.io/datadog/hash help

उपयोग

हनीपॉट प्रोफ़ाइल उत्पन्न करें

HASH यह कॉन्फ़िगर करने के लिए YAML फ़ाइलों का उपयोग करता है कि यह वांछित सॉफ़्टवेयर का अनुकरण कैसे करता है। प्रोफ़ाइल फ़ोल्डर की विशिष्ट संरचना निम्नलिखित है

|____templates
|     |____resources
|     |     |____index.html
|     |     |____style.css
|     |     |____favicon.ico
|     |____404.yaml
|     |____default.yaml
|____init.yaml

आप इसे स्वयं बना सकते हैं या generate कमांड का उपयोग करके उत्पन्न कर सकते हैं

Usage: HASH generate [options] <folder>

Generate honeypot profile

Arguments:
  folder                         path/to the app

Options:
  -t --template <template_name>  base template (default: "default")
  -n --name <honeypot_name>      Honeypot name
  -s --swagger <swagger_file>    Path to swagger file to convert
  -h, --help                     display help for command

उदाहरण

hash-honeypot generate myhoneypot --name my-honey-pot --template default

आप generate कमांड से सीधे स्वैगर फ़ाइलों को हनीपॉट में भी परिवर्तित कर सकते हैं

स्वैगर फ़ाइल(फ़ाइलों) को हनीपॉट में बदलने का उदाहरण

hash-honeypot generate sample-swagger2 -n sample -s ./test-swagger/test-swagger.yaml

हनीपॉट चलाना

Usage: HASH run [options] <folder>

Run HASH

Arguments:
  folder                     path/to the template folder

Options:
  -l, --log <transport>      logging transport (default: "console,file,datadog")
  -f, --log_file <filename>  logging filename (default: "hash.log")
  -h, --help                 display help for command

उदाहरण

hash-honeypot my-honeypot-profile -l file -f ./logs/hash.log

यदि आप लॉग के लिए Datadog का उपयोग कर रहे हैं, तो सुनिश्चित करें कि आप Datadog API कुंजी निर्यात करें export DD_API_KEY=<your-api-key>

अनुकूलन और कॉन्फ़िगरेशन

आप अपनी हनीपॉट प्रोफ़ाइल को अपनी इच्छानुसार अनुकूलित कर सकते हैं

अनुरोध टेम्पलेट का उदाहरण:

id: sqli-error
info:
    title: 'SQL error honeytrap'
requests:
    - isTrap: false
      expect:
          method: GET
          path: '/author/:Id([0-9]+)'
      reply:
          status: 200
          headers:
              content-type: 'text/html'
          body:
              view: 'author.html'
    - isTrap: true
      expect:
          method: GET
          path: '/author/:Id'
      reply:
          status: 500
          headers:
              content-type: 'text/html'
          body:
              contents: "You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near '' at line 2"

कॉन्फ़िगरेशन संदर्भ यहाँ पढ़ें या उदाहरण यहाँ देखें।

भविष्य का कार्य

• HASH सुविधाओं को दर्शाने के लिए उदाहरण फ़ोल्डर बनाना
• API दस्तावेज़ीकरण स्वरूप (swagger ..etc) आयात करने की क्षमता
• आसान वितरण के लिए पैकेज हैश को मॉड्यूल के रूप में पैकेज करना
• मध्यम इंटरैक्शन के लिए क्षमताएँ जोड़ना
• लोकप्रिय हनीट्रैप जोड़ना
• यूनिट और एकीकरण परीक्षण जोड़ना

लाइसेंस और योगदान

Apache-2.0 लाइसेंस के तहत जारी, योगदान का स्वागत है!

संपर्क

बेझिझक एक मुद्दा खोलें, या [email protected] पर संपर्क करें।