Hilfe

Sollte eine IP-Adressänderung festgestellt worden sein, so sollte der Client ein Update durchführen.
Diese Updates werden über unsere REST basierte API an diesen Dienst übermittelt.
Diese API-Anfrage wird mit einer Antwort beantwortet, die vom Client ausgewertet werden muss.

API-Hostnamen

Hostname: update.ddns.zone
HTTP-Port: 80
HTTPS-Port: 443

Updates können über HTTP oder SSL-verschlüsseltes HTTPS (bevorzugt) erfolgen.

Der Update-Hostname update.ddns.zone ist sowohl über IPv4 als auch über IPv6 erreichbar. Dabei wird die IP auf dem verfügbaren oder von Ihrem System bevorzugtem Protokoll ausgeführt. Soll das Update nur auf ein bestimmten Protokoll ausgeführt werden, so kann die IP als Parameter übergeben werden (s.u.) oder es kann eine der folgenden Update-Hostnamen benutzt werden:
IPv4 Update-Hostname: update4.ddns.zone
IPv6 Update-Hostname: update6.ddns.zone

Update-Parameter

Feld Beschreibung
hostname Dies ist der Hostname, der aktualisiert werden soll. Beispiel: test.ddns.zone
myip Die IP-Adresse die gesetzt werden soll.
Wird dieses Feld nicht gesetzt, so wird die IP-Adresse auf die IP-Adresse gesetzt, von der die Anfrage kommt.
Wird nur dieses Feld übergeben, so kann dies eine IPv4 oder IPv6 Adresse sein, wird es zusammen mit myip6 übergeben, so darf dieses Feld nur ein IPv4 Adresse sein.
myip6 Die IPv4-Adresse als Ergänzung zur unter myip übergebenen IPv4-Adresse für Dual-Stack Verbindungen.

API-Anfrage

Die Authentifizierung erfolg mittels HTTP-Basic-Auth.
Der Benutzername ist dabei der Benutzername, mit dem Sie sich auf DDNS.zone einloggen.
Das Passwort ist für jeden Hostnamen individuell und kann in der Domainliste abgefragt werden.

Beispiele:

https://update.ddns.zone/nic/ip
https://benutzername:passwort@update.ddns.zone/nic/update?hostname=test.ddns.zone
https://benutzername:passwort@update.ddns.zone/nic/update?hostname=test.ddns.zone&myip=198.51.100.230
https://benutzername:passwort@update.ddns.zone/nic/update?hostname=test.ddns.zone&myip=2001:db8:1001::5
https://benutzername:passwort@update.ddns.zone/nic/update?hostname=test.ddns.zone&myip=198.51.100.230&myip6=2001:db8:1001::5

Rückgabecodes

Feld Beschreibung
badauth Benutzername oder Kennwort war falsch.
good Die Aktualisierung war erfolgreich.
Wurde nur eine IP aktualisiert (IPv4 oder IPv6), so folgt im Anschluss noch die geänderte IP-Adresse!
nochg Die IP-Adresse wurde nicht aktualisiert, da sie sich nicht geändert hat.
Wurde nur eine IP angegeben (IPv4 oder IPb6), so folgt im Anschluss noch die aktuelle IP-Adresse!
notfqdn Der übergebene Hostname war kein gültiger vollqualifizierter Domainname.
nohost Der übergebene Hostname existiert nicht.
abuse Der übergebene Hostname wurde auf Grund von Missbrauch gesperrt.
dnserr Es ist ein DNS Fehler aufgetreten.
Bitte erneut versuchen!
911 Es ist ein unbekannter Fehler aufgetreten.
Bitte in einer halben Stunde erneut versuchen!

Fritz!Box

Dynamic DNS-Anbieter Benutzerdefiniert
Update-URL https://ddns.zone/nic/update?hostname=<domain>&myip=<ipaddr>&myip6=<ip6addr>
Domainname z.B. test.ddns.zone
Benutzername Loginname auf ddns.zone
Kennwort Passwort der Domain (nicht das Passwort für den Login auf ddns.zone)

 

Screenshots

Gallery Image

Sophos UTM

Typ DynDNS *
Zuweisen Erste öffentliche IP auf der Standardroute
Hostname z.B. test.ddns.zone
Benutzername Loginname auf ddns.zone
Kennwort Passwort der Domain (nicht das Passwort für den Login auf ddns.zone)

 

Screenshots

Gallery Image
Gallery Image