Files
Dolon (Agent)andClaude Fable 5.1 1bec7c784c DNS + ingress: the confirmed names, split-horizon alias, providers on https
Rick confirmed forgeway.<site>.falkvinge.net and the local-first alias
forgeway.services.falkvinge.net. README documents the alias as the front
door, the per-site names as explicit handles, and exactly how the Serenity
override keeps the alias LOCAL (host-record + local= on both Serenity
Pi-holes; the local= line closes the dual-stack AAAA bypass).

OpenClaw providers now point at the https alias with a placeholder apiKey:
OpenClaw exempts plain-IP http base URLs from needing a key but not https
hostnames. scripts/technitium.py ships the Technitium API helper used for
the records (zones / records / add / resync / logtail).

REPORT.md addendum carries the verification table from real clients at both
sites and the findings made on the way.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-18 14:56:12 +00:00

124 lines
5.4 KiB
Python
Executable File

#!/usr/bin/env python3
"""Technitium DNS admin helper for the forgeway DNS work.
Credentials come from `pass` inside this process; the session token is kept in
memory and sent as a form field. Nothing secret is ever printed or put on a
command line.
tech.py <site> zones
tech.py <site> records <zone>
tech.py <site> add-cname <zone> <name> <target>
tech.py <site> add-a <zone> <name> <ip>
tech.py <site> add-zone <zone> # primary zone
tech.py <site> delete <zone> <name> <type> <value>
<site> = lounge | serenity (primary Technitium at each site)
"""
from __future__ import annotations
import json
import subprocess
import sys
import urllib.parse
import urllib.request
PRIMARY = {
"lounge": ("http://172.19.1.202:5380", "technitium/lounge/ns1-admin-password"),
"serenity": ("http://172.24.1.202:5380", "technitium/serenity/ns1-admin-password"),
# secondaries, for resync / inspection only — never add records here
"lounge-ns2": ("http://172.19.10.202:5380", "technitium/lounge/ns2-admin-password"),
"serenity-ns2": ("http://172.24.10.202:5380", "technitium/serenity/ns2-admin-password"),
}
def _pass(entry: str) -> str:
return subprocess.run(["pass", entry], capture_output=True, text=True, check=True).stdout.strip()
class Tech:
def __init__(self, site: str):
self.base, entry = PRIMARY[site]
self.token = self._call("/api/user/login", {"user": "admin", "pass": _pass(entry)}, auth=False)["token"]
def _call(self, path: str, params: dict, auth: bool = True) -> dict:
if auth:
params = {**params, "token": self.token}
data = urllib.parse.urlencode(params).encode()
req = urllib.request.Request(f"{self.base}{path}", data=data, method="POST")
with urllib.request.urlopen(req, timeout=20) as r:
body = json.loads(r.read().decode())
if body.get("status") != "ok":
raise SystemExit(f"{path}: {body.get('status')} {body.get('errorMessage', '')}")
# login puts its fields (incl. token) at the top level; everything else nests under "response"
return body.get("response", body)
def zones(self) -> list[dict]:
return self._call("/api/zones/list", {})["zones"]
def records(self, zone: str) -> list[dict]:
return self._call("/api/zones/records/get", {"domain": zone, "zone": zone, "listZone": "true"})["records"]
def add(self, zone: str, name: str, rtype: str, **kw) -> dict:
fqdn = zone if name in ("@", "") else f"{name}.{zone}"
return self._call("/api/zones/records/add", {"domain": fqdn, "zone": zone, "type": rtype, "ttl": "300", **kw})
def delete(self, zone: str, name: str, rtype: str, **kw) -> dict:
fqdn = zone if name in ("@", "") else f"{name}.{zone}"
return self._call("/api/zones/records/delete", {"domain": fqdn, "zone": zone, "type": rtype, **kw})
def add_zone(self, zone: str) -> dict:
return self._call("/api/zones/create", {"zone": zone, "type": "Primary"})
def main(argv: list[str]) -> int:
if len(argv) < 3:
print(__doc__)
return 2
site, cmd, args = argv[1], argv[2], argv[3:]
t = Tech(site)
if cmd == "zones":
for z in sorted(t.zones(), key=lambda z: z["name"]):
print(f"{z['name']:45s} {z['type']:10s} {'DISABLED' if z.get('disabled') else ''}")
elif cmd == "records":
for r in t.records(args[0]):
rd = r.get("rData", {})
val = rd.get("ipAddress") or rd.get("cname") or rd.get("nameServer") or json.dumps(rd)[:80]
print(f"{r['name']:50s} {r['type']:6s} ttl={r['ttl']:<6} {val}")
elif cmd == "add-cname":
print(json.dumps(t.add(args[0], args[1], "CNAME", cname=args[2]).get("addedRecord", {}))[:200])
elif cmd == "add-a":
print(json.dumps(t.add(args[0], args[1], "A", ipAddress=args[2]).get("addedRecord", {}))[:200])
elif cmd == "add-zone":
print(json.dumps(t.add_zone(args[0]))[:200])
elif cmd == "api":
# generic read: tech.py <host> api /api/zones/options/get zone=x [key ...]
path, params, keys = args[0], {}, []
for a in args[1:]:
(params.__setitem__(*a.split("=", 1)) if "=" in a else keys.append(a))
out = t._call(path, params)
print(json.dumps({k: out.get(k) for k in keys} if keys else out, indent=1)[:3000])
elif cmd == "logtail":
# /api/logs/download returns plain text, not JSON: tech.py <host> logtail <YYYY-MM-DD> [n]
params = urllib.parse.urlencode({"fileName": args[0], "limit": 5000, "token": t.token}).encode()
req = urllib.request.Request(f"{t.base}/api/logs/download", data=params, method="POST")
with urllib.request.urlopen(req, timeout=30) as r:
lines = r.read().decode(errors="replace").splitlines()
n = int(args[1]) if len(args) > 1 else 40
print("\n".join(l[:230] for l in lines[-n:]))
elif cmd == "resync":
# secondary zone: pull a fresh copy from its primary now instead of
# waiting for the SOA refresh timer
print(json.dumps(t._call("/api/zones/resync", {"zone": args[0]}))[:200])
elif cmd == "delete":
zone, name, rtype, value = args
key = "cname" if rtype == "CNAME" else "ipAddress"
print(json.dumps(t.delete(zone, name, rtype, **{key: value}))[:200])
else:
print(__doc__)
return 2
return 0
if __name__ == "__main__":
raise SystemExit(main(sys.argv))