Update API (DDNS): dyndns2-Protokoll, Authentifizierung, Antwortcodes

Protokoll

Alviy aktualisiert dynamische Adressen über das Standardprotokoll dyndns2, das auch DynDNS und No-IP verwenden. Jeder gängige Client funktioniert: inadyn, ddclient, OpenWrt ddns-scripts, das integrierte DDNS von Routern (ASUS, Keenetic, MikroTik und andere) sowie die Alviy-Clients.

Die Adresse des Dienstes ist fest: dynupdate.alviy.com, ausschließlich über HTTPS.

Endpunkte

Anfrage	Zweck
`GET https://dynupdate.alviy.com/nic/update?hostname=<host>&myip=<ip>`	Adresse aktualisieren, Basic-Authentifizierung
`GET https://dynupdate.alviy.com/token/update?hostname=<host>&token=<token>&myip=<ip>`	Adresse aktualisieren, Token im Query-String („sichere Aktualisierung“)
`GET https://dynupdate.alviy.com/checkip`	aktuelle externe IP-Adresse des Aufrufers, `text/plain`, ohne Authentifizierung

hostname ist ein Pflichtparameter. myip ist optional: Fehlt der Parameter oder lässt er sich nicht als IP-Adresse auslesen, verwendet der Server die Absenderadresse der Anfrage, wie es die dyndns2-Spezifikation vorsieht.

Authentifizierung

/nic/update akzeptiert HTTP Basic:

username: die E-Mail-Adresse Ihres Alviy-Kontos;
password: das Host-Token (empfohlen) oder das Passwort des Kontos.

Das Host-Token ist dasselbe, das auch /token/update akzeptiert. Sie aktivieren es auf der Seite des Hosts in Ihrem Alviy-Konto (Abschnitt „Secure update“); es gilt jeweils nur für einen Hostnamen. Tragen Sie in Router-Konfigurationen das Token ein, nicht das Kontopasswort: Gelangt eine Konfiguration in fremde Hände, bleibt das Konto geschützt, und das Token lässt sich mit einem Klick widerrufen.

Antwortcodes

Die Antwort steht als einfacher Text im Body; der HTTP-Status ist immer 200 (wie bei dyndns2). Clients werten den Body wörtlich aus.

Antwort	Bedeutung
`good <ip>`	Adresse aktualisiert
`nochg <ip>`	Adresse unverändert (wiederholte Aktualisierungen sind unproblematisch)
`badauth`	falscher Benutzername, falsches Passwort oder Token
`notfqdn`	Hostname fehlt oder ist kein gültiger Domainname
`nohost`	Hostname existiert nicht oder gehört nicht zu diesem Konto
`911`	interner Serverfehler, später erneut versuchen

Beispiele

curl

curl -u you@example.com:YOUR_TOKEN \
  "https://dynupdate.alviy.com/nic/update?hostname=myhost.didns.ru&myip=203.0.113.7"
# → good 203.0.113.7

inadyn (eigener Anbieter)

period = 300

custom alviy {
    username    = you@example.com
    password    = YOUR_TOKEN
    ddns-server = dynupdate.alviy.com
    ddns-path   = "/nic/update?hostname=%h&myip=%i"
    checkip-server = dynupdate.alviy.com
    checkip-path   = "/checkip"
    hostname    = myhost.didns.ru
}

ddclient

protocol=dyndns2
use=web, web=dynupdate.alviy.com/checkip
server=dynupdate.alviy.com
ssl=yes
login=you@example.com
password='YOUR_TOKEN'
myhost.didns.ru

Router mit der Option eines benutzerdefinierten DDNS-Anbieters („custom“): Verwenden Sie die URL https://dynupdate.alviy.com/nic/update?hostname=<host>&myip=<ip> mit den oben beschriebenen Basic-Zugangsdaten.