anti
cf1e00af28
- HTTP: configurable server_header, response_code, fake_app presets (apache/nginx/wordpress/phpmyadmin/iis), extra_headers, custom_body, static files directory mount - SSH/Cowrie: configurable kernel_version, hardware_platform, ssh_banner, and users/passwords via COWRIE_USERDB_ENTRIES; switched to build mode so cowrie.cfg.j2 persona fields and userdb.txt generation work - SMTP: configurable banner and MTA hostname - MySQL: configurable version string in protocol greeting - Redis: configurable redis_version and os string in INFO response - BYOS: [custom-*] INI sections define bring-your-own Docker services - Stealth: rename all *_honeypot.py → server.py; replace HONEYPOT_NAME env var with NODE_NAME across all 22+ service templates and plugins; strip "honeypot" from all in-container file content - Config: DeckyConfig.service_config dict; INI [decky-N.svc] subsections; composer passes service_cfg to compose_fragment - 350 tests passing (100%) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
43 lines
1.5 KiB
Python
43 lines
1.5 KiB
Python
from abc import ABC, abstractmethod
|
|
from pathlib import Path
|
|
|
|
|
|
class BaseService(ABC):
|
|
"""
|
|
Contract every honeypot service plugin must implement.
|
|
|
|
To add a new service: subclass BaseService in a new file under decnet/services/.
|
|
The registry auto-discovers all subclasses at import time.
|
|
"""
|
|
|
|
name: str # unique slug, e.g. "ssh", "smb"
|
|
ports: list[int] # ports this service listens on inside the container
|
|
default_image: str # Docker image tag, or "build" if a Dockerfile is needed
|
|
|
|
@abstractmethod
|
|
def compose_fragment(
|
|
self,
|
|
decky_name: str,
|
|
log_target: str | None = None,
|
|
service_cfg: dict | None = None,
|
|
) -> dict:
|
|
"""
|
|
Return the docker-compose service dict for this service on a given decky.
|
|
|
|
Networking keys (networks, ipv4_address) are injected by the composer —
|
|
do NOT include them here. Include: image/build, environment, volumes,
|
|
restart, and any service-specific options.
|
|
|
|
Args:
|
|
decky_name: unique identifier for the decky (e.g. "decky-01")
|
|
log_target: "ip:port" string if log forwarding is enabled, else None
|
|
service_cfg: optional per-service persona config from INI subsection
|
|
"""
|
|
|
|
def dockerfile_context(self) -> Path | None:
|
|
"""
|
|
Return path to the build context directory if this service needs a custom
|
|
image built. Return None if default_image is used directly.
|
|
"""
|
|
return None
|