Files
DECNET/decnet/services/dns.py
anti 77a466e615 feat(dns): add BIND-flavored DNS honeypot service
Python asyncio DNS server on UDP+TCP/53 masquerading as BIND 9.x.
Emits four event_type values: query, fingerprint_probe (version.bind /
hostname.bind / id.server CHAOS), zone_transfer (AXFR/IXFR, always
REFUSED), amp_probe (qtype=ANY or EDNS udp_size>1232), and
tunneling_suspect (long high-entropy labels or rapid TXT burst).

Zone persona is generated per-decky from instance_seed (domain name,
SOA serial, NS, A, MX, TXT SPF); overridable via config_schema.
Three zone modes: auth (default), recursive, open (sinkhole).
2026-05-21 19:07:49 -04:00

84 lines
2.7 KiB
Python

from pathlib import Path
from decnet.services.base import BaseService, ServiceConfigField
TEMPLATES_DIR = Path(__file__).parent.parent / "templates" / "dns"
_DEFAULT_VERSION = "9.11.4-P2-RedHat-9.11.4-26.P2.el7_9.10"
class DNSService(BaseService):
name = "dns"
ports = [53]
default_image = "build"
config_schema = [
ServiceConfigField(
key="zone_mode",
label="Zone mode",
type="enum",
enum=["auth", "recursive", "open"],
default="auth",
help="auth: authoritative only; recursive: RA flag set, NXDOMAIN for out-of-zone; open: responds to everything (amp bait)",
),
ServiceConfigField(
key="domain",
label="Domain",
type="string",
default="",
placeholder="corp.local",
help="Authoritative zone name. Leave empty to generate a plausible domain from the decky name.",
),
ServiceConfigField(
key="bind_version",
label="BIND version banner",
type="string",
default=_DEFAULT_VERSION,
help="Returned for version.bind CHAOS TXT queries.",
),
ServiceConfigField(
key="nsid",
label="NSID",
type="string",
default="",
help="EDNS NSID string. Leave empty to derive from decky identity.",
),
ServiceConfigField(
key="extra_records",
label="Extra records",
type="textarea",
default="",
placeholder="www A 10.0.0.5\nmail TXT v=spf1 ~all",
help="Additional zone records, one per line: <name> <TYPE> <value>",
),
]
def compose_fragment(
self,
decky_name: str,
log_target: str | None = None,
service_cfg: dict | None = None,
) -> dict:
cfg = service_cfg or {}
env: dict[str, str] = {
"NODE_NAME": decky_name,
"DNS_ZONE_MODE": str(cfg.get("zone_mode", "auth")),
"DNS_DOMAIN": str(cfg.get("domain", "")),
"DNS_BIND_VERSION": str(cfg.get("bind_version", _DEFAULT_VERSION)),
"DNS_NSID": str(cfg.get("nsid", "")),
"DNS_EXTRA_RECORDS": str(cfg.get("extra_records", "")),
}
if log_target:
env["LOG_TARGET"] = log_target
return {
"build": {"context": str(TEMPLATES_DIR)},
"container_name": f"{decky_name}-dns",
"restart": "unless-stopped",
"environment": env,
}
def dockerfile_context(self) -> Path | None:
return TEMPLATES_DIR
def udp_ports(self, cfg: dict | None = None) -> list[int]:
return [53]