> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# Ä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 \{#steg-1-bestall-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:

| Uppgift       | Exempel             |
| ------------- | ------------------- |
| Nyckelns namn | `example-dnsupdate` |
| Algoritm      | `hmac-sha512`       |
| Hemlighet     | en base64-sträng    |

:::warning Hemligheten är ett lösenord
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 \{#steg-2-spara-nyckeln}

De flesta verktyg läser nyckeln i BIND-format. Spara den i en fil, till
exempel `example.se.key`:

```
key "example-dnsupdate" {
  algorithm hmac-sha512;
  secret "<hemligheten>";
};
```

Se till att bara du kan läsa filen:

```bash
chmod 600 example.se.key
```

## Anslutningsuppgifter \{#anslutningsuppgifter}

| Inställning | Värde                                     |
| ----------- | ----------------------------------------- |
| Server      | `ns1.getgeek.se` (IPv4 och IPv6)          |
| Port        | 53, UDP och TCP                           |
| Zon         | din domän, t.ex. `example.se`             |
| Nyckel      | namnet du fått, t.ex. `example-dnsupdate` |
| Algoritm    | `hmac-sha512`                             |

Skicka alltid ändringarna till `ns1.getgeek.se`. De andra namnservrarna tar
inte emot DNS UPDATE.

## nsupdate \{#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:

```bash
nsupdate -k example.se.key <<EOF
server ns1.getgeek.se
zone example.se
update add www.example.se. 3600 A 192.0.2.10
send
EOF
```

Ä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:

```bash
nsupdate -k example.se.key <<EOF
server ns1.getgeek.se
zone example.se
update delete www.example.se. A
update add www.example.se. 3600 A 192.0.2.20
send
EOF
```

Ta bort en post:

```bash
nsupdate -k example.se.key <<EOF
server ns1.getgeek.se
zone example.se
update delete www.example.se. AAAA
send
EOF
```

`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`:

```bash
dig +short www.example.se A @ns1.getgeek.se
```

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 \{#terraform-och-opentofu}

Använd providern [`hashicorp/dns`](https://registry.terraform.io/providers/hashicorp/dns/latest/docs).
Nyckelns namn och zonen skrivs med punkt på slutet:

```hcl
terraform {
  required_providers {
    dns = {
      source = "hashicorp/dns"
    }
  }
}

variable "tsig_secret" {
  type      = string
  sensitive = true
}

provider "dns" {
  update {
    server        = "ns1.getgeek.se"
    key_name      = "example-dnsupdate."
    key_algorithm = "hmac-sha512"
    key_secret    = var.tsig_secret
  }
}

resource "dns_a_record_set" "www" {
  zone      = "example.se."
  name      = "www"
  addresses = ["192.0.2.10"]
  ttl       = 3600
}
```

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 \{#certifikat-med-dns-01}

ACME-klienter med stöd för RFC 2136 kan skapa `_acme-challenge`-posten själva.
Med [lego](https://go-acme.github.io/lego/dns/dnsupdate/) (version 5) kan du
använda nyckelfilen från steg 2 direkt:

```bash
DNSUPDATE_NAMESERVER=ns1.getgeek.se \
DNSUPDATE_TSIG_FILE=example.se.key \
lego run -m du@example.se --dns dnsupdate -d example.se -d '*.example.se'
```

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](#anslutningsuppgifter).

## Verktyg som behöver läsa hela zonen \{#verktyg-som-behover-lasa-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? \{#hur-snabbt-syns-andringen}

Ä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 \{#felsokning}

| Svar                                                                   | Trolig orsak                                                                                                                                                                                            |
| ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `update failed: REFUSED`                                               | Anropet var inte signerat, nyckeln gäller inte den här zonen, eller ändringen skickades till en annan server än `ns1.getgeek.se`.                                                                       |
| `TSIG error with server: expected a TSIG or SIG(0)` följt av `REFUSED` | Servern godkände inte signaturen: fel hemlighet, fel algoritm eller fel nyckelnamn. Det kan också bero på att klockan på din dator går fel, eftersom TSIG kräver att den går rätt på några minuter när. |
| `update failed: NXDOMAIN` eller `YXDOMAIN`                             | Ett villkor (`prereq`) i anropet var inte uppfyllt. Ingenting ändrades.                                                                                                                                 |
| `Communication with … failed: timed out`                               | Utgående trafik på port 53 blockeras, oftast av en brandvägg i ditt nät.                                                                                                                                |

Hjälper inget av det, skicka ett ärende med kommandot du körde (utan
hemligheten) och hela svaret.
