Wildcard-Zertifikate ueber Plesk-DNS und Let's Encrypt

Legt den A/AAAA-Record fuer einen Namen in Plesk an bzw. aktualisiert ihn und
holt anschliessend per DNS-01-Challenge ein Wildcard-Zertifikat von Let's
Encrypt. Alle Bestandteile werden einzeln abgelegt, zusaetzlich als
kombinierte bundle.pem und als passwortgeschuetzte cert.pfx.

- Plesk-Anbindung ueber die XML-API (Zone finden, Records lesen/anlegen/loeschen)
- ACME-Order mit dns-01, Account-Key wird wiederverwendet
- Propagations-Check gegen die autoritativen Nameserver der Zone, bricht vor
  der Validierung ab statt einen Fehlversuch bei Let's Encrypt zu verbrennen
- Renewal-Check: laeuft idempotent, taugt so direkt fuer den Cron
- Docker-Container, Konfiguration ueber .env, Ausgabe im Projektverzeichnis
- Tests ohne echten Plesk-Server bzw. ohne Zertifikatsausstellung

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
duffyduck
2026-08-13 09:41:26 +02:00
co-authored by Claude Opus 5
commit fd76c18eb0
17 changed files with 2080 additions and 0 deletions
+117
View File
@@ -0,0 +1,117 @@
"""DNS propagation checks for the ACME dns-01 challenge."""
from __future__ import annotations
import logging
import time
import dns.exception
import dns.flags
import dns.message
import dns.query
import dns.rdatatype
import dns.resolver
log = logging.getLogger(__name__)
QUERY_TIMEOUT = 5.0
def _resolver(nameservers: list[str] | None = None) -> dns.resolver.Resolver:
res = dns.resolver.Resolver(configure=not nameservers)
if nameservers:
res.nameservers = nameservers
res.lifetime = QUERY_TIMEOUT * 2
res.timeout = QUERY_TIMEOUT
return res
def authoritative_servers(zone: str, fallback_resolvers: list[str]) -> list[str]:
"""IP addresses of the authoritative nameservers of *zone*."""
ips: list[str] = []
names: list[str] = []
for res in (_resolver(), _resolver(fallback_resolvers)):
try:
answer = res.resolve(zone, "NS", raise_on_no_answer=False)
names = sorted({str(rdata.target).rstrip(".") for rdata in answer})
if names:
break
except dns.exception.DNSException as exc:
log.debug("NS lookup for %s failed: %s", zone, exc)
lookup = _resolver(fallback_resolvers)
for name in names:
for rtype in ("A", "AAAA"):
try:
for rdata in lookup.resolve(name, rtype, raise_on_no_answer=False):
ips.append(str(rdata))
except dns.exception.DNSException:
continue
unique = list(dict.fromkeys(ips))
if unique:
log.info("Authoritative nameservers for %s: %s (%s)", zone, ", ".join(names), ", ".join(unique))
else:
log.warning("Could not determine authoritative nameservers for %s, using public resolvers.", zone)
return unique
def txt_values(name: str, server: str) -> set[str]:
"""TXT values for *name* as seen by the DNS server at *server*."""
query = dns.message.make_query(name, dns.rdatatype.TXT)
values: set[str] = set()
try:
response = dns.query.udp(query, server, timeout=QUERY_TIMEOUT)
if response.flags & dns.flags.TC:
response = dns.query.tcp(query, server, timeout=QUERY_TIMEOUT)
except dns.exception.DNSException as exc:
log.debug("TXT query %s @%s failed: %s", name, server, exc)
return values
for rrset in response.answer:
if rrset.rdtype != dns.rdatatype.TXT:
continue
for rdata in rrset:
values.add(b"".join(rdata.strings).decode("utf-8", "replace"))
return values
def wait_for_txt(
expected: dict[str, set[str]],
servers: list[str],
timeout: int,
interval: int,
) -> bool:
"""Block until every server serves every expected TXT value, or *timeout* expires."""
if not servers:
log.warning("No DNS servers to verify against - waiting %ss blindly.", interval * 2)
time.sleep(interval * 2)
return False
deadline = time.monotonic() + timeout
attempt = 0
while True:
attempt += 1
missing: list[str] = []
for name, wanted in expected.items():
for server in servers:
seen = txt_values(name, server)
for value in wanted:
if value not in seen:
missing.append(f"{name} @{server}")
break
if not missing:
log.info("DNS propagation confirmed on all %d nameserver(s).", len(servers))
return True
remaining = deadline - time.monotonic()
if remaining <= 0:
log.error("DNS propagation timed out. Still missing: %s", ", ".join(sorted(set(missing))))
return False
log.info(
"Attempt %d: waiting for DNS propagation (%d pending, %ds left)...",
attempt,
len(set(missing)),
int(remaining),
)
time.sleep(min(interval, max(1, int(remaining))))