Beelzebub

ओपन-सोर्स डिसेप्शन फ्रेमवर्क।

वास्तविक दिखने वाले डिकॉय तैनात करें। हमलावर के व्यवहार का अवलोकन करें। इंटरैक्शन को सुरक्षा साक्ष्य में बदलें।

Beelzebub Platform का अन्वेषण करें · दस्तावेज़ीकरण · त्वरित शुरुआत

Beelzebub सुरक्षा टीमों को डिकॉय सेवाओं पर लक्षित गतिविधि का अध्ययन करने का एक कॉन्फ़िगर करने योग्य तरीका प्रदान करता है। वह वातावरण परिभाषित करें जिसका सामना हमलावर करता है, तय करें कि यह कैसे प्रतिक्रिया देगा, और जाँच के लिए इंटरैक्शन को कैप्चर करें। फ्रेमवर्क को स्वतंत्र रूप से चलाएँ या इसे Beelzebub Platform से जोड़ें।

Beelzebub क्यों

• अपने वातावरण के अनुरूप डिकॉय तैनात करें। YAML में सेवाएँ, रूट और प्रतिक्रिया नियम परिभाषित करें। पूर्वानुमेय व्यवहार के लिए स्टैटिक हैंडलर या अनुकूली इंटरैक्शन के लिए LLM-संचालित प्रतिक्रियाओं का उपयोग करें। जब आपको कस्टम व्यवहार की आवश्यकता हो तो रनटाइम को विश्वसनीय Go प्लगइन्स के साथ विस्तारित करें।
• संपर्क के बाद क्या होता है, इसका अवलोकन करें। प्रोटोकॉल के आधार पर, डिकॉय इंटरैक्शन से साक्ष्य कैप्चर करें, जिसमें कमांड, HTTP अनुरोध विवरण और सत्र संदर्भ शामिल हैं। विश्लेषकों को सेवा पर लक्षित गतिविधि का रिकॉर्ड दें ताकि जाँच में सहायता मिल सके।
• साक्ष्य को अपने वर्कफ़्लो में लाएँ। लॉग को स्थानीय रूप से जाँचें, संरचित इवेंट RabbitMQ पर प्रकाशित करें, या Beelzebub Platform रिपोर्टिंग सक्षम करें। रनटाइम गतिविधि की निगरानी के लिए core.prometheus.enabled: true के साथ Prometheus मेट्रिक्स सक्षम करें; डिफ़ॉल्ट रूप से, मेट्रिक्स लिसनर अक्षम होता है और कोई पोर्ट बाइंड नहीं करता।

इसे क्रियान्वित होते देखें

हमलावर इनपुट पर LLM-संचालित डिकॉय की प्रतिक्रिया देखें। यह डेमो दर्शाता है कि कैसे उत्पन्न प्रतिक्रियाएँ कमांड हैंडलर के एक निश्चित सेट से आगे बढ़कर इंटरैक्शन को बनाए रख सकती हैं।

यह कैसे काम करता है

YAML में सेवाएँ और नियम परिभाषित करें, कॉन्फ़िगरेशन को सत्यापित करें, और रनटाइम प्रारंभ करें। सेवाओं और प्रतिक्रियाओं का विस्तार करने के लिए विश्वसनीय Go प्लगइन्स को रनटाइम में संकलित किया जाता है। प्रत्येक सेवा आने वाले इंटरैक्शन को संभालती है और कॉन्फ़िगर किए गए इवेंट आउटपुट के माध्यम से साक्ष्य उत्सर्जित करती है। LLM प्रतिक्रियाओं के लिए एक कॉन्फ़िगर किया गया प्रदाता आवश्यक है; स्टैटिक हैंडलर इसके बिना चल सकते हैं।

फ्रेमवर्क SSH, HTTP, TCP, TELNET, और MCP का समर्थन करता है। MCP डिकॉय बेट टूल्स को उजागर करते हैं जो नियंत्रित एजेंट परीक्षण के दौरान संदिग्ध इनवोकेशन को अवलोकनीय बनाते हैं। वे प्रॉम्प्ट-इंजेक्शन प्रयासों का साक्ष्य प्रदान कर सकते हैं; वे हर प्रयास का पता लगाने की गारंटी नहीं देते।

तैनाती विकल्पों में स्थानीय Go बाइनरी, Docker Compose, और Helm के साथ Kubernetes शामिल हैं। रनटाइम व्यवहार और एक्सटेंशन सीमाओं के लिए आर्किटेक्चर गाइड देखें।

डिकॉय का अन्वेषण करें

configurations/services में 18 उदाहरण कॉन्फ़िगरेशन में से किसी एक से शुरुआत करें। इसके नियमों का निरीक्षण करने और इसे अपने वातावरण के अनुकूल बनाने के लिए एक YAML फ़ाइल खोलें।

श्रेणी	उदाहरण डिकॉय
रिमोट एक्सेस	SSH · SSH (LLM) · TELNET · RDP · VNC
वेब	WordPress (LLM fallback) · HTTP 401 · HTTP methods · Apache directory maze
डेटाबेस और कैश	MySQL · PostgreSQL (LLM) · SQL Server · Redis · Memcached
नेटवर्क सेवाएँ	SMB · LDAP
IoT	MQTT
AI एजेंट	MCP bait tools

उदाहरण बैनर और चयनित प्रतिक्रियाओं से लेकर इंटरैक्टिव आदान-प्रदान तक फैले हुए हैं। LLM उदाहरणों के लिए एक कॉन्फ़िगर किया गया प्रदाता आवश्यक है; WordPress अपने कैच-ऑल रूट के लिए इसका उपयोग करता है। अतिरिक्त उदाहरण सक्षम करते समय अपने डिप्लॉयमेंट के पोर्ट मैपिंग की जाँच करें।

शुरू करें

आपको Git, एक शेल, और Compose v2 के साथ Docker Engine की आवश्यकता है। सभी कॉन्फ़िगर किए गए लिसनर के लिए प्राधिकरण वाले पृथक लैब होस्ट का उपयोग करें: इंस्टॉलर उदाहरण सेवाओं का एक बंडल शुरू करता है, जिसमें विशेषाधिकार प्राप्त पोर्ट भी शामिल हैं। Linux पर यह होस्ट नेटवर्किंग सक्षम कर सकता है; उस मोड में Docker नेटवर्क अलगाव प्रदान नहीं करता है।

सिंथेटिक क्रेडेंशियल का उपयोग करें और सेवाओं को इंटरनेट पर उजागर करने से पहले उत्पादन सुरक्षा गाइड की समीक्षा करें।

git clone https://github.com/beelzebub-labs/beelzebub.git
cd beelzebub
./install.sh --docker

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

डिफ़ॉल्ट HTTP डिकॉय का परीक्षण करें और उसके लॉग का निरीक्षण करें:

curl -i http://localhost:8080/
docker compose logs -f beelzebub