Dynamic DNS (DynDNS, DDNS) ist ein Service, der DNS-Einträge automatisch aktualisieren kann, wenn sich eine IP-Adresse ändert. DynDNS wird zum Beispiel häufig verwendet, wenn ein Server, der bei jemandem zu Hause steht, erreichbar gemacht werden soll, wenn sich die IP-Adresse durch den Provider regelmäßig ändert. Mit der DynDNS-API kannst du automatisiert den A- (IPv4) und/oder AAAA-Record (IPv6) einer Domain oder Subdomain in deinem netcup-Account aktualisieren. Mit DynDNS ruft dein Router oder ein Skript die URL in regelmäßigen Abständen auf und trägt die aktuelle IP-Adresse automatisch in deine CloudDNS-Zone ein.

Um die DynDNS-API nutzen zu können, musst du bestimmte Voraussetzungen erfüllen:

• Die Domain muss über CloudDNS verwaltet werden.
• Du besitzt ein gültiges Token zur Authentifizierung.
• Es wird mindestens eine IP-Adresse (IPv4 oder IPv6) übergeben, zum Beispiel: https://customercontrolpanel.de/wsDynDns.php?action=update&token=DEIN_TOKEN&fqdn=home.example.com&ipv4Address=203.0.113.10
• Für IPv6 muss zusätzlich oder alternativ ipv6Address angeben werden: https://customercontrolpanel.de/wsDynDns.php?action=update&token=DEIN_TOKEN&fqdn=home.example.com&ipv4Address=203.0.113.10&ipv6Address=2001:db8::10

Im Folgenden erhältst du eine Übersicht über die verwendeten Parameter:

• DynDNS ermittelt automatisch, welcher Teil des FQDN die im Account vorhandene Domain und welcher Teil der Host ist. Dies wird auch bei mehrteiligen Top-Level-Domains (TLDs) ermittelt, wie z. B. ".co.uk".
  • "home.example.com" → Domain: "example.com", Host: "home"
  • "example.com" → Domain: "example.com", Host: "@" (Root der Zone)
• Internationalisierte Domainnamen werden intern nach Punycode umgewandelt.
• Wird keine passende Domain im Account gefunden, wird der Request mit dem HTTP-Fehlercode 404 abgewiesen.
• Wird die Domain nicht über CloudDNS verwaltet, wird der Request mit dem HTTP-Fehlercode 400 abgewiesen.

• Neue Einträge werden mit dem Standard-time-to-live (TTL) und der Standard-Region angelegt.
• Es können in einem Aufruf gleichzeitig A- und AAAA-Record aktualisiert werden.

Eine Anleitung für das Einrichten von DynDNS in deiner FRITZ!Box findest du hier:

• https://fritz.com/de-at/apps/knowledge-base/FRITZ-Box-7590/30_Dynamic-DNS-in-FRITZ-Box-einrichten (externer Link)

Trage im Laufe der Einrichtung Folgendes in die dafür vorgesehenen Felder ein:

• Update-URL: https://customercontrolpanel.de/wsDynDns.php?action=update&token=<pass>&fqdn=<domain>&ipv4Address=ipaddr>&ipv6Address=<ip6addr>
• Domainname: <sub.domain.tld>
• Benutzername: Kundennummer
• Kennwort 

Für den ermittelten Host wird der bestehende A- bzw. AAAA-Record geprüft:

1. Der Eintrag existiert bereits mit exakt dieser IP-Adresse.
   1. Es ist keine Änderung nötig.
2. Der Eintrag existiert mit abweichender IP-Adresse.
   1. Der Eintrag wird mit der übergebenen IP-Adresse angepasst.
3. Der Eintrag existiert noch nicht.
   1. Ein neuer Eintrag wird angelegt. Werden dadurch tatsächlich Änderungen vorgenommen, werden diese in der CloudDNS-Zone gespeichert. Sind alle übergebenen Werte bereits gesetzt, erfolgt keine Änderung.

Die Antwort erfolgt als JSON (Content-Type: text/json; charset=utf-8):

• "Record(s) have been saved." – Änderungen wurden gespeichert.
• "No record update needed." – Alle Werte waren bereits aktuell.

API

CloudDNS

DNS anpassen (CloudDNS)

Eigene Nameserver hinterlegen (CloudDNS)

DNSSEC (CloudDNS)