DNS API

Når du opretter eller retter DNS-poster i netsite.app, sker det allerede gennem vores DNS API. Det samme API åbner vi op for direkte programmatisk adgang, så du kan automatisere præcis de samme handlinger med kode i stedet for at klikke i kontrolpanelet.

Det samme som kontrolpanelet, bare automatiseret

DNS API'et giver adgang til de samme handlinger, som du kender fra DNS-siden i kontrolpanelet. Du kan oprette, hente, rette og slette DNS-poster (A, AAAA, CNAME, MX, TXT, NS, SRV og CAA) for de domæner, der ligger på din konto, og opsætte URL-viderestillinger.

Det betyder, at du kan bygge DNS-opsætning ind i dine egne scripts, værktøjer og automatiserede arbejdsgange (f.eks. infrastructure as code). DNS API'et er især nyttigt, hvis du er udvikler eller driver et bureau med mange domæner og gerne vil automatisere opsætningen frem for at rette hver post manuelt.

Dedikerede API-nøgler

Adgang sker med dedikerede API-nøgler, du selv opretter og knytter til din konto. Nøglerne er adskilt fra dit almindelige login, så du kan give et script eller en integration adgang uden at dele dine personlige adgangsoplysninger. Skal en nøgle ikke længere bruges, kan du tilbagekalde den.

Automatiske certifikater med ACME DNS-01

En af de mest oplagte anvendelser er automatisk udstedelse og fornyelse af SSL-certifikater med ACME DNS-01-metoden. ACME understøttes af flere certifikatudstedere (bl.a. Let's Encrypt, ZeroSSL og Buypass), så du er ikke bundet til én udbyder. Metoden er især relevant for wildcard-certifikater (f.eks. *.eksempel.dk), der typisk kun kan udstedes via DNS-01. DNS-01 fungerer ved, at din ACME-klient opretter en midlertidig TXT-værdi under _acme-challenge på domænet (f.eks. _acme-challenge.eksempel.dk). Værdien beregnes for den konkrete challenge og fjernes igen efter validering. Skal både rod-domænet og et wildcard valideres, kan der ligge flere TXT-værdier på samme _acme-challenge-navn samtidig. Med API'et kan klienten selv håndtere de TXT-poster, hver gang et certifikat skal udstedes eller fornyes, uden manuelle trin.

Vi udvikler en DNS-authenticator til certbot og en dnsapi-integration til acme.sh, så du kan udstede og forny certifikater (også wildcard) fuldautomatisk fra dine egne servere, uanset hvilken ACME-udsteder du vælger.

Husk, at DNS-ændringer kan tage tid at slå igennem. Se DNS-ændringer og TTL, hvis en validering ikke lykkes med det samme.

Sådan kommer du i gang i dag

Indtil API'et åbner, opsætter du DNS i kontrolpanelet. Log på netsite.app og gå til DNS. I guiden til DNS-opsætning kan du se de enkelte felter og posttyper. DNS er en del af DNS Service og følger med alle vores webhoteller.

Vi opdaterer denne side, når DNS API'et og vores integrationer til certbot og acme.sh er klar.