Beelzebub

डिसेप्शन रनटाइम फ्रेमवर्क

Beelzebub एक ओपन-सोर्स डिसेप्शन रनटाइम है जो SSH, HTTP, TCP, TELNET और MCP प्रोटोकॉल में अनुकूली, LLM-संचालित डिकॉय सेवाओं को तैनात करता है। यह निष्क्रिय हनीपॉट्स से आगे बढ़कर हमलावरों को यथार्थवादी इंटरैक्शन में सक्रिय रूप से शामिल करता है, उच्च-निष्ठा ख़तरा खुफिया जानकारी एकत्र करता है, और AI एजेंटों के विरुद्ध प्रॉम्प्ट इंजेक्शन हमलों का पता लगाता है।

विषय-सूची

• Beelzebub
  • विषय-सूची
  • मुख्य विशेषताएँ
  • LLM डिसेप्शन डेमो
  • त्वरित प्रारंभ
    • इंस्टॉलर
    • स्थानीय (Go)
    • डॉकर
    • Helm (Kubernetes) का उपयोग
  • CLI संदर्भ
    • beelzebub run
    • beelzebub validate
    • beelzebub plugin
    • beelzebub version
  • प्लगइन प्रणाली
    • इंटरफ़ेस
    • प्लगइन लिखना
    • बाहरी प्लगइन्स इंस्टॉल करना
  • अवलोकनीयता
    • Prometheus मेट्रिक्स
    • RabbitMQ एकीकरण
  • परीक्षण
  • कोड गुणवत्ता
  • लाइसेंस
  • योगदान
  • कॉन्फ़िगरेशन संदर्भ
    • मुख्य कॉन्फ़िगरेशन
    • सेवा कॉन्फ़िगरेशन
  • डिसेप्शन सेवाएँ
    • MCP डिसेप्शन सेवा
      • यह कैसे काम करता है
    • HTTP डिसेप्शन सेवा
    • SSH डिसेप्शन सेवा
    • TELNET डिसेप्शन सेवा
    • TCP डिसेप्शन सेवा
  • सहायता प्राप्त

मुख्य विशेषताएँ

• अनुकूली डिसेप्शन इंजन: LLM एकीकरण (OpenAI, Ollama) वास्तविक समय में संदर्भ-सटीक प्रतिक्रियाएँ उत्पन्न करता है, जिससे हमलावर कार्रवाई योग्य TTP इकट्ठा करने के लिए पर्याप्त देर तक जुड़े रहते हैं
• लो-कोड सेवा परिभाषा: रेगेक्स कमांड मिलान के साथ YAML-आधारित कॉन्फ़िगरेशन — नई डिकॉय सेवा तैनात करने के लिए किसी कस्टम कोड की आवश्यकता नहीं
• मल्टी-प्रोटोकॉल कवरेज: SSH, HTTP, TCP, TELNET, MCP बुनियादी ढांचे के लक्ष्यों से लेकर AI एजेंट हमले की सतहों तक
• विस्तार योग्य प्लगइन प्रणाली: CommandPlugin या HTTPPlugin इंटरफ़ेस लागू करें और init() के माध्यम से रजिस्टर करें — कोई कोर परिवर्तन आवश्यक नहीं
• पूर्ण अवलोकनीयता स्टैक: Prometheus मेट्रिक्स, RabbitMQ इवेंट स्ट्रीमिंग
• प्रोडक्शन-तैयार रनटाइम: Docker, Kubernetes (Helm), सुगम शटडाउन, प्रति-सेवा मेमोरी सीमाएँ

LLM डिसेप्शन डेमो

त्वरित प्रारंभ

इंस्टॉलर```bash

./install.sh # asks local or Docker, checks prerequisites, and starts it

गैर-इंटरैक्टिव: `./install.sh --local` या `./install.sh --docker`। स्थानीय रनटाइम शुरू किए बिना इंस्टॉल और बिल्ड करने के लिए `./install.sh --local --no-run` का उपयोग करें। गैर-रूट होस्ट पर, स्थानीय इंस्टॉलेशन स्वतः शुरू नहीं होता जब डिफ़ॉल्ट कॉन्फ़िगरेशन में विशेषाधिकार प्राप्त पोर्ट शामिल होते हैं।

### स्थानीय (Go)```bash
make start     # installs any declared plugins, compiles them in, and runs

Docker```bash

make docker # builds an image with declared plugins baked in, then runs it

### Helm का उपयोग (Kubernetes)```bash
helm install beelzebub ./beelzebub-chart
# Upgrade:
helm upgrade beelzebub ./beelzebub-chart

CLI संदर्भ

Beelzebub एक संरचित CLI के साथ आता है। सभी उपलब्ध कमांड देखने के लिए beelzebub --help चलाएँ।

beelzebub run

सभी कॉन्फ़िगर की गई डिसेप्शन सेवाओं को प्रारंभ करें।```bash beelzebub run [flags]

Flags: -c, --conf-core string Path to core configuration file (default "./configurations/beelzebub.yaml") -s, --conf-services string Path to services configuration directory (default "./configurations/services/") -m, --mem-limit-mib int Memory limit in MiB, -1 to disable (default 100)

### `beelzebub validate`

किसी भी सेवा को शुरू किए बिना सभी कॉन्फ़िगरेशन फ़ाइलों को पार्स और सत्यापित करें। CI पाइपलाइनों में उपयोगी। सत्यापन आर्किटेक्चर और नियम संदर्भ के लिए [Configuration Validation](https://github.com/beelzebub-labs/beelzebub/blob/main/docs/configuration-validation.md) देखें।```bash
beelzebub validate --conf-core ./configurations/beelzebub.yaml --conf-services ./configurations/services/

beelzebub plugin

GitHub से प्राप्त प्लगइन्स को इंस्टॉल करें, सूचीबद्ध करें और हटाएँ। प्लगइन सिस्टम देखें।```bash beelzebub plugin install github.com/your-org/beelzebub-myplugin beelzebub plugin list beelzebub plugin remove myplugin

### `beelzebub version`

संस्करण, कमिट SHA, बिल्ड दिनांक, और Go runtime जानकारी प्रिंट करें।```bash
beelzebub version

प्लगइन सिस्टम

Beelzebub कोर कोड को संशोधित किए बिना डिसेप्शन रनटाइम का विस्तार करने के लिए pkg/plugin पर एक स्थिर सार्वजनिक SDK उपलब्ध कराता है।

इंटरफेस```go

// CommandPlugin generates text responses for SSH, TCP, TELNET, and HTTP services. type CommandPlugin interface { Metadata() Metadata Execute(ctx context.Context, req CommandRequest) (string, error) }

// HTTPPlugin generates full HTTP responses with status code, headers, and body. type HTTPPlugin interface { Metadata() Metadata HandleHTTP(r *http.Request) HTTPResponse }

### प्लगइन लिखना```go
package myplugin

import (
    "context"
    "github.com/beelzebub-labs/beelzebub/v3/pkg/plugin"
)

type MyPlugin struct{}

func (p *MyPlugin) Metadata() plugin.Metadata {
    return plugin.Metadata{
        Name:        "MyPlugin",
        Description: "Custom deception response generator",
        Version:     "1.0.0",
        Author:      "your-name",
    }
}

func (p *MyPlugin) Execute(_ context.Context, req plugin.CommandRequest) (string, error) {
    return "simulated response to: " + req.Command, nil
}

func init() {
    plugin.Register(&MyPlugin{})
}

बाहरी प्लगइन्स स्थापित करना```bash

Declare plugins in configurations/plugins.yaml, or:

beelzebub plugin install github.com/your-org/myplugin # also appends to the config