Kunden-Login
Webmail
Warenkorb
 
Dynamisches DNS - Dokumentation
1. DynDNS bei Domain aktivieren
Zunächst loggen Sie sich bitte auf die Domain-Verwaltungsoberfläche (User Frontend) ein. Klicken Sie nun im linken Navigationselement auf "Meine Domains".Wählen Sie im Folgenden den Domainnamen aus, den Sie für DynDNS aktivieren möchten - das linke Navigationselement wird sich daraufhin verändern. Aktivieren Sie nun unter "Nameserver" den Punkt "Dynamisches DNS" und klicken Sie auf der nun aufgerufenen Seite auf den Befehl "DynDNS jetzt aktivieren". Anschließend erhalten Sie lediglich ein "DynDNS Kennwort", weil es ein DynDNS Benutzernamen nicht gibt.
1.1. E-Mail Benachrichtigung bei Updates
Mit dem Befehl "aktivieren (derzeit deaktiv)" haben Sie die Möglichkeit per E-Mail über die neuesten Updates informiert zu werden. Dazu tragen Sie einfach nach dem Klick auf den "aktivieren"-Link Ihre E-Mail Adresse in das dafür vorgesehene Feld "Benachrichtigung senden an" ein. Damit die Aktion abgeschlossen ist, müssen Sie noch die Eingabe mit "Übernehmen »" bestätigen. Ab sofort erhalten Sie nach erfolgtem DynDNS-Update eine Benachrichtigung per E-Mail. Für den Fall, dass die Benachrichtigung über DynDNS-Updates nicht mehr erfolgen soll, "deaktivieren (derzeit aktiv)" Sie einfach über den gleichnamigen Button die Funktion.
2. Automatischer Update-Auftrag mit Hilfe von DynDNS Software
Bitte laden Sie sich die bevorzugte DynDNS Client-Software herunter und folgen Sie der Installationsanleitung des Herstellers. Achten Sie bitte darauf, dass der regfish DynDNS-Token meist als Benutzername verwendet werden muss. Das Kennwort können Sie in solchen Fällen leer lassen.
3. Manueller Update-Auftrag (nur für Software-Entwickler)
Der DynDNS Service steht über das URL https://dyndns.regfish.de/ zur Verfügung und kann sowohl über die HTTP Methoden "GET" als auch über "POST" angesprochen werden. Der Service ist sowohl per HTTPS (Port 443) als auch unverschlüsselt über HTTP (Port 80) erreichbar.
3.1. Parameter
Folgende Parameter stehen zur Verfügung:

Parameter Beispiel Standard Pflicht
token 77beb00bf597bbbf9dc3f2dc9f0b3ff5 Ja
fqdn athome.domain.de. Ja
thisipv4 1/0 0 Nein
ipv4 82.139.237.50 #REMOTE_ADDR# Nein
ipv6 2001:608:6::5 Nein
forcehost 1/0 0 Nein
ttl 60-86400 300 Nein
3.1.1. Der Parameter "token"
Anstelle von Benutzername und Kennwort (wie damals im REGFISH DynDNS 1) gibt es im DynDNS v2 nur den Parameter "token". Beim Aktivieren des DynDNS wird dieser automatisch für eine Domain erstellt und kann jederzeit mit einem neuen Token ersetzt werden.
3.1.2. Der Parameter "fqdn"
Beinhaltet den kompletten Namen (fqdn = Fully Qualified Domain Name) inklusive des Domainnamen, der Top Level Domain und einem abschliessendem Punkt. Aus dem Hostnamen "athome" wird so "athome.meine-domain.de.".
3.1.3. Der Parameter "thisipv4"
Der Parameter "thisipv4" (This IPv4) gibt an, ob die IP-Adresse des Anfrage stellenden Computers als neue IP-Adresse genutzt werden soll. Ist der Wert "1", wird also die IP des Anfrage stellenden Computers genutzt, während bei der Übermittlung des Wertes "0" ein weiterer Parameter obligatorisch wird, nämlich "ipv4".
3.1.4. Der Parameter "ipv4"
Beinhaltet die IP-Adresse (IPv4), die zukünftig via A-Eintrag mit dem Namen (Parameter "fqdn") verknüpft werden soll.
3.1.5. Der Parameter "ipv6"
Beinhaltet die IP-Adresse (IPv6), die zukünftig via AAAA-Eintrag mit dem Namen (Parameter "fqdn") verknüpft werden soll.
3.1.6. Der Parameter "forcehost"
Wenn der übermittelte "fqdn" noch nicht als Adresszeiger existiert, setzen Sie den Wert dieses Parameters auf "1", um es dem DynDNS Service zu erlauben, einen neuen Adress-Zeiger zu erstellen. Ist der Wert von "forcehost" auf "0", kann die IP-Adresse nur aktualisiert werden, wenn der fqdn bereits über das User Interface erstellt worden ist.
3.1.7. Der Parameter "ttl"
Die Übergabe des Parameters "ttl" ist keine Pflicht. Sie bewirkt, dass die Gültigkeitsdauer des Eintrages verändert wird. Bei DynDNS ist ein möglichst geringer Wert von Vorteil. Der Standard-Wert ist 300. Die Angabe erfolgt in Sekunden.  
3.2. Update-Beispiele
https://dyndns.regfish.de/?fqdn=www.xy.de.&thisipv4=1&token=77beb00bf597bbbf9dc3f2dc9f0b3ff5
https://dyndns.regfish.de/?fqdn=xy.de.&ipv4=11.11.11.1&token=77beb00bf597bbbf9dc3f2dc9f0b3ff5
https://dyndns.regfish.de/?fqdn=*.xy.de.&ipv4=11.11.11.1&token=77beb00bf597bbbf9dc3f2dc9f0b3ff5
4. [BETA] Manueller Update-Auftrag über IPV6 [BETA]
Der DynDNS Service über IPv6 befindet sich zu Zeit im Beta-Status und steht über das URL https://dyndns6.regfish.de/ zur Verfügung und kann sowohl über die HTTP Methoden "GET" als auch über "POST" angesprochen werden. Der Service ist sowohl per HTTPS (Port 443) als auch unverschlüsselt über HTTP (Port 80) erreichbar.
4.1. Parameter
Folgende Parameter stehen zur Verfügung:

Parameter Beispiel Standard Pflicht
token 77beb00bf597bbbf9dc3f2dc9f0b3ff5 Ja
fqdn athome.domain.de. Ja
thisipv6 1/0 0 Nein
ipv6 2001:608:6::5 Nein
forcehost 1/0 0 Nein
ttl 60-86400 300 Nein
4.1.1. Der Parameter "thisipv6"
Die Unterschiede im Zugriff auf den regfish dynDNS Dienst über eine IPv6 Adresse bestehen im Wegfall der IPv4 Parameter und des neuen Parameters "thisipv6".
Der Parameter "thisipv6" (This IPv6) gibt an, ob die IP-Adresse des Anfrage stellenden Computers als neue IP-Adresse genutzt werden soll. Ist der Wert "1", wird also die IP des Anfrage stellenden Computers genutzt, während bei der Übermittlung des Wertes "0" ein weiterer Parameter obligatorisch wird, nämlich "ipv6".
5. Fehlerauswertung / Codes & Status
CODE KONSTANTE BESCHREIBUNG
100 SUCCESS Aktualisierung erfolgreich durchgeführt.
101 SUCCESS_NONEED Es ist keine Aktualisierung notwendig. Alle Daten sind Up-To-Date!
401 STATUS_AUTH_STANDARD_WRONG Standard-Authentifizierung fehlgeschlagen.
402 STATUS_AUTH_SECURE_WRONG Authentifizierung fehlgeschlagen.
406 STATUS_RR_NOT_EXISTS Resource Record (RR) existiert nicht. Bitte nutzen Sie den Parameter "forcehost=1", um RRs automatisch zu erzeugen.
407 STATUS_TTL_RANGE Die TTL-Range ist ungültig.
408 STATUS_IPV4_INVALID Die übergebene IPv4 Adresse ist ungültig.
409 STATUS_IPV6_INVALID Die übergebene IPv6 Adresse ist ungültig.
410 STATUS_AUTHTYPE_UNKNOWN Unbekanntes Authentifizierungsverfahren
412 STATUS_DOMAINFORMAT_WRONG Der übergebene Domainname hat ein falsches FQDN-Format. Bitte denken Sie an den abschliessenden Punkt (z.B. "host.domain.de.")
414 STATUS_UNKNOWN_ERROR Es ist ein unerwarteter Fehler aufgetreten.
415 STATUS_LOADBALANCING_INVALID Loadbalancing-Einträge können nicht über DynDNS aktualisiert werden.