DNS-Tools

Vorschau

Verbundene Anwendungen sind derzeit nur für ausgewählte Konten freigeschaltet.

Vier Tools verwalten die Einträge deiner Domains auf den ITSH-Nameservern, dieselben Einträge wie im Abschnitt DNS-Einträge der Domain-Seite im Portal. Die Anwendung nennt die Domain, in Unicode- oder ASCII-Schreibweise. Was die Eintragstypen und Felder bedeuten, steht unter DNS-Einträge.

Eine Änderung gilt für das ganze Internet

Eine geänderte Zone wird innerhalb der TTL des Eintrags an alle ausgeliefert. MX-, CNAME-, NS-, CAA-, _acme-challenge- und _itsh-mail-Einträge bestimmen, wohin deine E-Mail und dein Traffic gehen, wer Zertifikate für die Domain ausstellen lassen darf und wer ihre E-Mail hosten darf. Die Tools sagen der Anwendung, jede Änderung mit dir abzustimmen; lies, was sie vorschlägt, bevor du zustimmst.

Die Tools

Tool	Was es tut	Braucht
dns_record_list	Listet die Einträge, auf Wunsch nur eines Namens oder Typs. Einträge, die ein DynDNS-Token verwaltet, fehlen	domain:read, dns:read
dns_record_create	Legt einen Eintrag an. Gibt es denselben Eintrag schon, wird nichts angelegt, ein erneuter Versuch ist also sicher	domain:read, dns:write
dns_record_update	Ändert die übergebenen Felder, anhand der ID des Eintrags. Das Ergebnis enthält den Eintrag vorher und nachher	domain:read, dns:write
dns_record_delete	Löscht einen Eintrag anhand von ID, Name und Typ, die alle noch passen müssen. Das Ergebnis enthält den gelöschten Eintrag, der einzige Weg, ihn zurückzuholen	domain:read, dns:write

Der Name ist @ für die Domain selbst, ein Name relativ zu ihr wie www oder der vollständige Name. Ein MX-, CNAME- oder NS-Ziel ohne Punkt wird um die Domain ergänzt, wie im Portal.

Zulässige Werte

Feld	Zulässig	Standard
TTL	300 bis 86.400 Sekunden	3.600
Priorität	0 bis 65.535, nur bei MX, SRV, URI, HTTPS, SVCB und NAPTR	10
Inhalt	Bis zu 4.096 Zeichen, keine Steuerzeichen	Keiner
Typ	Bis zu 12 Buchstaben und Ziffern	Keiner

Was abgelehnt wird, und warum

NS- und SOA-Einträge

Solange eine Domain die ITSH-Nameserver nutzt, gehören ihre NS- und SOA-Einträge zur Zone selbst und lassen sich weder ändern noch löschen. Ein Löschen wird zum Beispiel so abgelehnt:

NS records cannot be deleted while example.com uses ITSH's nameservers.

Nameserver änderst du unter Nameserver auf der Domain-Seite im Portal, nicht mit diesen Tools.

Unsichtbare Zeichen

Eine Domain, ein Name oder ein Typ wird abgelehnt, wenn er ein Zeichen enthält, das als nichts erscheint oder seine Nachbarn umordnet, etwa U+202E oder U+3164, oder wenn er mit einem Leerzeichen außerhalb von ASCII beginnt oder endet:

name contains an invisible character.

name starts or ends with a space character outside ASCII.

Der Grund: Ein solcher Name wird zu einem gültigen Label, das überall, wo es angezeigt wird, umgeordnet oder leer aussieht. Der Name, dem du zustimmen sollst, ist dann nicht der, der geschrieben wird. Niemand tippt diese Zeichen absichtlich. Beim Inhalt werden nur Steuerzeichen abgelehnt: content contains a control character.

Domains auf anderen Nameservern

Eine Domain, deren Nameserver woandershin zeigen, wird mit external_nameservers abgelehnt, weil ihre Einträge bei ITSH nicht das sind, was das Internet sieht. Die Antwort sagt der Anwendung, den Eintrag beim DNS-Anbieter zu ändern, auf den die Nameserver zeigen, und verlinkt die Domain-Seite im Portal, die die Nameserver zeigt. Siehe Eigene Nameserver verwenden.

Weitere Ablehnungen

Code	Ursache
dyndns_managed	„A DynDNS token manages this name, so its A and AAAA records change only through DynDNS.“
record_mismatch	Die ID beim Löschen gehört inzwischen zu einem anderen Eintrag. Nichts wird gelöscht

Limits

Limit	Wert
Eintrags-Anfragen	10 pro Minute je Konto, über alle seine Verbindungen. Auflisten zählt 1, Anlegen 1 (2, wenn der Eintrag schon existiert), Ändern und Löschen 2
Registrar-Aufrufe	6 pro Minute je Konto, über alle seine Verbindungen
Registrar-Aufrufe je Tool-Aufruf, höchstens	Auflisten 1, Anlegen 5 (6, wenn der Eintrag schon existiert), Ändern 5, Löschen 4, dazu 1 für die Prüfung der Nameserver der Domain, höchstens alle 5 Minuten je Domain
Zeit je Aufruf	45 Sekunden

Jeder Aufruf reserviert seine Registrar-Aufrufe vorab, deshalb legen die Anwendungen eines Kontos in der Praxis etwa einen Eintrag pro Minute an. Ein Aufruf, der nicht gedeckt ist, wird vor dem Start mit registrar_budget_exhausted und den Sekunden bis zum nächsten Versuch abgelehnt:

the applications connected to this account have used its registrar calls for now, retry in 42 seconds

Derselbe Code mit „the registrar is busy with other work right now“ heißt, dass die Registrar-Kapazität für alle verbundenen Anwendungen ausgelastet ist; das liegt nicht an deinem Konto. Eine Änderung, die an das 45-Sekunden-Limit stößt, ist vielleicht ausgeführt worden, vielleicht nicht. Die Anwendung sollte die Einträge deshalb neu auflisten, bevor sie es noch einmal versucht.

Wie es weitergeht

• E-Mail-Tools, um die Mail-Einträge in einem Schritt zu schreiben
• Verbindungen verwalten für das, was jede Änderung festgehalten hat