Ändra poster via DNS UPDATE
Du kan skapa, ändra och ta bort poster i din zon programmatiskt med
standardprotokollet DNS UPDATE (RFC 2136). Ändringarna signeras med en
TSIG-nyckel som bara gäller din zon. Det fungerar med nsupdate,
Terraform/OpenTofu, ACME-klienter och de flesta automationsverktyg.
I exemplen nedan heter zonen example.se och nyckeln example-dnsupdate.
Byt till dina egna värden.
Steg 1: Beställ en nyckel
Skicka ett ärende i portalen och skriv vilken zon nyckeln ska gälla. Vi skapar nyckeln och lägger till den på din domän. Det görs manuellt av oss just nu. Vi arbetar på att du ska kunna hantera nycklarna själv i portalen.
Du får tre uppgifter:
Den som har hemligheten kan ändra alla poster i din zon. Lägg den inte i ett git-repo i klartext, och skicka den inte vidare i mejl. Tror du att den har läckt, kontakta oss så byter vi den direkt.
Steg 2: Spara nyckeln
De flesta verktyg läser nyckeln i BIND-format. Spara den i en fil, till
exempel example.se.key:
Se till att bara du kan läsa filen:
Anslutningsuppgifter
Skicka alltid ändringarna till ns1.getgeek.se. De andra namnservrarna tar
inte emot DNS UPDATE.
nsupdate
nsupdate ingår i BIND-verktygen: paketet bind9-dnsutils på Debian och
Ubuntu, bind-utils på Rocky, Alma och Fedora, och bind i Homebrew.
Lägg till en post:
Ändra en post. Ta bort den gamla och lägg till den nya i samma anrop, så genomförs antingen båda eller ingen av dem:
Ta bort en post:
update delete <namn> <typ> tar bort alla poster av den typen på namnet. Vill
du bara ta bort en av flera, ange värdet också:
update delete www.example.se. A 192.0.2.10.
Inget svar betyder att ändringen gick igenom. Kontrollera den med dig:
Det kan ta upp till några minuter innan dig visar ändringen, även mot
ns1.getgeek.se. Själva ändringen är redan sparad, men namnservrarna kan
fortfarande svara ur sin cache.
Terraform och OpenTofu
Använd providern hashicorp/dns.
Nyckelns namn och zonen skrivs med punkt på slutet:
Ge hemligheten via miljövariabeln TF_VAR_tsig_secret i stället för att
skriva den i en fil i repot.
dns_a_record_set äger alla A-poster på namnet. Finns det redan A-poster på
www som inte står i addresses tar Terraform bort dem, och terraform destroy tar bort alla A-poster på namnet.
Certifikat med DNS-01
ACME-klienter med stöd för RFC 2136 kan skapa _acme-challenge-posten själva.
Med lego (version 5) kan du
använda nyckelfilen från steg 2 direkt:
I lego 4 heter providern rfc2136 och variablerna börjar med RFC2136_.
acme.sh (dns_nsupdate), certbot (certbot-dns-rfc2136) och cert-manager
(rfc2136) fungerar på samma sätt, med uppgifterna under
Anslutningsuppgifter.
Verktyg som behöver läsa hela zonen
Vissa verktyg, till exempel external-dns i Kubernetes, hämtar hela zonen (zonöverföring, AXFR) för att se vilka poster som finns. Det är inte påslaget från början. Skriv i ärendet att du vill ha det, så ger vi din nyckel läsrätt till zonen.
Hur snabbt syns ändringen?
Ändringen syns oftast på alla våra namnservrar inom en minut, ibland efter några minuter. Resolvrar som redan har cachat det gamla svaret visar det tills postens TTL har gått ut. Sänk TTL:en i förväg om du planerar en flytt.
Felsökning
Hjälper inget av det, skicka ett ärende med kommandot du körde (utan hemligheten) och hela svaret.