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
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".
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. |