beelzebub — Un framework d'exécution de leurres low code sécurisé, exploitant l'IA pour la virtualisation des systèmes. | Kitploit

Non interactif : `./install.sh --local` ou `./install.sh --docker`. Utilisez
`./install.sh --local --no-run` pour installer et compiler sans démarrer l’exécution
locale. Sur les hôtes non root, l’installation locale ne démarre pas automatiquement lorsque la
configuration par défaut inclut des ports privilégiés.

### Local (Go)```bash
make start     # installs any declared plugins, compiles them in, and runs

### `beelzebub validate`

Analyse et valide tous les fichiers de configuration sans démarrer aucun service. Utile dans les pipelines CI. Voir [Validation de la configuration](https://github.com/beelzebub-labs/beelzebub/blob/HEAD/docs/configuration-validation.md) pour l'architecture de validation et la référence des règles.```bash
beelzebub validate --conf-core ./configurations/beelzebub.yaml --conf-services ./configurations/services/

### Écrire un plugin```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{})
}

| Commande | Rôle |
|---|---|
| `plugin install <link>` | récupère un plugin, l'intègre, reconstruit ; l'ajoute également à `configurations/plugins.yaml` |
| `plugin install` | installe tout ce qui est déclaré dans `configurations/plugins.yaml` |
| `plugin list` | affiche les plugins installés par rapport à ceux compilés dans le binaire |
| `plugin update [name]` | récupère à nouveau à la réf. déclarée et re-épingle le commit |
| `plugin remove <name>` | supprime un plugin de `configurations/plugins.yaml`, le débranche et affiche l'étape de reconstruction |

Les sources des plugins de déploiement sont configurées dans `configurations/plugins.yaml` :```yaml
plugins:
  - source: github.com/your-org/myplugin
  - source: github.com/your-org/[email protected]

Les plugins installés sont compilés dans le binaire Beelzebub et s'exécutent dans le même processus que le runtime. N'installez les plugins qu'à partir de dépôts de confiance.

## Observabilité

### Métriques Prometheus

Beelzebub expose les métriques Prometheus sur le point de terminaison configuré (par défaut : `:2112/metrics`) :

| Métrique | Description |
|--------|-------------|
| `beelzebub_events_total` | Total des événements de déception sur tous les services |
| `beelzebub_events_ssh_total` | Événements SSH |
| `beelzebub_events_http_total` | Événements HTTP |
| `beelzebub_events_tcp_total` | Événements TCP |
| `beelzebub_events_telnet_total` | Événements TELNET |
| `beelzebub_events_mcp_total` | Événements MCP |

### Intégration RabbitMQ

Publiez tous les événements de déception dans une file de messages pour une intégration SIEM en aval :```yaml
core:
  tracings:
    rabbit-mq:
      enabled: true
      uri: "amqp://guest:guest@localhost:5672/"

## Qualité du code

- **CI** : GitHub Actions à chaque commit et pull request
- **Analyse statique** : CodeQL et Go Report Card
- **Couverture** : surveillée via [Codecov](https://codecov.io/gh/beelzebub-labs/beelzebub)
- **Revue de code** : toutes les contributions passent par une revue par les pairs

## Licence

Beelzebub est sous licence [GNU GPL v3](https://github.com/beelzebub-labs/beelzebub/blob/HEAD/LICENSE).

## Contribuer

L’équipe Beelzebub accueille favorablement les contributions et la participation au projet. Que vous souhaitiez signaler des bogues, contribuer de nouvelles fonctionnalités ou poser des questions, veuillez consulter notre [Guide du contributeur](https://github.com/beelzebub-labs/beelzebub/blob/HEAD/CONTRIBUTING.md) pour des informations détaillées. Nous encourageons tous les participants et mainteneurs à adhérer à notre [Code de conduite](https://github.com/beelzebub-labs/beelzebub/blob/HEAD/CODE_OF_CONDUCT.md) et à favoriser une communauté solidaire et respectueuse.

Bon hacking !

## Référence de configuration

Beelzebub utilise un système de configuration à deux niveaux :

1. **Configuration principale** (`beelzebub.yaml`)  paramètres globaux : journalisation, tracing, Prometheus
2. **Configurations de services** (`services/*.yaml`)  un fichier par service leurre

### Configuration principale```yaml
core:
  logging:
    debug: false
    debugReportCaller: false
    logDisableTimestamp: true
    logsPath: ./logs
  tracings:
    rabbit-mq:
      enabled: false
      uri: "amqp://guest:guest@localhost:5672/"
  prometheus:
    path: "/metrics"
    port: ":2112"

Accessible via `http://beelzebub:port/mcp` (transport HTTP Streamable).

### Service HTTP de déception

Les services de déception HTTP répondent aux requêtes web avec des réponses configurables basées sur la correspondance de motifs d'URL. Prend en charge TLS, les gestionnaires statiques, les réponses basées sur LLM et le générateur de labyrinthe infini.

**Simulation WordPress** (`http-80.yaml`):```yaml
apiVersion: "v1"
protocol: "http"
address: ":80"
description: "Wordpress 6.0"
commands:
  - regex: "^(/index.php|/index.html|/)$"
    handler: |
      <html><header><title>Wordpress 6 test page</title></header>
      <body><h1>Hello from Wordpress</h1></body></html>
    headers:
      - "Content-Type: text/html"
      - "Server: Apache/2.4.53 (Debian)"
      - "X-Powered-By: PHP/7.4.29"
    statusCode: 200
  - regex: "^(/wp-login.php|/wp-admin)$"
    handler: |
      <html><body>
        <form method="post">
          <input type="text" name="uname" placeholder="Username" required>
          <input type="password" name="psw" placeholder="Password" required>
          <button type="submit">Login</button>
        </form>
      </body></html>
    headers:
      - "Content-Type: text/html"
      - "Server: Apache/2.4.53 (Debian)"
    statusCode: 200
  - regex: "^.*$"
    handler: "<html><body><h1>Not found!</h1></body></html>"
    headers:
      - "Content-Type: text/html"
    statusCode: 404

**SSH propulsé par LLM** (Ollama local) :```yaml
apiVersion: "v1"
protocol: "ssh"
address: ":2222"
description: "SSH Ollama Llama3"
commands:
  - regex: "^(.+)$"
    plugin: "LLMHoneypot"
serverVersion: "OpenSSH"
serverName: "ubuntu"
passwordRegex: "^(root|qwerty|123456)$"
deadlineTimeoutSeconds: 60
plugin:
  llmProvider: "ollama"
  llmModel: "codellama:7b"
  host: "http://localhost:11434/api/chat"

### Service de leurre TELNET

Les services de leurre TELNET émulent des dispositifs à base de terminal (routeurs, commutateurs, systèmes hérités) avec un flux d'authentification complet et une intégration LLM.

**TELNET propulsé par LLM** :```yaml
apiVersion: "v1"
protocol: "telnet"
address: ":23"
description: "TELNET LLM"
commands:
  - regex: "^(.+)$"
    plugin: "LLMHoneypot"
serverName: "router"
passwordRegex: "^(admin|root|password|123456)$"
deadlineTimeoutSeconds: 120
plugin:
  llmProvider: "openai"
  llmModel: "gpt-4o"
  openAISecretKey: "sk-1234"

### Service de déception TCP

Les services de déception TCP couvrent les protocoles binaires et textuels : bases de données, courtiers de messages, services d'annuaire, accès distant, et plus encore. Prend en charge le mode bannière uniquement, la correspondance regex interactive et l'intégration LLM.

**Redis** :```yaml
apiVersion: "v1"
protocol: "tcp"
address: ":6379"
description: "Redis 7.0.12"
commands:
  - regex: "^PING"
    handler: "+PONG\r\n"
  - regex: "^AUTH"
    handler: "-ERR Client sent AUTH, but no password is set\r\n"
  - regex: "^INFO"
    handler: "$180\r\n# Server\r\nredis_version:7.0.12\r\nos:Linux 5.15.0-76-generic x86_64\r\ntcp_port:6379\r\n\r\n"
  - regex: "^(.+)$"
    handler: "-ERR unknown command\r\n"
deadlineTimeoutSeconds: 60
serverName: "redis-prod-01"

**PostgreSQL propulsé par LLM** :```yaml
apiVersion: "v1"
protocol: "tcp"
address: ":5432"
description: "PostgreSQL 15.3"
commands:
  - regex: "^(.+)$"
    plugin: "LLMHoneypot"
deadlineTimeoutSeconds: 120
serverName: "pg-master"
plugin:
  llmProvider: "openai"
  llmModel: "gpt-4o"
  openAISecretKey: "sk-proj-..."
  prompt: "You are simulating a PostgreSQL 15.3 server. Respond to incoming TCP data as a PostgreSQL server would."

beelzebub

Populaires

Table des matières

Fonctionnalités clés

Démonstration de leurre LLM

Démarrage rapide

Installeur```bash

Docker```bash

Référence CLI

`beelzebub run`

`beelzebub plugin`

Système de plugins

Interfaces```go

Installation de plugins externes```bash

Declare plugins in configurations/plugins.yaml, or:

Tests```bash

Unit tests

Integration tests (requires Docker)

Validate configuration without starting services

Configuration des services

Services de leurre

Service de leurre MCP

Fonctionnement

Service de leurre SSH

Avec le soutien de