beelzebub

![Beelzebub — ओपन-सोर्स डिसेप्शन फ्रेमवर्क](https://raw.githubusercontent.com/beelzebub-labs/beelzebub/main/docs/public/readme/cover.svg)

# Beelzebub

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

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

**[Beelzebub Platform का अन्वेषण करें](https://beelzebub.ai/products/beelzebub-cloud/)** · [दस्तावेज़ीकरण](https://docs.beelzebub.ai) · [त्वरित शुरुआत](#get-started)

[![CI](https://github.com/beelzebub-labs/beelzebub/actions/workflows/main.yml/badge.svg)](https://github.com/beelzebub-labs/beelzebub/actions/workflows/main.yml)
[![Coverage](https://codecov.io/gh/beelzebub-labs/beelzebub/graph/badge.svg?token=8XTK7D4WHE)](https://codecov.io/gh/beelzebub-labs/beelzebub)
[![License: GPL v3](https://img.shields.io/badge/License-GPL_v3-6930c3.svg)](LICENSE)
[![Go Reference](https://pkg.go.dev/badge/github.com/beelzebub-labs/beelzebub/v3.svg)](https://pkg.go.dev/github.com/beelzebub-labs/beelzebub/v3)
[![Mentioned in Awesome Go](https://awesome.re/mentioned-badge.svg)](https://github.com/avelino/awesome-go)

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

## Beelzebub क्यों

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

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

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

![हमलावर इनपुट पर प्रतिक्रिया देते LLM-संचालित Beelzebub डिकॉय का डेमो](https://assets.kitploit.com/production/public/readmes/9670/38080b103591f912d2aacf0feaf330531560f6bafc2fe8f4fbbdd42c3e60ea29.gif)

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

[![इंटरैक्शन डिकॉय सेवाओं तक पहुँचते हैं, Beelzebub रनटाइम से प्रतिक्रियाएँ प्राप्त करते हैं, और सुरक्षा इवेंट उत्पन्न करते हैं। YAML कॉन्फ़िगरेशन सत्यापन के माध्यम से रनटाइम को फ़ीड करता है; सेवाओं और प्रतिक्रियाओं का विस्तार करने के लिए Go प्लगइन्स को रनटाइम में संकलित किया जाता है। इवेंट वैकल्पिक RabbitMQ या Platform रिपोर्टिंग के साथ लॉग में जाते हैं, जबकि Prometheus मेट्रिक्स को अलग से उजागर करता है।](https://raw.githubusercontent.com/beelzebub-labs/beelzebub/main/docs/public/readme/how-it-works.svg)](docs/public/readme/how-it-works.svg)

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

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

तैनाती विकल्पों में स्थानीय Go बाइनरी, Docker Compose, और Helm के साथ Kubernetes शामिल हैं। रनटाइम व्यवहार और एक्सटेंशन सीमाओं के लिए [आर्किटेक्चर गाइड](https://docs.beelzebub.ai/concepts/architecture) देखें।

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

[configurations/services](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services) में **18 उदाहरण कॉन्फ़िगरेशन** में से किसी एक से शुरुआत करें। इसके नियमों का निरीक्षण करने और इसे अपने वातावरण के अनुकूल बनाने के लिए एक YAML फ़ाइल खोलें।

| श्रेणी | उदाहरण डिकॉय |
| --- | --- |
| रिमोट एक्सेस | [SSH](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/ssh-22.yaml) · [SSH (LLM)](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/ssh-2222.yaml) · [TELNET](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/telnet-23.yaml) · [RDP](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/tcp-3389-rdp.yaml) · [VNC](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/tcp-5900-vnc.yaml) |
| वेब | [WordPress (LLM fallback)](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/http-80.yaml) · [HTTP 401](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/http-8080.yaml) · [HTTP methods](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/http-methods-8081.yaml) · [Apache directory maze](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/http-maze-8888.yaml) |
| डेटाबेस और कैश | [MySQL](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/tcp-3306.yaml) · [PostgreSQL (LLM)](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/tcp-5432-postgresql-llm.yaml) · [SQL Server](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/tcp-1433-mssql.yaml) · [Redis](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/tcp-6379-redis.yaml) · [Memcached](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/tcp-11211-memcached.yaml) |
| नेटवर्क सेवाएँ | [SMB](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/tcp-445-smb.yaml) · [LDAP](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/tcp-389-ldap.yaml) |
| IoT | [MQTT](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/tcp-1883-mqtt.yaml) |
| AI एजेंट | [MCP bait tools](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/mcp-8000.yaml) |

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

## शुरू करें

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

सिंथेटिक क्रेडेंशियल का उपयोग करें और सेवाओं को इंटरनेट पर उजागर करने से पहले [उत्पादन सुरक्षा गाइड](https://docs.beelzebub.ai/operations/production-safety) की समीक्षा करें।

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

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

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

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

पोर्ट 8080 पर बंडल किए गए HTTP उदाहरण से **`401 Unauthorized`** प्राप्त होने की अपेक्षा करें। यह डिकॉय का कॉन्फ़िगर किया गया प्रतिक्रिया है, जो पुष्टि करता है कि लिसनर पहुँच योग्य है। यदि इंस्टॉलर ने किसी व्यस्त पोर्ट को छोड़ दिया है, तो परीक्षण से पहले संघर्ष का समाधान करें। लॉग को फ़ॉलो करना बंद करने के लिए `Ctrl+C` दबाएँ।

समाप्त होने पर लैब को रोकें:

```bash
docker compose down
```

एकल-सेवा सेटअप या किसी अन्य परिनियोजन विधि के लिए, [इंस्टॉलेशन गाइड](https://docs.beelzebub.ai/getting-started/installation) का पालन करें।

## Beelzebub Platform

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

प्लेटफ़ॉर्म की परिनियोजन, जाँच और रिपोर्टिंग क्षमताओं का अन्वेषण करें, और देखें कि वे आपकी टीम की आवश्यकताओं में कैसे फिट होती हैं।

**[Beelzebub Platform का अन्वेषण करें →](https://beelzebub.ai/products/beelzebub-cloud/)**

## संसाधन और समुदाय

- **[दस्तावेज़ीकरण](https://docs.beelzebub.ai):** कॉन्फ़िगरेशन, प्रोटोकॉल, संचालन, एकीकरण और रेसिपी।
- **[प्लगइन लेखन](https://docs.beelzebub.ai/plugins/authoring):** सार्वजनिक Go SDK के साथ एक्सटेंशन बनाएँ। प्लगइन इन-प्रोसेस निष्पादित होते हैं; उनके स्रोत की समीक्षा करें और विश्वसनीय संस्करणों को पिन करें।
- **[योगदान](https://github.com/beelzebub-labs/beelzebub/blob/main/CONTRIBUTING.md):** [आचार संहिता](https://github.com/beelzebub-labs/beelzebub/blob/main/CODE_OF_CONDUCT.md) के अंतर्गत कोड, उदाहरण या दस्तावेज़ीकरण में योगदान दें। कमज़ोरियों की निजी रूप से रिपोर्ट [SECURITY.md](https://github.com/beelzebub-labs/beelzebub/blob/main/SECURITY.md) के माध्यम से करें।

विकास के लिए, [go.mod](https://github.com/beelzebub-labs/beelzebub/blob/main/go.mod) में घोषित Go संस्करण, Git और Make का उपयोग करें। `make build` से बिल्ड करें; रनटाइम परिवर्तन सबमिट करने से पहले `make test.unit`, `go vet ./...`, और `make validate-all` चलाएँ। [विकास वर्कफ़्लो](https://docs.beelzebub.ai/contributing/development) एकीकरण परीक्षणों और उनकी Docker निर्भरताओं को कवर करता है।

[JetBrains](https://jb.gg/OpenSourceSupport) को उनके ओपन-सोर्स सहायता कार्यक्रम के माध्यम से टूल्स के साथ विकास का समर्थन करने के लिए धन्यवाद।

[GNU General Public License v3.0](https://github.com/beelzebub-labs/beelzebub/blob/main/LICENSE) के अंतर्गत लाइसेंस प्राप्त।