Domain Registration Robot mit

Transkript

1 Domain Registration Robot mit Der Hetzner Registration Robot kann direkt mit -Templates oder indirekt über das Web-Interface gesteuert werden. Wobei das Web-Interface nur als grafischer Generator für Standard- s dient. Nachfolgende Beschreibungen über das Format der s gelten daher auch bei Verwendung der grafischen Oberfläche. Grundsätzlich erlaubt der Hetzner Registration Robot das Anlegen von Handles in den Whois- Datenbanken von DENIC, ABC und nic.at. DENIC-Handles werden für das Registrieren von.de Domains, ABC-Handles für die Toplevel-Domains.com,.org,.net,.info,.biz und.eu und nic.at- Handles für.at Domains benötigt. Es muss hierbei nicht für jede Domain ein neues Handle angemeldet werden, vielmehr sollte das Handle einer Person für alle Domains dieser Person verwendet werden. Die Daten des Handles können jederzeit geändert werden. Desweiteren ist es mit dem Robot möglich, Nameservereinträge zu verwalten. Für die spätere Registrierung einer Domain müssen bereits beide Nameserver konfiguriert werden. Der Robot ermöglicht es Ihnen, den primären und den sekundären Nameserver einzurichten. Es ist allerdings auch möglich, nur den sekundären zu verwenden, wobei Sie den primären selbst betreiben. Bitte beachten Sie, dass es bis zu 10 Minuten dauern kann, bis neu angelegte Nameservereinträge auf unseren Nameservern aktiv werden. Da die DENIC bei jeder Domainregistrierung auch eine Nameserver-Prüfung durchführt, sollte ein Auftrag zur Registrierung erst 10 Minuten nach dem Auftrag zum Anlegen des Nameservereintrags an unseren Robot gesendet werden. Andernfalls kann die Domain nicht konnektiert werden und erfordert ein nachträgliches Update. Der Robot übernimmt auch vollständig die Registrierung von Domainnamen für Sie. Domains mit dem Toplevel.de werden von uns direkt bei der DENIC eg angemeldet. Bitte beachten Sie die folgende Beschreibung der einzelnen Aufträge und die Einschränkungen bei den akzeptierten Daten. Allgemeiner Aufbau eines Auftrags Bei der Anmeldung für den Robot konnten Sie drei -Adressen angeben, von denen Sie aus sendeberechtigt sind. Aufträge von anderen Adressen werden verworfen. Aufträge sollten PGPsigniert sein. Den Public-Key müssen Sie zunächst bei uns hinterlegt haben. Wenn keine Signierung vorgenommen wird, muss das Passwort für den Robot-Zugang angegeben werden. Außerdem können Sie Ihre Aufträge auch mit unserem öffentlichen Schlüssel verschlüsseln. Diesen finden Sie im Robot unter dem Menüpunkt Administration Einstellungen Öffentliche Schlüssel. Bitte beachten Sie, dass verschlüsselte Auftrag- s auch gleichzeitig mit Ihren privaten Schlüssel signiert sein müssen. Eine Verschlüsselung empfehlen wir dringend bei KK- Aufträgen von.de-domains, bei denen ein Auth-Code angegeben wird. In der Betreffzeile müssen keine besonderen Angaben gemacht werden, sie kann frei von Ihnen gewählt werden. Bei der Antwort des Robots wird Ihre Auftrags angehängt. Die vorgegebene Reihenfolge der Felder des Auftrags darf nicht vertauscht werden. Kommentare können von Ihnen jederzeit in beliebiger Position und Zahl im Auftrag eingefügt werden. Nur sollten diese in extra Zeilen stehen und keine Schlüsselwörter für Auftragsfelder enthalten. Die -Adresse des Robots lautet: Im weiteren sind Angaben, die im Kopf der stehen müssen, fett und Kommentare sowie Beschreibungen der Feldinhalte kursiv angegeben.

2 Domain Registration Robot Handle generieren job: handle task: new tld: [DE/CN/ORG/INFO/BIZ/EU/AT] type: [PERSON/ORG] fname: ; Vorname lname: ; Nachname company: ; Firmenname address: ; Straße und Hausnummer pcode: ; Postleitzahl city: ; Stadt country: ; Länderkürzel phone: ; Telefonnummer fax: ; Faxnummer mail: ; -Adresse handle: new Für die Angabe der einzelnen Felder gilt folgendes: Für die Angabe der Top Level Domain muss das Schlüsselwort tld verwendet werden. In älteren Versionen des Robots wurde dazu das Schlüsselwort type genutzt, welches nun aber zur Angabe des Handletyps verwendet wird. Firmenhandles können nur für.de,.com/.net,.eu und.at Handles angelegt werden. Bei allen anderen TLDs ist daher nur der Wert PERSON zulässig. Die Felder fname und lname ergeben nur bei Personenhandles einen Sinn. Bei Firmenhandles müssen Sie diese beiden Felder komplett weglassen, sonst kann der Auftrag nicht bearbeitet werden. Ausnahme sind hierbei.eu-handles. Bei einem.eu-handle müssen die Felder fname und lname immer angegeben, selbst bei einem Firmenhandle. Das Feld company muss sowohl bei Personen- als auch bei Firmenhandles vorhanden sein. Bei Firmenhandles geben Sie dadurch den Namen der Firma an. Bei einem Personenhandle können Sie das Feld nutzen um zusätzlich zum Vor- und Nachnamen eine Firma anzugeben. Bei Personenhandles kann es auch leer gelassen werden. Beim Feld country müssen Sie das jeweilige zweistellige Länderkürzel angeben. Eine Liste aller Länderkürzel finden Sie unter Telefon- und Faxnummern geben Sie bitte im internationalen Format an (Beipsiel: ). Der Vor- und Nachname muss bei allen TLDs außer.de und.at mit einem Großbuchstaben beginnen.

3 Domain Registration Robot Handle generieren Beispielauftrag für ein Personenhandle: job: handle task: new tld: DE type: PERSON fname: Markus lname: Mustermann company: Hetzner Online AG address: Industriestrasse 6 pcode: city: Gunzenhausen country: DE phone: fax: mail: info@hetzner.de handle: new Beispielauftrag für ein Firmenhandle: job: handle task: new tld: DE type: ORG company: Hetzner Online AG address: Industriestrasse 6 pcode: city: Gunzenhausen country: DE phone: fax: mail: info@hetzner.de handle: new

4 Domain Registration Robot Handle ändern job: handle task: upd tld: [DE/CN/ORG/INFO/BIZ/EU/AT] type: [PERSON/ORG] fname: ; Vorname lname: ; Nachname company: ; Firmenname address: ; Straße und Hausnummer pcode: ; Postleitzahl city: ; Stadt country: ; Länderkürzel phone: ; Telefonnummer fax: ; Faxnummer mail: ; -Adresse handle: ; das zu ändernde Handle Hinweis: Für die Angabe der einzelnen Felder erfolgt analog dem Auftrag Handle generieren. Zusätzlich muss hier am Ende das zu ändernde Handle angegeben werden. Bitte beachten Sie, dass bei einem Personen-Handle der Vor- und Nachname und bei einem Firmenhandle der Firmenname nicht geändert werden kann. job: handle task: upd tld: DE type: PERSON fname: Markus lname: Mustermann company: Hetzner Online AG address: Industriestrasse 6 pcode: city: Gunzenhausen country: DE phone: fax: mail: info@hetzner.de handle: DENIC-168-robot-1 PTWh

5 Domain Registration Robot Handle löschen job: handle task: del tld: [DE/CN/ORG/INFO/BIZ/EU/AT] handle: ; das zu ändernde Handle job: handle task: del tld: DE handle: DENIC-168-robot-1 PTWh

6 Domain Registration Robot Domain registrieren task: new domain: [a-za-z0-9-]{3,60}.(de com net org info biz eu at co.at or.at) ; Domainname holder: ; DENIC-, ABC- oder nic.at-handle des Domaininhabers holder: ; DENIC-Handle des 2. Domaininhabers (optional) holder: ; DENIC-Handle des 3. Domaininhabers (optional) holder: ; DENIC-Handle des 4. Domaininhabers (optional) holder: ; DENIC-Handle des 5. Domaininhabers (optional) adminc: ; DENIC-, ABC oder nic.at-handle des Administrators (leer bei.eu) techc: ; DENIC-, ABC oder nic.at-handle des tech. Ansprechpartners (leer bei.eu) zonec: ; DENIC-, ABC oder nic.at-handle des Zonenverwalters (leer bei.eu und.at) ns1: ; Hostname des primären Nameservers ns2: ; Hostname des sekundären Nameservers ns3: ; Hostname des 3. Nameservers (optional) ns4: ; Hostname des 4. Nameservers (optional) ns5: ; Hostname des 5. Nameservers (optional) Hinweis: Wird das Feld holder bei.de-domains mehr als einmal verwendet, so dürfen die einzelnen Handles dort nicht mehrfach auftauchen. Werden bei.eu-domains die Felder adminc, techc und zonec ausgefüllt, werden diese ignoriert. task: new domain: hetzner.de holder: DENIC-168-Martin-Hetzner-1 adminc: DENIC-168-Martin-Hetzner-1 techc: DENIC-168-Martin-Hetzner-1 zonec: DENIC-168-Martin-Hetzner-1 ns1: ns1.first-ns.de ns2: robotns2.second-ns.de ns3: robotns3.second-ns.com

7 Domain Registration Robot Domain ändern task: upd domain: [a-za-z0-9-]{3,60}.(de com net org info biz eu at co.at or.at) ; Domainname holder: ; DENIC-, ABC- oder nic.at-handle des Domaininhabers holder: ; DENIC-Handle des 2. Domaininhabers (optional) holder: ; DENIC-Handle des 3. Domaininhabers (optional) holder: ; DENIC-Handle des 4. Domaininhabers (optional) holder: ; DENIC-Handle des 5. Domaininhabers (optional) adminc: ; DENIC-, ABC- oder nic.at-handle des Administrators (leer bei.eu) techc: ; DENIC-, ABC- oder nic.at-handle des tech. Ansprechpartners (leer bei.eu) zonec: ; DENIC-, ABC- oder nic.at-handle des Zonenverwalters (leer bei.eu und.at) ns1: ; Hostname des primären Nameservers ns2: ; Hostname des sekundären Nameservers ns3: ; Hostname des 3. Nameservers (optional) ns4: ; Hostname des 4. Nameservers (optional) ns5: ; Hostname des 5. Nameservers (optional) Hinweis: Wird das Feld holder bei.de-domains mehr als einmal verwendet, so dürfen die einzelnen Handles dort nicht mehrfach auftauchen. task: upd domain: hetzner.de holder: DENIC-168-Martin-Hetzner-1 adminc: DENIC-168-Martin-Hetzner-1 techc: DENIC-168-Martin-Hetzner-1 zonec: DENIC-168-Martin-Hetzner-1 ns1: ns1.first-ns.de ns2: robotns2.second-ns.de ns3: robotns3.second-ns.com

8 Domain Registration Robot Domain kündigen task: del domain: [a-za-z0-9-]{3,60}.(de com net org info biz eu at co.at or.at) ; Domainname Hinweis: Bei.de,.com,.net Domains wird der Löschauftrag sofort an die Vergabestelle weitergeleitet, was zur Folge hat, dass eine.de Domain unverzüglich und eine.com oder.net Domain nach 30 Tagen gelöscht wird. Alle anderen TLDs lassen sich nur mit einer Frist von 30 Tagen zum Monatsende kündigen. Beim Eingang eines Kündigungsauftrags für eine.org,.info,.biz,.eu oder.at Domain ermittelt der Robot automatisch das nächstmögliche Kündigungsdatum, welches auch in der Antwortmail angegeben wird. Beispiel: Ihren Kündigungsauftrag senden Sie am an unseren Robot, somit ermittelt dieser als nächstmöglichen Kündigungszeitpunkt den An diesem Tag senden wir dann einen Löschauftrag an die entsprechende Vergabestelle. Bitte beachten Sie, dass die Domain von der Vergabestelle am Kündigungsdatum nicht sofort gelöscht wird, sondern noch bis zum Ablaufdatum der Domain weiterhin registriert bleibt. task: del domain: hetzner.de

9 Domain Registration Robot Domain Transit (nur bei.de Domains möglich) task: transit domain: [a-za-z0-9-]{3,60}.de ; Domainname disconnect: (no yes) task: transit domain: hetzner.de disconnect: no

10 Domain Registration Robot KK-Aufträge starten (nur bei.de,.com,.net,.at Domains möglich) task: kk domain: [a-za-z0-9-]{3,60}.(de com net at) ; Domainname holder: ; DENIC-Handle des Domaininhabers holder: ; DENIC-Handle des 2. Domaininhabers (optional) holder: ; DENIC-Handle des 3. Domaininhabers (optional) holder: ; DENIC-Handle des 4. Domaininhabers (optional) holder: ; DENIC-Handle des 5. Domaininhabers (optional) adminc: ; DENIC-Handle des Administrators techc: ; DENIC-Handle des technischen Ansprechpartners zonec: ; DENIC-Handle des Zonenverwalters ns1: ; Hostname des primären Nameservers ns2: ; Hostname des sekundären Nameservers ns3: ; Hostname des 3. Nameservers (optional) ns4: ; Hostname des 4. Nameservers (optional) ns5: ; Hostname des 5. Nameservers (optional) authcode: ; Auth-Code der Domain (optional) Hinweise: Die Anzahl der Holder-Handles sowie die Inhabernamen der Handles müssen mit denen der aktuellen Domaindaten übereinstimmen. Liegen die Inhaberdaten noch als Description vor, so darf nur ein Holder-Handle angegeben werden, dessen Inhabername mit dem der Description übereinstimmen muss. Das Feld authcode darf nur angegeben werden, wenn das neue Providerwechselverfahren der DENIC verwendet wird und somit vom alten Provider zuvor ein Auth- Code für die Domain angelegt wurde. user:hetzner task: kk domain: kk-domain.de holder: DENIC-168-Martin-Hetzner-1 adminc: DENIC-168-Martin-Hetzner-1 techc: DENIC-168-Martin-Hetzner-1 zonec: DENIC-168-Martin-Hetzner-1 ns1: ns1.first-ns.de ns2: robotns2.second-ns.de ns3: robotns3.second-ns.com

11 Domain Registration Robot KK-Anfragen beantworten (nur bei.com und.net Domains möglich) Liegt eine Anfrage eines anderen Providers vor, eine von uns verwaltete Domain zu übernehmen, werden Sie vom Robot benachrichtigt. Sie haben nun einige Tage Zeit, die Anfrage zu beantworten. Sie können der Anfrage zustimmen (ack) oder ablehnen (nack). Beachten Sie bitte, wenn Sie innerhalb von drei Werktagen nicht reagieren, wird Ihre Ablehnung unterstellt und die Anfrage automatisch negativ beantwortet. task: kk-(ack nack) domain: [a-za-z0-9-]{3,60}.(com net) ; Domainname task: kk-ack domain: kk-domain.com

12 Domain Registration Robot Auth-Code generieren (nur bei.de Domains möglich) Wenn Sie Ihre.de-Domain nach dem neuen Providerwechselverfahren der DENIC zu einem anderen Provider umziehen möchten, können Sie mit diesem Auftrag einen Auth-Code für Ihre Domain generieren lassen. Sobald der Auth-Code generiert wurde, erhalten Sie eine vom Robot. Dann können Sie den Auth-Code im Robot unter dem Menüpunkt Domains über den Link einsehen abrufen. task: authcode domain: [a-za-z0-9-]{3,60}.de ; Domainname task: authcode domain: kk-domain.de

13 Domain Registration Robot Nameservereintrag anlegen job: ns task: new domain: [a-za-z0-9-]{3,60}.(tld) ; Domainname primary: ; IP-Adresse des primären Nameservers wenn kein primärer von ; uns gewünscht wird, ansonsten yours zonefile: ; Wenn wir beide Nameserver stellen (für.com,.org,.net,.info, ;.biz und.eu Domains erforderlich) der Inhalt des Zonefiles begrenzt ; durch /begin und /end, ansonsten none job: ns task: new domain: hetzner.de primary: yours zonefile: IN SOA ns1.first-ns.de. postmaster.robot.first-ns.de. ( ; Serial ; Refresh 1800 ; Retry ; Expire ) ; IN NS IN NS ns.second-ns.de. localhost IN A IN A www IN A mail IN A loopback IN CNAME localhost pop IN CNAME www smtp IN CNAME www relay IN CNAME www imap IN CNAME www ftp IN CNAME IN MX 10 mail /end

14 Domain Registration Robot Nameservereintrag ändern job: ns task: upd domain: [a-za-z0-9-]{3,60}.(tld) ; Domainname primary: ; IP-Adresse des primären Nameservers wenn kein primärer von ; uns gewünscht wird, ansonsten yours zonefile: ; Wenn wir beide Nameserver stellen (für.com,.org,.net,.info, ;.biz und.eu Domains erforderlich) der Inhalt des Zonefiles begrenzt ; durch /begin und /end, ansonsten none job: ns task: upd domain: hetzner.de primary: zonefile: none

15 Domain Registration Robot Nameservereintrag löschen job: ns task: del domain: [a-za-z0-9-]{3,60}.(tld) ; Domainname primary: ; IP-Adresse des primären Nameservers wenn kein primärer von ; uns gewünscht wird, ansonsten yours zonefile: ; Wenn wir beide Nameserver stellen (für.com,.org,.net,.info, ;.biz und.eu Domains erforderlich) der Inhalt des Zonefiles begrenzt ; durch /begin und /end, ansonsten none job: ns task: del domain: hetzner.de primary: zonefile: none Stand: