Die in diesem Abschnitt erläuterte Syntax für Domainaufträge gilt für Aufträge per E-Mail-Schnittstelle und Online-Schnittstelle gleichermaßen. Varianten, die nur bei der Übermittlung per SRS-Schnittstelle möglich sind, werden im Abschnitt "SRS – Online-Schnittstelle zu EPNIC" erläutert.
Die aktuelle Versionsnummer des Domain-Templates ist 6.4. Der Funktionsumfang des Systems wird nur von der hier dokumentierten Version 6.4 des Templates unterstützt. Eine Abwärtskompatibilität zu älteren Template-Versionen wird nicht garantiert. Aufträge mit E-Mail-Templates der Versionen 1 bis 4 werden von EPNIC abgewiesen.
Tickets
Domainaufträge umfassen sämtliche Transaktionen von der Registrierung oder dem Transfer über die Modifizierung bis hin zur Löschung einer Domain. Mit einem Domainauftrag werden die für die Auftragsausführung erforderlichen Informationen an das System übergeben. Auch die gewünschten Kontakt-Handles und Nameserver sind Bestandteil des Domainauftrags und werden ggf. im Zuge der Auftragsverarbeitung im System angelegt.
Jeder Domainauftrag erhält nach Auftragseingang eine Ticketnummer in folgendem Format:
[2009-06-21-00001] REG example.comNach der Datumsangabe im Format [YYYY-MM-DD] folgt ein 5-stelliger Zähler (jeden Tag neu mit „00000“ beginnend) und eine Kopie der „Subject“-Zeile der Auftrags-E-Mail.
Domainverlängerung
Domains werden in EPNIC grundsätzlich automatisch verlängert, wenn nicht rechtzeitig vor dem Verlängerungsdatum ein Auftrag zum „Expire“ einer Domain eingegangen ist. Die automatische Verlängerung erfolgt jeweils für die Mindestverlängerungsdauer der entsprechenden Top-Level-Domain. EPNIC sendet keine Mitteilungen über bevorstehende oder automatisch ausgeführte Verlängerungen. Eine Liste der anstehenden Verlängerungen ist über die EPNIC Web-Oberfläche verfügbar.
Eine aktive Verlängerung einer Domain vor dem eigentlichen Verlängerungsdatum ist für einige Top-Level-Domains über den Auftragstyp RENEW möglich, Einzelheiten dazu im folgenden Abschnitt.
Folgende Auftragstypen stehen für Domainaufträge zur Verfügung:
REG
Neuregistrierung einer verfügbaren Domain. Die Domain muss frei verfügbar sein, darf also z.B. momentan nicht durch Dritte registriert oder von der Registry für Registrierungen gesperrt sein. Mit diesem Auftragstyp können Domains in allen über EPAG verfügbaren Top-Level-Domain (TLDs) registriert werden.
Bei manchen TLDs ist eine Registrierung nur möglich, wenn der Registrant zusätzliche Voraussetzungen erfüllt, wenn zusätzliche Formulare und Dokumente zur Verfügung gestellt werden, oder wenn die Konfiguration der Nameserver der Domain bestimmten Regeln folgt, die durch die jeweilige Registry festgelegten werden. Informationen über diese Voraussetzungen erhalten Sie in unserer Web-Oberfläche oder auf Nachfrage bei unserem Support-Team.
Bei Nutzung der E-Mail-API können Sie innerhalb des Registrierungs-Auftrags neue Handles anlegen, indem Sie die Kontaktdetails innerhalb des Auftrags angeben (weitere Informationen folgen weiter unten). Diese Funktion steht bei der Nutzung der Online-Schnittstelle nicht zur Verfügung.
TRANSFER
Start von Domaintransfers (Registrarwechsel) von anderen Registraren zu EPNIC. Der Ablauf des Transfers folgt einem Ablauf, der von der zuständigen Registry oder der ICANN festgelegt ist. Die Abläufe unterscheiden sich teils erheblich und sind für einige TLDs in separaten Dokumentationen erläutert.
Abhängig von der jeweiligen TLD findet bei erfolgtem Transfer eine der folgenden Aktionen automatisch statt:
- Verlängerung der Domain um Mindestverlängerungszeitraum
- Zurücksetzen der Laufzeit und Beginn einer neuen Registrierungsperiode zum Zeitpunkt des Transferabschlusses
- Registrierungszeitraum verändert sich nicht, keine Verlängerung findet statt
UPDATE
Änderungen (Updates) von Domains in Ihrem EPNIC-Account. Mit diesem Auftragstyp können die folgenden Daten geändert werden:
- AuthCodes
- Domainstatus
- Renewal-Modus
- E-Mail-Profile
- Nameserver
- Kontakt-Handles
Bei Nutzung der E-Mail-API können Sie innerhalb des Update-Auftrags neue Handles anlegen, indem Sie die Kontaktdetails innerhalb des Auftrags angeben. Updates von Daten innerhalb bereits existierender Handles (z.B. der E-Mail-Adresse oder der Telefonnummer) sind innerhalb von Domainaufträgen nicht möglich. Diese Änderungen können nur mit Kontaktaufträgen vorgenommen werden. Diese Funktion steht bei der Nutzung der Online-Schnittstelle nicht zur Verfügung.
CHANGEOWNER
Änderungen des Domaininhabers sind für einige TLDs durch die jeweilige Registry reglementiert und/oder kostenpflichtig. In diesen Fällen muss eine Änderung des Domaininhabers explizit mit CHANGEOWNER beauftragt werden, eine Inhaberänderung per UPDATE ist dann nicht möglich.
Abhängig von der TLD kann die Änderung des Domaininhabers eine Änderung der Registrierungsperiode und/oder Kosten verursachen. Je nach Registrierungsbestimmungen der Registry ist EPAG vor der Ausführung eines Inhaberwechsels eine schriftliche Bestätigung des alten und neuen Domaininhabers vorzulegen.
RENEW
Aktive Verlängerung einer Domain um die im Auftrag angegebene zusätzliche Registrierungsperiode. Die Durchführung dieses Auftrags ist nur vor dem Ablaufdatum der Domain möglich. Sollte eine Domain ausgelaufen sein, kann sie nicht länger durch diesen Auftragstyp verlängert werden. Stattdessen steht möglicherweise ein Restore durch unsen Kundensupport zur Verfügung.
Dieser Auftragstyp ist nicht für alle Top-Level-Domains verfügbar. Die Gesamtregistrierungsdauer einer Domain ab dem aktuellen Datum darf einen bestimmten Zeitraum nicht überschreiten (in der Regel 10 Jahre), eine Verlängerung per RENEW ist jeweils nur innerhalb dieses Zeitraums möglich. Die Entgelte für die zusätzlichen Registrierungsperioden werden mit der nächsten Abrechnung im Voraus in Rechnung gestellt.
In Ihrem Kundenaccount unter Support -> Übersicht Top-Level-Domains finden Sie eine Übersicht der Einstellungen jeder TLD mit dem Hinweis, ob einen Renew-Auftrag möglich ist. Ein Renew-Auftrag ist möglich, wenn " Verlängerung" unter den Möglichen Auftragsarten aufgelistet ist.
BACKORDER
Der Backorder-Befehl reicht einen Antrag ein, eine Domain erneut zu registrieren, sobald sie bei der Registry gelöscht und wieder registrierbar ist. Backorder-Anträge sind nur für eine begrenzte Auswahl von Endungen verfügbar. Im Kundenportal finden Sie eine stets aktualisierte Liste der Endungen, für die Backorder verfügbar ist.
Ein Backorder kann jederzeit in Auftrag gegeben werden, auch wenn die Domain noch registriert ist. Der Auftrag wird erst aktiv, sobald die Domain zur Löschung ansteht. Es gibt keine Garantie, dass einen Auftrag erfolgreich sein wird, da für die selbe Domain Backorder-Aufträge auch bei anderen Anbietern vorliegen können.
Falls mehrere Kunden Backorder-Aufträge für dieselbe Domain abgeben, wird die Domain durch eine Auktion zugeteilt.
Bitte beachten Sie, dass Backorder-Aufträge einen anderen Preis als Registrierungs-Aufträge haben. In Ihrem Kundenportal unter Domainaufträge -> Domain-Backorder finden Sie eine Liste der Domains, die bald zur Löschung stehen und für Backorder-Aufträge freigeschaltet sind.
SUNRISE
Dieser Befehl erlaubt das Einreichen eines Sunrise-Auftrags für eine Domain. Sunrise-Anträge können nur während der Sunrise-Phase genannten Einführungsphase einer Top-Level-Domain abgegeben werden. Üblicherweise muss der Dmaininhaber hier ein besonderes Recht an der Domain nachweisen, je nach Bestimmungen der jeweiligen Registry. Die Basis dafür könnten z.B. Marken oder Firmennamen sein.
Wichtiger Hinweis: Für diese Aufträge gilt eine spezielle Sunrise-Gebühr, die auch bei nicht erfolgreichem Auftrag nicht zurückerstattet werden kann. Oft werden für Sunrise-Aufträge zusätzliche Informationen, wie z.B. die Nummer einer Marke, verlangt.
LANDRUSH
Dieser Befehl erlaubt das Einreichen eines Landrush-Auftrags für eine Domain. Landrush-Anträge können nur während der Landrush-Phase der Einführung einer Top-Level-Domain abgegeben werden, oft zu Premium-Preisen.
DEL
Sofortige Löschung einer Domain.
Für einige TLDs ist die Übermittlung des Löschauftrags der erste Schritt zur Löschung, aber alleine nicht ausreichend. Oft ist für die Ausführung des Auftrags entsprechend der Registrierungsbedingungen der Registrys eine schriftliche Bestätigung des Domaininhabers erforderlich. Die Ausführung der Löschung erfolgt, sobald diese Bestätigung EPAG vorliegt oder der EPAG-Kunde ausdrücklich zusichert, dass ihm diese Bestätigung vorliegt. Diese Verfahrensweise kann bei Bedarf per ausdrücklicher Vereinbarung zwischen EPAG und dem Kunden angepasst werden.
Wenn ein DEL-Auftrag nach Ablauf der Kündigungsfrist, aber vor dem Expire-Datum der jeweiligen Domain eingeht, wird eine weitere Verlängerung für die Domain berechnet.
EXPIRE
Das EXPIRE-Kommando ist ein Weg, die automatische Verlängerung einer Domain auszuschalten. Durch die Einführung des Renewal-Modus wurde dieses Kommando obsolet. Wir empfehlen die Nutzung des Renewal-Modus statt des EXPIRE-Kommandos.
Ein EXPIRE-Auftrag bewirkt die Löschung einer Domain zum nächsten Verlängerungszeitpunkt (Expire-Datum). Der EXPIRE-Auftrag muss vor Ablauf der Kündigungsfrist eingehen. Diese beträgt üblicherweise eine oder mehrere Tage, abhängig von der TLD. Wenn ein EXPIRE-Auftrag nach Ablauf der Kündigungsfrist eingeht, wird die Domain um den Mindestverlängerungszeitraum verlängert und berechnet. Sie wird dann nach Ablauf dieses weiteren Zeitraums gelöscht.
Die Nutzung des EXPIRE-Kommandos generiert einen Auftrag im System, der bis zum Abschluß aktiv bleibt. Da für eine Domain immer nur ein Auftrag aktiv sein kann, bedeutet das, dass keine anderen Kommandos (wie z.B. ein Update) durchgeführt werden können. Um dennoch ein Update für die Domain durchzuführen, senden Sie bitte ein UNEXPIRE (siehe unten), führen dann das Update durch, und senden dann ein erneutes EXPIRE.
UNEXPIRE
Reaktivierung der automatischen Verlängerung einer Domain, für die ein EXPIRE gesendet wurde. Das Kommando UNEXPIRE bricht den durch das Kommando EXPIRE generierten Auftrag ab.
TRANSIT
Nutzbar nur für .de und .at im Rahmen der Bedingungen der jeweiligen Registry. Ein Transit-Auftrag bewirkt die Rückgabe einer Domain an die Vergabestelle, ohne dass diese gelöscht wird. Der eingetragene Domaininhaber verliert damit nicht das Recht an seiner Domain. Die Zahlungsverpflichtung gegenüber EPAG endet, an deren Stelle tritt eine Zahlungsverpflichtung gegenüber der Vergabestelle. EPAG behält sich die Prüfung und Ablehnung der Ausführung eines TRANSIT-Auftrags vor, sofern Zweifel an der Einhaltung der entsprechenden Bedingungen der Registry bestehen.
QUERY
Abfrage des aktuellen Status und der Registrierungsdaten einer Domain. Liefert ein mit den aktuellen Domaindaten vorausgefülltes Auftrags-Template zurück, welches wiederum für einen Domainauftrag zu dieser Domain genutzt werden kann.
QUEUE
Vorregistrierung von Domains für TLDs, in denen eine Registrierung erst zu einem späteren Zeitpunkt möglich wird (nutzbar insbesondere bei der Einführung neuer TLDs). Vorregistrierungsaufträge werden mit Zeitstempel in eine Warteschlange geschrieben und zum Startzeitpunkt der entsprechenden TLD als Registrierungsauftrag an die Registry übermittelt.
DOMAINCHECK
Ermittelt, ob eine Domain zur Registrierung frei ist. Dieser Befehl kann nur in Zusammenhang mit der SRS-API verwendet werden (siehe "SRS – Online-Schnittstelle zu EPNIC").
Durch die digitale Signierung von DNS-Daten ermöglicht DNSSEC die Verifizierung der Herkunft von DNS-Antworten. Bitte beachten Sie, dass eine falsche Konfiguration von DNSSEC unweigerlich dazu führt, das die betroffene Domain nicht mehr im DNS aufgelöst werden kann. Daher ist es unerlässlich, sich ein umfangreiches Wissen über die Konfiguration von DNSSEC und DNS anzueignen, bevor Sie DNSSEC implementieren. EPAG übermittelt lediglich DNSSEC-Daten an die Registry und kann keine Validierung der Daten und keinen technischen Support leisten.
Template-Erweiterung
Das Template wird um 10x4 Daten-Felder erweitert. Dadurch können bis zu zehn DNSSEC-Records über die EPNIC API übergeben werden. Bitte beachten Sie, dass im Kunden-Portal, im Vergleich zur API, nur bis zu vier DNSSEC-Records übergeben werden können. Im Kundenportal unter Support => Übersicht Top-Level-Domains, Spalte „DNSSEC-Unterstützung“ finden Sie Informationen zu den TLDs, die DNSSEC unterstützen. Hier wird angezeigt, wie viele Records erlaubt sind und welches Format gegebenenfalls unterstützt wird.
1dsX1. DNSSec KeyTag ........... :
1dsX2. DNSSec Algorithm ........ :
1dsX3. DNSSec DigestType ....... :
1dsX4. DNSSec Digest ........... :1dsX1. DNSSec Flags ............ :
1dsX2. DNSSec Protocol ......... :
1dsX3. DNSSec Algorithm ........ :
1dsX4. DNSSec Public Key ....... :Im Template werden für dsData und keyData jeweils die gleichen Felder benutzt, da Registries entweder das eine oder das andere Protokoll unterstützen, jedoch nicht beide gleichzeitig.
1ds01, 1ds02, 1ds03, 1ds04
1ds11, 1ds12, 1ds13, 1ds14
...Das Feld „1dsX4“ kann gegebenenfalls sehr lange Zeichenketten enthalten, die sich mit einem Standard-Mailprogramm nicht verarbeiten lassen. Daher ist die Angabe dieses Feldes auch folgendermaßen möglich:
...
1ds04. DNSSec Public Key ........ : \
BQEAAAABn627F2YqtVu5WftsJuMJ/lU7f0KWBkA94pbG+ioLvoRP9Emn
wbz0fTPysdeZLgistOk8BN3BjpdXXrUze65kcaAzoKO8LMz1tOq6WDvs
0GQlk1tdqzLOKjseXw2deyKsDNarxiecDda86jOpJHcdzX0Fy9wZ70A1
0R1DHmJfE8c=
\
...Hinter der Feldbezeichnung „1ds04. DNSSec Digest ........... :“ wird als einziges Zeichen ein Backslash „\“ angegeben. Dadurch werden alle folgenden Zeilen bis zum abschließenden Backslash „\“ aneinandergehängt. Der abschließende Backslash kann entweder in einer eigenen Zeile angegeben werden, oder aber auch als letztes Zeichen in der letzten Datenzeile „0R1DHmJfE8c= \“.
Bei Rückmeldungen vom System, wird der Key immer komplett hinter der Feldbezeichnung „1dsX4“ übergeben.
Im DNSSEC-Kontext wurde das Feld „1dsop“ ergänzt, über das gesteuert werden kann, wie mit bereits bei der Registry hinterlegten Einträgen zu verfahren ist:
1dsop. old DNSSec Records ...... : Parameter und Funktion von "1dsop"
Für das Feld „1dsop“ sind folgende Angaben möglich: „keep“ oder „remove“. Abhängig vom Auftragstyp ist die Funktion dabei unterschiedlich.
Update-Auftrag:
nicht angegeben
Die DNSSEC-Information wird bei der Registry nicht verändert.
Vorhandene DNSSEC-Records werden bei der Registry gelöscht.
Die DNSSEC-Information wird bei der Registry nicht verändert.
angegeben
Die DNSSEC-Information wird bei der Registry durch die im Template angegebenen DNSSEC-Records ersetzt.
Die DNSSEC-Information wird bei der Registry durch die im Template angegebenen DNSSEC-Records ersetzt.
Die DNSSEC-Information wird nicht bei der Registry gelöscht, sondern durch die angegebenen DNSSEC-Records ergänzt.
Transfer-Auftrag:
nicht angegeben
Vorhandene DNSSEC-Records werden bei der Registry gelöscht.
Vorhandene DNSSEC-Records werden bei der Registry gelöscht.
Die DNSSEC-Information wird nicht bei der Registry verändert.
angegeben
Die DNSSEC-Information wird bei der Registry durch die im Template angegebenen DNSSEC-Records ersetzt.
Die DNSSEC-Information wird bei der Registry durch die im Template angegebenen DNSSEC-Records ersetzt.
Die DNSSEC-Information wird nicht bei der Registry gelöscht, sondern durch die angegebenen DNSSEC-Records ergänzt.
Fehlermeldungen
Im Zusammenhang mit DNSSEC wurden folgende Fehlermeldungen neu definiert.
Fehler: Falsche Angaben im Feld „1dsop“
In diesem Feld ist nur die Angabe von „keep“ (alternativ: „behalten“) oder „remove“ (alternativ „entfernen“) erlaubt. Andere Einträge führen zu einer Fehlermeldung:
---------------------------------------------------------------
Sender : ab@sender
Subject : MOD DOMAIN dnssec.test
Date : Mon, 30 Feb 2016 08:14:05 UTC
Ticket : 2016-02-30-03212
Action : MOD
Domain : dnssec.test
Result : ERROR
Reason : invalid template
NRC : 500010
---------------------------------------------------------------
Your order cannot be processed due to errors. Please resolve
those errors and resend the order.
---------------------------------------------------------------
Errors in section '1' ():
invalid data in field '1dsop'
possible values are: 'remove' or 'keep'ungueltige Angabe in Feld '1dsop'
moegliche Werte sind 'entfernen' oder 'behalten'Fehler: Zu viele DNSSEC-Records
Die maximale Anzahl von DNSSEC-Records ist für jede TLD unterschiedlich festgelegt. Wenn bei der formalen Überprüfung des Templates festgestellt wird, dass diese Anzahl überschritten würde, gibt das System folgende Fehlermeldung zurück:
---------------------------------------------------------------
Sender : ab@sender
Subject : MOD DOMAIN dnssec.test
Date : Mon, 30 Feb 2016 08:14:05 UTC
Ticket : 2016-02-30-03212
Action : MOD
Domain : dnssec.test
Result : ERROR
Reason : invalid template
NRC : 500010
---------------------------------------------------------------
Your order cannot be processed due to errors. Please resolve
those errors and resend the order.
---------------------------------------------------------------
Errors in section '1' ():
574 too many dnssec records; max supported 4574 zu viele DNSSEC-Records, maximal werden 4 Records unterstuetztWenn erst bei der Durchführung des Auftrages festgestellt werden kann, dass die maximale Anzahl von Einträgen überschritten wird, sieht die Fehlermeldung wie folgt aus:
---------------------------------------------------------------
Sender : ab@sender
Subject : MOD DOMAIN dnssec.test
Date : Mon, 30 Feb 2016 08:64:05 UTC
Ticket : 2016-02-30-04711
Action : MOD
Domain : dnssec.test
Result : ERROR
Reason : too many dnssec records
NRC : 502089
The maximum number of possible DNSSEC-records would be
exceeded after the update. Thus, the order could not be
processed.Nach dem Update wuerde die maximal erlaubte Anzahl von
DNSSEC-Records ueberschritten. Daher kann der Auftrag
nicht ausgefuehrt werden.Wichtig:
Es können auch bereits bekannte Fehlermeldungen (nicht in diesem Kapitel beschrieben) im Zusammenhang mit DNSSEC auftauchen. Dies ist meist davon abhängig, inwiefern Fehlermeldungen von den jeweiligen Registries korrekt erkannt und zugeordnet werden können.
Sobald eine präzisere Zuordnung von Rückmeldungen der Registries möglich ist, werden an dieser Stelle weitere Fehlermeldungen definiert.
Anwendungsbeispiel
Um den Schlüsselwechsel („key rollover“) für eine Zone durchzuführen, muss zunächst der neue Schlüssel zusätzlich zum bisher gültigen, alten Schlüssen hinterlegt werden. Nach Ablauf einer angemessenen Wartezeit, kann der alte Schlüssel dann von der Zone gelöscht werden. Dieser Schlüsselwechsel kann auf zwei Arten erfolgen:
1.a) Neuen Schlüssel hinzufügen
Im Template werden sowohl der alte, als auch der neue Schlüssel in zwei Datenblöcken in einem Updateauftrag übergeben.
1ds01. DNSSec KeyTag ........... : alter Wert
1ds02. DNSSec Algorithm ........ : alter Wert
1ds03. DNSSec DigestType ....... : alter Wert
1ds04. DNSSec Digest ........... : alter Wert
1ds11. DNSSec KeyTag ........... : neuer Wert
1ds12. DNSSec Algorithm ........ : neuer Wert
1ds13. DNSSec DigestType ....... : neuer Wert
1ds14. DNSSec Digest ........... : neuer Wert1.b) Alten Schlüssel entfernen
Im nachfolgenden Updateauftrag wird nur noch der neue Schlüssel angegeben:
1ds11. DNSSec KeyTag ........... : neuer Wert
1ds12. DNSSec Algorithm ........ : neuer Wert
1ds13. DNSSec DigestType ....... : neuer Wert
1ds14. DNSSec Digest ........... : neuer WertDie alternative Vorgehensweise bedient sich des Flags „1dsop“
2.a) Neuen Schlüssel hinzufügen
1ds11. DNSSec KeyTag ........... : neuer Wert
1ds12. DNSSec Algorithm ........ : neuer Wert
1ds13. DNSSec DigestType ....... : neuer Wert
1ds14. DNSSec Digest ........... : neuer Wert
1dsop. Old DNSSec Records ...... : keep2.b) Alten Schlüssel entfernen
1ds11. DNSSec KeyTag ........... : alter Wert
1ds12. DNSSec Algorithm ........ : alter Wert
1ds13. DNSSec DigestType ....... : alter Wert
1ds14. DNSSec Digest ........... : alter Wert
1dsop. Old DNSSec Records ...... : removeDas folgende Beispiel stellt die aktuelle Vorlage (Template) in der Version 6.4 für Domainaufträge mit den wichtigsten Keys dar:
## VERSION 6.4 DOMAIN (2008-04-18) DO NOT REMOVE OR CHANGE!
0 . EPNIC-Customer-ID ......... :
0a . Requested Action .......... :
0b . Language .................. :
0c . CustomerRemarks............ :
1a . Domainname ................ :
1c . Auth-Code ................. :
1d . Registration Period (Years) :
1e . Domain-Status ............. :
1f . E-Mail Template ........... :
1g . Renewal Mode .............. :
1h . Use standard IRTP-procedure :
1ds01. DNSSec KeyTag ........... :
1ds02. DNSSec Algorithm ........ :
1ds03. DNSSec DigestType ....... :
1ds04. DNSSec Digest ........... :
1ds11. DNSSec KeyTag ........... :
1ds12. DNSSec Algorithm ........ :
1ds13. DNSSec DigestType ....... :
1ds14. DNSSec Digest ........... :
1ds21. DNSSec KeyTag ........... :
1ds22. DNSSec Algorithm ........ :
1ds23. DNSSec DigestType ....... :
1ds24. DNSSec Digest ........... :
1ds31. DNSSec KeyTag ........... :
1ds32. DNSSec Algorithm ........ :
1ds33. DNSSec DigestType ....... :
1ds34. DNSSec Digest ........... :
1dsop. old DNSSec Records ...... :
2a . Owner EPNIC-Handle ........ :
2b . Name (last, first) ........ :
2c . Organization .............. :
2e . Street .................... :
2f . Postal Code ............... :
2g . City ...................... :
2h . State/Province ............ :
2i . Country Code .............. :
2j . Phone No. ................. :
2k . Fax No. ................... :
2l . E-Mail Address ............ :
2tp. Contact Type (Org|Person) . :
3a . Admin-C EPNIC-Handle ...... :
3b . Name (last, first) ........ :
3c . Organization .............. :
3e . Street .................... :
3f . Postal Code ............... :
3g . City ...................... :
3h . State/Province ............ :
3i . Country Code .............. :
3j . Phone No. ................. :
3k . Fax No. ................... :
3l . E-Mail Address ............ :
3tp. Contact Type (Org|Person) . :
4a . Tech-C EPNIC-Handle ....... :
4b . Name (last, first) ........ :
4c . Organization .............. :
4e . Street .................... :
4f . Postal Code ............... :
4g . City ...................... :
4h . State/Province ............ :
4i . Country Code .............. :
4j . Phone No. ................. :
4k . Fax No. ................... :
4l . E-Mail Address ............ :
4tp. Contact Type (Org|Person) . :
5a . Zone-C EPNIC-Handle ....... :
5b . Name (last, first) ........ :
5c . Organization .............. :
5e . Street .................... :
5f . Postal Code ............... :
5g . City ...................... :
5h . State/Province ............ :
5i . Country Code .............. :
5j . Phone No. ................. :
5k . Fax No. ................... :
5l . E-Mail Address ............ :
5tp. Contact Type (Org|Person) . :
6a . Billing-C EPNIC-Handle .... :
6b . Name (last, first) ........ :
6c . Organization .............. :
6e . Street .................... :
6f . Postal Code ............... :
6g . City ...................... :
6h . State/Province ............ :
6i . Country Code .............. :
6j . Phone No. ................. :
6k . Fax No. ................... :
6l . E-Mail Address ............ :
6tp. Contact Type (Org|Person) . :
7a . Hidden-Primary DNS ........ :
7a0. 1. Domainnameserver ....... :
7a1. 1. DNS IP ................. :
7a2. 2. DNS IP ................. :
7a3. 3. DNS IP ................. :
7a4. 4. DNS IP ................. :
7b0. 2. Domainnameserver ....... :
7b1. 1. DNS IP ................. :
7b2. 2. DNS IP ................. :
7b3. 3. DNS IP ................. :
7b4. 4. DNS IP ................. :
7c0. 3. Domainnameserver ....... :
7c1. 1. DNS IP ................. :
7c2. 2. DNS IP ................. :
7c3. 3. DNS IP ................. :
7c4. 4. DNS IP ................. :
7d0. 4. Domainnameserver ....... :
7d1. 1. DNS IP ................. :
7d2. 2. DNS IP ................. :
7d3. 3. DNS IP ................. :
7d4. 4. DNS IP ................. :
7e0. 5. Domainnameserver ....... :
7e1. 1. DNS IP ................. :
7e2. 2. DNS IP ................. :
7e3. 3. DNS IP ................. :
7e4. 4. DNS IP ................. :
7f0. 6. Domainnameserver ....... :
7f1. 1. DNS IP ................. :
7f2. 2. DNS IP ................. :
7f3. 3. DNS IP ................. :
7f4. 4. DNS IP ................. :
7g0. 7. Domainnameserver ....... :
7g1. 1. DNS IP ................. :
7g2. 2. DNS IP ................. :
7g3. 3. DNS IP ................. :
7g4. 4. DNS IP ................. :
7h0. 8. Domainnameserver ....... :
7h1. 1. DNS IP ................. :
7h2. 2. DNS IP ................. :
7h3. 3. DNS IP ................. :
7h4. 4. DNS IP ................. :
// Additional Domain Data (refer to manual)
8i . Use Trustee Service........ :
// ---> For .asia-registrations only
// ---> nur fuer .asia-Registrierungen
9a . CED-C EPNIC-Handle ........ :
9b . Name (last, first) ........ :
9c . Organization .............. :
9e . Street .................... :
9f . Postal Code ............... :
9g . City ...................... :
9h . State/Province ............ :
9i . Country Code .............. :
9j . Phone No. ................. :
9k . Fax No. ................... :
9l . E-Mail Address ............ :
9tp. Contact Type (Org|Person) . :
9m0. .asia Identification Number :
9m1. .asia Form of Identity .... :
9m2. .asia Type of Entity ...... :Die Informationen in Block 9m0 - 9m2 sind nur für die Registrierung von .asia-Domains erforderlich.
Zu beachten ist, dass die Handle-Abschnitte (Owner, Admin-c, usw...) mit zusätzlichen Keys erweitert werden (siehe Kapitel „Kontaktaufträge") können. Um eine USt-IdNr. und Handelsregisternummer zum Owner-Handle hunzufügen, müsste Abschnitt 2 der Vorlage wie folgt aussehen (zugefügte Keys: 2s und 2y).
2a . Owner EPNIC-Handle ........ :
2b . Person Name ............... :
2c . Organisation .............. :
2e . Street .................... :
2f . Postal Code ............... :
2g . City ...................... :
2h . State/Province ............ :
2i . Country Code .............. :
2j . Phone No. ................. :
2k . Fax No. ................... :
2l . E-mail Address ............ :
2tp. Contact Type (Org|Person) . :
2s . VAT ID Number ............. :
2y . Registration Number ....... :Bei der Verwendung der SRS-API sind die Keys zum Absenden der Kontakt-Details nicht verfügbar. Deshalb sollte die Vorlage wie folgend aussehen:
## VERSION 6.4 DOMAIN (2008-04-18) DO NOT REMOVE OR CHANGE!
0 . EPNIC-Customer-ID ......... :
0a . Requested Action .......... :
0b . Language .................. :
0c . CustomerRemarks............ :
1a . Domainname ................ :
1c . AuthCode .................. :
1d . Registration Period (Years) :Die folgende Übersicht enthält die wichtigsten im Domain-Template verfügbaren Key-Value-Paare. Sofern für die Beauftragung einer Domain zusätzliche Angaben erforderlich sind (z. B. Umsatzsteuer-ID des Domaininhabers), können diese im Domainauftrag über die Keys 2, 3, 4, 5 und 6 übergeben werden – allerdings nur, wenn das entsprechende Handle im Domainauftrag neu angelegt wird. Nutzen Sie hierfür die in Kapitel „Kontaktaufträge“ definierten weiteren Keys (für die Umsatzsteuer-ID des Domaininhabers wäre das z. B. Key „2s“).
Bei Nutzung der Online-Schnittstelle können die Key-Value-Paare zum Anlegen neuer Handles innerhalb von Domainaufträgen (2-6b bis 2-6l) nicht genutzt werden. Handles müssen in diesem Fall zwingend separat per Kontaktauftrag angelegt werden.
Eine detaillierte Erläuterung der Keys erfolgt im Abschnitt „Erläuterung der Keys".
0
EPNIC-Customer-ID
--
Ja
[1-8][0-9][0-9][0-9][0-9]
EPAG-Kundennummer (5-stellig, z. B. 40002).
0a
Requested Action
--
Ja
Valid command (see section "Commands").
Auftragstyp.
0b
Language
EN
Nein
DE
EN
Sprache für Systemrückmeldungen.
0c
CustomerRemarks
--
Nein
[A-Za-z0-9]
max. 64 chars
Übergabe kundeneigener Werte (z. B. Jobnummer).
1a
Domainname
--
Ja
valid domain
Domain.
1c
AuthCode
Unique code is created if left empty
optional bei REG und UPDATE; erforderlich bei TRANSFER für einige TLDs
[A-Za-z0-9]
min 6 char
max 16 char
AuthCode (Domainpasswort), nur für Transfers bei bestimmten TLDs benötigt.
1d
Registration Period (Years)
1
Ja
1-10
Initiale Registrierungsperiode.
1e
Domainstatus
ACTIVE
Nein
OK
ACTIVE
clientTransferProhibited
clientUpdateProhibited
clientDeleteProhibited
ClientLock
ClientHold
Einstellen des Status einer Domain im EPNIC-System bzw. bei der Registry; bestimmte Einträge können mit , (Komma) kombiniert werden; nur für REG- und UPDATE-Aufträge und nur für bestimmte TLDs verfügbar.
1f
E-Mail-Profile
--
Nein
Gültiger, selbsterstellter Profil-Name, wie im Kundenportal erstellt.
max 20 char
Bezeichner der selbsterstellten Textvorlage, die zur Sendung der E-Mails verwendet werden soll.
1g
Renewal Mode
auto-renew
Nein
auto-renew
expire
once
Legt die Renewal-mode der Domain fest. Kann mit REG-, TRANSFER-, UPDATE-, CHANGEOWNER- und BACKORDER-Befehle verwendet werden.
1h
Use standard IRTP-procedure
INACTIVE
Nein
Gültige Angaben sind:
positiv: 1, Ja, True
negativ: 0, Nein, False
Keine Angabe in dem Feld wird als 'negativ' gewertet.
Dieses Feld signalisiert, ob ein gTLD-Inhaberwechsel die Bestätigung des "Designated Agent" (DA) übergehen soll. Wenn eine positive Angabe bei einem Update oder Transfer vorhanden ist, muss der Inhaber den Inhaberwechsel durch die E-Mail bestätigen und EPAG bestätigt nicht den Inhaberwechsel als DA. Dadurch hat der alte Inhaber die Möglichkeit, die 60-tägige Transfer-Sperre der Domain zu entfernen.
2/3/4/5/6/9a
Owner / Admin-C / Tech-C / Zone-C / Billing-C /
CED EPNIC-Handle
--
Bei REG-, UPDATE-, TRANSFER- und QUEUE-Aufträgen, falls 2/3/4/5/6/9b bis 2/3/4/5/6/9tp keine Kontakt-informationen enthalten
EPNIC handle code (XXX999-EPNIC)
Kontakt-Handle; kann anstelle der Angabe von Detailinformationen in den Keys b bis tp verwendet werden.
2/3/4/5/6/9b
Person Name
--
Ja, wenn 2/3/4/5/6/9a NULL ist
und Kontakttyp “Person”
max 80 char
Der Name sollte in der Form: Vorname Nachname (ohne Komma) eingetragen werden. Bitte hier keine Unternehmensbezeichnungen eintragen.
2/3/4/5/6/9c
Organisation
--
Ja, wenn 2/3/4/5/6/9a NULL ist
und Kontakttyp “ORG”
max 128 char
Unternehmensname.
2/3/4/5/6/9e
Street
--
Ja, wenn 2/3/4/5/6/9a NULL ist
max 80 char
Straße und Hausnummer.
2/3/4/5/6/9f
Postal Code
--
Ja, wenn 2/3/4/5/6/9a NULL ist
max 20 char
Postleitzahl.
2/3/4/5/6/9g
City
--
Ja, wenn 2/3/4/5/6/9a NULL ist
max 64 char
Ortsname.
2/3/4/5/6/9h
State/Province
--
Nein
max 40 char
Bundesland, Kanton, Provinz.
2/3/4/5/6/9i
Country code
--
Ja, wenn 2/3/4/5/6/9a NULL ist
ISO 3166 code
[A-Za-z]{2}
Länderkürzel nach ISO-Code 3166.
2/3/4/5/6/9j
Phone No.
--
Ja, wenn 2/3/4/5/6/9a NULL ist
international or ISO notation
Telefonnummer in internationaler oder ISO-Schreibweise mit Landesvorwahl, ohne sonstige Zeichen außer Punkt (.).
2/3/4/5/6/9k
Fax No.
--
Ja für Tech-C / Zone-C falls 2/3/4/5/6/9a NULL ist
international or ISO notation
Faxnummer in internationaler oder ISO-Schreibweise mit Landesvorwahl, ohne sonstige Zeichen außer Punkt (.).
2/3/4/5/6/9l
E-mail Address
--
Ja, wenn 2/3/4/5/6/9a NULL ist
<valid E-mail address>, max. 80 char
E-Mail-Adresse im gültigen Format.
2/3/4/5/6/9tp
Contact Type
--
Ja, wenn 2/3/4/5/6/9a NULL ist
Person: PERS Organisation: ORG
Bestimmt den Typ des Kontakts.
7a
Hidden-Primary DNS
--
Nein
<valid IP address>
IP-Adresse eines kundenseitigen Hidden-Primary-DNS, wenn EPAG-Nameserver als Primary und Secondary verwendet werden.
7a0
- Domainnameserver
--
REG, UPDATE, TRANSFER, CHANGEOWNER, QUEUE
<valid hostname>
Hostname des Primary Nameservers.
7a1 – 7a4
- DNS IP
--
Falls NS noch nicht bei der Registry registriert ist
<valid IP address>
0 - 4 IP-Adressen des Primary Nameservers.
7b0
- Domainnameserver
--
REG, UPDATE, TRANSFER, QUEUE
<valid hostname>
Hostname des Secondary Nameservers.
7b1 – 7b4
- DNS IP
--
Falls NS noch nicht bei der Registry registriert ist
<valid IP address>
0 - 4 IP-Adressen des Secondary Nameservers.
7c0 – 7h0
- – 8. Domainnameserver
--
Nein
<valid hostname>
Hostname weiterer Nameserver.
7c1 – 7h4
- – 8. DNS IP
--
Nein
<valid IP address>
0 - 4 IP-Adressen weiterer Nameserver.
8i
Use Trustee Service
--
Nein
Yes
Beauftragung des Trustee-Service und Akzeptanz der Trustee-Vertragsbedingungen.
9m0
Identification Number
--
Ja für .asia
max 255 char
Identifizierungsnummer:
- bei Personen z. B. Personalausweisnummer,
- bei Unternehmen Handelsregisternummer.
9m1
Form of Identity
--
Ja für .asia
passport
certificate
legislation
societiesRegistry
politicalPartyRegistry
other
gibt an, auf welches Dokument sich die Identifikationsnummer in Feld 9m0 bezieht
9m2
Type of Entity
--
Ja für .asia
naturalPerson
corporation
cooperative
partnership
government
politicalParty
society
institution
other
Typ der Rechtspersönlichkeit der Person oder Organisation, die sich mit der Identifikationsnummer in Feld 9m0 ausweist.
Allgemeine Felder:
## VERSION 6.4 DOMAIN (2008-04-18) DO NOT REMOVE OR CHANGE!Diese Zeile markiert den Anfang des Templates. Falls diese Zeile fehlt oder dessen Inhalt verändert wurde, kann das Template nicht identifiziert und Ihr Auftrag somit nicht bearbeitet werden.
0 . EPNIC-Customer-ID ......... :Die EPNIC-Customer-ID ist die Kundennummer des EPAG-Accounts, über den der Auftrag abgewickelt werden soll. Die Kundennummer teilt EPAG bei Anlage des Kundenaccounts nach Vertragseingang mit.
0a . Requested Action .......... : Hier geben Sie an, welcher Auftragstyp ausgeführt werden soll (Details zu Auftragstypen siehe „Auftragstypen"). Mögliche Werte sind:
REG
Für Neuregistrierungen.
TRANSFER
Für den Start von Domaintransfers.
UPDATE
Für Änderungen bestehender Domains.
CHANGEOWNER
Für Inhaber-Änderungen bestehender Domains.
RENEW
Für die aktive Verlängerung einer Domain um zusätzliche Registrierungsperioden.
BACKORDER
Für die erneute Registrierung einer Domain nach der Löschung.
SUNRISE
Für Domain-Anträge während der Sunrise-Periode.
LANDRUSH
Für Domain-Anträge während der Landrush-Periode.
DEL
Für die Löschung von Domains.
EXPIRE
Für die Löschung einer Domain zu ihrem Expire-Datum.
UNEXPIRE
Um einen EXPIRE-Auftrag aufzuheben.
TRANSIT
Für die Rückgabe einer .de- oder .at-Domain an die Vergabestelle.
QUERY
Um die aktuellen Registrierungsdaten der Domain abzufragen.
QUEUE
Für Vorregistrierungen.
DOMAINCHECK
Prüft die Verfügbarkeit einer Domain (kann nur in die SRS-API verwendet werden).
Die Auftragstypen können sowohl in Groß- als auch in Kleinbuchstaben angegeben werden.
0b . Language .................. : Durch diesen Parameter wird die Sprache der EPNIC-Systemrückmeldungen für diesen Auftrag festgelegt. Die Sprachausgabe kann in Deutsch oder in Englisch erfolgen. Als Parameter stehen „DE“ für Deutsch und „EN“ für Englisch zur Wahl. Falls das Feld leer bleibt, erfolgen die Rückmeldungen in englischer Sprache.
0c . CustomerRemarks........... : In diesem Feld kann ein kundenseitiger Parameter (z. B. Auftragsnummer, Referenznummer) an EPNIC übergeben werden. EPNIC liefert den hier angegebenen Parameter bei Statusmeldungen zurück und erlaubt so die leichtere Zuordnung der Rückmeldung zum ursprünglichen Auftrag.
1a . Domainname ................ :Hier ist ein gültiger Domainname zum Auftrag in der Form „example.com“ einzutragen. Präfixe wie „www.“ sind nicht zu verwenden.
Die Angabe von Internationalized Domain Names (IDN-Domains oder „Umlaut“-Domains) kann entweder in „Klartext“ oder PUNY-Code erfolgen (bitte beachten Sie, dass IDN-Domains nur für bestimmte TLDs verfügbar sind):
bäcker-brötchen.de
xn--bcker-brtchen-bfb1z.de
Insbesondere bei IDN-Domains in einem anderen Zeichensatz als dem deutschen empfehlen wir die Angabe der Domain im PUNY-Code, um die Registrierung der gewünschten Zeichenkette zu gewährleisten.
1c . AuthCode .................. :Domains unter bestimmten TLDs sind mit einem sogenannten AuthCode geschützt, um zu verhindern, dass die Domain unberechtigt zu einem anderen Registrar transferiert wird.
In Ihrem Kundenaccount unter Support -> Übersicht Top-Level-Domains finden Sie eine Übersicht der Einstellungen jeder TLD mit dem Hinweis, ob ein AuthCode optional oder erforderlich ist und wie viele Zeichen im AuthCode erlaubt sind.
Um eine Domain unter einer dieser TLDs von einem anderen Registrar zur EPAG zu transferieren, wird der AuthCode zu dieser Domain benötigt. Dieser ist in der Regel vom bisherigen Registrar erhältlich und wird als Parameter in diesem Feld an das System übergeben. Fehlt diese Angabe, so kann der Transfer nicht gestartet werden. Entsprechend benötigt der Domaininhaber von Ihnen den AuthCode, wenn er seine Domain zu einem anderen Registrar transferieren möchte.
Üblicherweise setzt das EPNIC System bei Registrierung oder eingehendem Transfer automatisch einen AuthCode. Weiterhin besteht für Sie die Möglichkeit, bei der Registrierung oder einem Update einer bereits in EPAG-Account befindlichen Domain einen AuthCode in Feld 1c anzugeben. Sofern der vorgeschlagene AuthCode mit den Syntax-Anforderungen (siehe Abschnitt 8.3) der jeweiligen Vergabestelle entspricht, wird dieser AuthCode gesetzt. Andernfalls erzeugt das System selbstständig einen AuthCode und teilt diesen in der Statusrückmeldung mit. Wird kundenseitig kein AuthCode vorgegeben, so wird ein automatisch generierter AuthCode bei der Domainregistrierung vergeben. Dieser ist per QUERY-Auftrag oder per Abfrage über die Web-Oberfläche abrufbar.
Um einen bereits gesetzten AuthCode abzufragen, können Sie entweder das QUERY Kommando nutzen oder den Authcode über die Web-Oberfläche abfragen.
1d . Registration Period (Years) :Bei Neuregistrierungen kann hier der gewünschte Registrierungszeitraum angegeben werden. Üblicherweise beträgt die Mindestdauer bei der Registrierung einer Domain 1 Jahr, kann aber auf maximal 10 Jahre ausgeweitet werden. In diesem Feld ist die Anzahl der Jahre anzugeben, also z. B. eine „2“ für zwei Jahre. Nur absolute, ganzzahlige Werte (1-10) können eingetragen werden. Zusätze wie „Jahr“, „Jahre“ oder ähnliches führen zu einer Fehlermeldung. Die tatsächlich mögliche maximale Registrierungsdauer ist abhängig von der beauftragten TLD. Wird in diesem Feld kein Parameter eingetragen, so setzt EPNIC bei Neuregistrierungen als Standardwert die Mindestregistrierungsdauer der jeweiligen Top-Level-Domain ein.
Nach Ablauf des anfänglichen Registrierungszeitraumes wird die Domain automatisch um den jeweils niedrigsten möglichen Zeitraum (in der Regel 1 Jahr) verlängert, sofern kein bestätigter Lösch- oder Expire-Auftrag vorliegt.
In Verbindung mit RENEW-Aufträgen wird in diesem Feld die gewünschte Anzahl an Jahren eingetragen, um die eine Domain aktiv verlängert werden soll.
1e . Domain-Status ............. :Angaben in diesem Feld werden nur in Verbindung mit den Auftragstypen REG, TRANSFER und UPDATE berücksichtigt.
Über das Setzen des Domainstatus ist es möglich, eine Domain vor bestimmten Änderungen zu schützen oder sie zu deaktivieren. Sie können den Domainstatus wie folgt setzen:
ACTIVE oder OK
Die Domain ist uneingeschränkt nutzbar. Transferanfragen anderer Registrare für die Domain sind möglich, Domaindaten können geändert werden, die Domain kann gelöscht werden.
clientTransferProhibited
Transferanfragen anderer Registrarez werden auf Ebene der Registry abgelehnt. sofern dieser Status auf Registry-Seite verfügbar ist. Somit ist die Domain vor einem unberechtigten Transfer geschützt.
Die Domain ist erreichbar, Änderungen an der Domain sind möglich, die Domain kann gelöscht werden.
clientUpdateProhibited
Es sind keine Änderungen an der Domain möglich, auch keine Änderungen des Domainstatus. Die einzig mögliche Änderung ist das Entfernen des Status „clientUpdateProhibited“ (sofern gleichzeitig auch ein anderer Status gesetzt ist und entfernt werden soll, muss dieses in einem separaten Schritt danach erfolgen).
Die Domain ist erreichbar, Transferanfragen anderer Registrare für die Domain sind möglich, die Domain kann gelöscht werden.
clientDeleteProhibited
Die Löschung einer Domain mit diesem Status ist nicht möglich.
Die Domain ist erreichbar, Transferanfragen anderer Registrare für die Domain sind möglich, Änderungen an der Domain sind möglich.
clientLock
In diesem Status ist die Domain uneingeschränkt nutzbar, es sind jedoch keinerlei Änderungen der Domaindaten möglich. Transferanfragen anderer Registrare werden automatisch auf der Ebene der Registry abgelehnt, die Domain ist vor einem unberechtigten Transfer geschützt. „clientLock“ ist daher eine Kombination aus „clientTransferProhibited“, „clientUpdateProhibited“ und „clientDeleteProhibited“.
clientHold
Eine Domain im Status „clientHold“ wird im DNS nicht mehr aufgelöst und ist somit nicht mehr erreichbar. Sowohl Web- als auch E-Mail-Services sind dann nicht mehr nutzbar. Änderungen der Domaindaten sowie Transfers und Löschungen sind ebenfalls nicht möglich.
Inactive
Dieser Status wird nur mit .xxx-Domains verwendet. Wenn Sie eine .xxx-Domain registrieren möchten, die bei der Registry nicht auflösen wird, können Sie bei der Registrierung die Domain auf „Inactive" setzten. In diesem Fall wird die Registry die .xxx-Mitgliedschaft des Inhabers nicht prüfen.
„clientTransferProhibited“, „clientUpdateProhibited“ und „clientDeleteProhibited“ können kombiniert werden, indem sie im Domainauftrag durch Komma getrennt eintragen werden, Beispiel:
1e . Domain-Status ............. :clientDeleteProhibited,clientTransferProhibitedBei der Angabe der Statusbezeichnungen wird nicht zwischen Groß- und Kleinschreibung unterschieden.
Die Funktionalität Statusänderung ist nur für solche TLDs verfügbar, in denen die Vergabe eines Domainstatus seitens der Registry möglich ist und bei denen wir als Registrar Zugriff auf die Statusvergabe haben. Eine Übersicht, für welche TLDs dies gilt, finden Sie im Kundenportal unter „Support" -> „Übersicht Top-Level-Domains" Spalte „Domainstatus verfügbar“.
Bitte beachten Sie, dass gTLD-Domains für einen Zeitraum von 60 Tagen nach der Registrierung automatisch in den Status „serverTransferProhibited“ versetzt werden und entsprechend für einen Transfer gesperrt sind. Einige Vergabestellen setzen diesen Status für die gleiche Dauer auch nach einem Transfer.
1f . E-Mail-Profile .............. :Werte unter diesem Key werden nur in Verbindung mit einem REG-, TRANSFER- oder UPDATE-Auftrag bearbeitet.
Der E-Mail-Profile-Key wird dazu verwendet, eine Domain mit einem bestimmten E-Mail-Profil zu verknüpfen, das bei der Sendung der nächsten WDRP- oder GDPR-Nachricht genutzt wird. Bitte tragen Sie den Namen des Profils genauso ein, wie er im Kundenportal unter WDRP und Datenschutzgrundverordnung hinterlegt ist.
Wenn das E-Mail-Profil erfolgreich mit der Domain verknüpft werden konnte, enthält die Rückmeldung die Zeile „E-Mail-Profile" im Abschnitt der Domain-Daten. Fehlt in der Rückmeldung diese Zeile, dann wurde kein E-Mail-Profil verknüpft. Um das E-Mail-Profil von einer Domain zu trennen, senden Sie den E-Mail-Profile-Key ohne Wert. Die Antwort sollte dann keine E-Mail-Profile-Zeile enthalten.
1g . Renewal Mode .............. :Werte unter diesem Key werden nur in Verbindung mit einem REG-, TRANSFER-, UPDATE, CHANGEOWNER- oder BACKORDER-Auftrag bearbeitet.
Domains bei EPAG werden standardmäßig auf „auto-renew" gesetzt. Dies bedeutet, dass die Domain automatisch zum nächsten Expire-Datum um die Mindestlaufzeit verlängert wird, wenndie Domain nicht explizit auf Expire gesetzt wurde. Dieser Key erlaubt Ihnen, den Renewal-Modus einer bestimmten Domain zu ändern.
Die verfügbaren Optionen sind:
- auto-renew: Standard-Einstellung, die die Domain automatisch zum Expire-Datum verlängert.
- expire: Einstellung, die die Domain zum Expire-Datum löschen lässt. Das heißt, die Domain wird am Expire-Datum gelöscht und kann nicht mehr verlängert werden.
- once: Diese Einstellung erlaubt eine einmalige Verlängerung der Domain, nach der die Domain automatisch auf „expire" gesetzt wird. Sollte der Renewal-Modus nicht geändert werden, wird die Domain zum nächsten Expire-Datum gelöscht.
Renewal-Modus-Einstellungen können möglicherweise in Widerspruch zu den veralteten EXPIRE- oder UNEXPIRE-Befehlen stehen. Die EXPIRE- oder UNEXPIRE-Befehle wurden vor der Implementierung des Renewal-Modus verwendet, um Domains auslaufen zu lassen. Wenn ein Expire-Auftrag für eine Domain vorhanden ist, läuft die Domain ohne Berücksichtung des Renewal-Modus zum nächsten Expire-Datum ab. Sie können den Renewal-Modus einer Domain nicht durch die Übermittlung eines UNEXPIRE-Befehls ändern. Solange die Domain den Renewal-Modus „expire" hat, wird sie zum nächsten Expire-Datum gelöscht.
Die Funktionalität des Renewal-Modus muss für jeden Kunden-Account freigegeben werden. Wenn der Renewal-Modus für Ihren Account noch nicht freigegeben ist, Sie diese Funktionalität aber nutzen möchten, kontaktieren Sie bitte unseren Kundenservice.
1h . Use standard IRTP-procedure :Nach einem erfolgreichen Inhaberwechsel wird eine gTLD-Domain standardmäßig für 60 Tage für Registrar-Transfers gesperrt. Diese Transfer-Sperre wird durch den Domain-Status ClientTransferProhibited durchgeführt. ICANN erlaubt dem alten Inhaber (und nur dem alten Inhaber), die Transfer-Sperre der Domain zu entfernen. Dies muss bei der Bestätigung des Inhaberwechsels geschehen. In den Fällen, wo EPAG im Namen des alten Inhabers (als Designated Agent) den Inhaberwechsel bestätigt, gilt die Transfer-Sperre automatisch.
Wenn Sie dem alten Inhaber die Möglichkeit geben möchten, die Transfer-Sperre der Domain zu entfernen, muss der alte Inhaber den Inhaberwechsel durch das E-Mail-Verfahren bestätigen. Um EPAG mitzuteilen, dass die Bestätigung durch das E-Mail-Verfahren erfolgen soll, muss das Feld 1h mit positivem Wert im Transfer- oder Update-Auftrag mitgeliefert werden.
Domainkontakte:
Für die Registrierung einer Domain kommen folgende Kontakte zum Einsatz:
Owner
Domaininhaber, verantwortlich für die Domain
Admin-C
administrativer Kontakt, vertretungsberechtigt für den Domaininhaber
Tech-C
verantwortliche technische Kontaktperson
Zone-C
Ansprechpartner für DNS-Angelegenheiten
Billing-C
„Rechnungsempfänger“ (lt. öffentlichem Whois-Eintrag; alle über EPNIC registrierten Domains werden unabhängig vom Eintrag in diesem Feld grundsätzlich direkt dem EPAG-Accountinhaber in Rechnung gestellt; üblicherweise ist als Billing-C unser direkter Kunde angegeben, der Eintrag hat ansonsten keine praktische Bedeutung).
CED-C
Kontakt gemäß der .asia „Charter Eligibility Declaration“ (CED). Der hier verwendete Kontakt muss ebenfalls in mindestens einer der übrigen Funktionen (Owner, Admin-C, Tech-C und Billing-C) verwendet werden.
Die Angabe von allen oben genannten Kontakten ist nicht für jede Top-Level-Domain zwingend erforderlich (z. B. .ch oder .eu). Werden mehr als nur die benötigten Kontakte angegeben, resultieren keine Probleme – nicht benötigte Kontakte werden in der Bestellung einfach ignoriert. Unter anderem kennen einige Vergabestellen keinen Admin-C (z. B. .eu oder .ch). In diesem Fall ist der Domaininhaber der alleinige Verfügungsberechtigte und es wird nur das Owner-Handle für die Domain verwendet. Für jede Domain muss mindestens der Domaininhaber angegeben werden.
Eine Übersicht mit den erforderlichen Kontakten zu einer Top-Level-Domain stellen wir bei Bedarf separat zur Verfügung. Bitte beachten Sie bezüglich der Nutzung der Kontakt-Handles zudem die Registrierungsbedingungen der jeweiligen Registries.
Der folgende Abschnitt erläutert die Struktur eines Kontakts anhand der Standard-Attribute eines Inhaberkontakts. Auf alle zusätzlichen Keys wie z.B. Handelsregisternummer oder Umsatzsteuernummer wird im Abschnitt "Erläuterung der Keys" eingegangen.
2a . Owner EPNIC-Handle ........ :Sofern in Ihrem Kundenaccount schon EPNIC-Handles angelegt wurden, können Sie ein bestehendes Handle im Feld a eintragen. Die übrigen Handle-Felder (b bis l) werden dann ignoriert. Falls mit dem Auftrag gleichzeitig ein neues Handle angelegt werden soll, bleibt das Feld a leer.
2b . Person Name ............... :In diesem Feld wird der Name der Person eingetragen. Dazu sollte der Name nur in der folgenden Form eingetragen werden:
Vorname Name (ohne Komma)
Die Angabe von Firmenbezeichnungen (z. B. EPAG Domainservices GmbH) in diesem Feld sollte unbedingt vermieden werden, da einige Vergabestellen zwingend die Angabe einer natürlichen Kontaktperson in diesem Feld verlangen und ein Kontakt ohne diese Angabe nicht zur Registrierung von Domains verwendet werden kann. In einem solchen Fall wird der Domainauftrag mit einem Fehler („contact not accepted“) abgebrochen.
Die Angabe eines Namens in diesem Feld ist Pflicht, wenn der Handle-Typ „Person“ ist (Feld 2tp, Wert „PERS“). In diesem Fall wird die hier angegebene Person bei der Vergabestelle als Domaininhaber eingetragen.
Ist das betreffende Handle vom Typ „Organisation“ (Feld 2tp, Wert „ORG“), so muss in Feld 2b nicht zwingend ein Name angegeben sein. Zahlreiche Vergabestellen fordern allerdings auch dann den Namen eines persönlichen Ansprechpartners, wenn eine Organisation als Domaininhaber eingetragen wird.
2c . Organisation .............. :Im Feld 2c wird die Bezeichnung einer juristischen Person (Unternehmen, Stiftung, Verein, etc.) eingetragen. Sofern der Kontakt vom Typ „Organisation“ angelegt wird (siehe 2tp), ist ein Eintrag in diesem Feld Pflicht, und der Eintrag in Feld 2c gilt als Domaininhaber.
Sofern die Anzahl der Zeichen die Maximalvorgabe einer Registry übersteigt, wird die maximal mögliche Anzahl an Zeichen übertragen und der Eintrag danach abgeschnitten.
2e . Street .................... :
2f . Postal Code ............... :
2g . City ...................... :Diese drei Einträge sollten weitestgehend selbsterklärend sein. Geben Sie die Straße mit der Hausnummer im Feld e an. Die Postleitzahl gehört in das Feld f und sollte ohne Länderkennung (z. B. D-...) angegeben werden. Im Feld g steht der Wohnort.
2h . State/Province ............ :In diesem Feld wird das Bundesland, der Kanton oder die Provinz angegeben.
2i . Country Code .............. :Tragen Sie hier die Länderkennung nach ISO 3166 (z. B. „DE“ für Deutschland) ein. Eine Liste der ISO-Länderkennungen finden Sie hier: http://www.iso.org/iso/country_codes/iso_3166_code_lists.htm
2j . Phone No. ................. :
2k . Fax No. ................... :Hier tragen Sie bitte genau eine Telefon- beziehungsweise eine Faxnummer ein. Die Angabe muss stets in internationaler Schreibweise erfolgen, also ein Pluszeichen gefolgt von der länderspezifischen Vorwahl, einem Punkt, die Ortsvorwahl ohne führende Null und dann die Durchwahl:
(z. B. : +49.211 52288680)
Die Ziffern dürfen durch Leerzeichen getrennt werden.
Richtig:
+49.211 522 886 80
+49.21152288680
Falsch:
+49 0211 52288680
+49-211-522 88680
+4921152288680
2l . E-mail Address ............ :Hier wird genau eine gültige und erreichbare E-Mail-Adresse für den Kontakt angegeben. Für Owner- und Admin-Kontakte ist es besonders wichtig, dass die angegebene Adresse erreichbar ist. Alle Anfragen zu einer Domain laufen über (mindestens) eine dieser Adressen. Ist sie nicht erreichbar, so kann das im ungünstigsten Fall dazu führen, dass die Domain gelöscht wird.
2tp . Contact Type (Org|Person) . :In diesem Feld wird der Kontakttyp festgelegt. Zur Auswahl stehen Person oder Organisation. Der Kontakttyp entscheidet, ob es sich bei dem Kontakt um eine Privatperson oder ein Unternehmen handelt. Auswirkungen hat dies insbesondere bei Kontakten, die als Inhaber verwendet werden: Bei „Person“ ist die Privatperson der Domaininhaber, die im Feld „Name“ (2b) eingetragen ist. Bei „Organisation“ dagegen ist der Domaininhaber die juristische Person, die im Feld „Organisation“ (2c) angegeben wird.
9a . CED-C EPNIC-Handle ........ :Dieses Feld sowie die übrigen Felder des Template-Abschnitts 9 werden für Registrierungen von .asia-Domains benötigt. Hier wird der sogenannte CED-Kontakt angegeben, dieser legt fest, dass für .asia-Domains mindestens einer der für die Domainregistrierung verwendeten Kontakte (Owner, Admin-C, Tech-C oder Billing-C) in Asien ansässig sein muss.
Der CED-Kontakt muss zwingend auch in einer der anderen Kontaktfunktionen der Domain verwendet werden, es ist nicht möglich, hier einen zusätzlichen Kontakt anzugeben. Im Feld 9a kann demnach das Handle eines Kontakts angegeben werden, der bereits auch in 2a, 3a, 4a oder 6a eingetragen wurde.
Wird kein bestehendes Handle, sondern ein mit diesem Auftrag neu angelegter Kontakt als CED-Kontakt verwendet, so müssen in den Feldern 9b bis 9l sowie 9tp die exakt gleichen Daten wie in dem betreffenden neu angelegten Kontakt eingetragen werden. Zum Beispiel: Als CED-Kontakt soll der im Template-Abschnitt 2 neu angelegte Inhaber verwendet werden. Dann müssen die Daten in 2b – 2l identisch mit denen in 9b – 9l sein.
Falls die Nutzung unseres Trustee-Services für .asia-Domains gewünscht wird (siehe Feld 8i), setzen wir automatisch unseren Trustee-Kontakt als CED-Kontakt und Billing-C ein. In diesem Fall ist die Angabe des CED-Kontakts durch den Kunden nicht erforderlich. Werden trotz Nutzung des Trustee-Service Angaben für den CED-Kontakt gemacht, so werden diese weitgehend ignoriert. Die Prüfung der Pflichtfelder des Kontaktes (insbesondere die Felder m0, m1 und m2 des Kontakt-Templates) greift jedoch auch in diesem Fall, so dass es zu unerwarteten Fehlermeldungen kommen kann, wenn diese nicht korrekt ausgefüllt sind. Wir empfehlen daher, bei Nutzung des Trustee-Services keinen CED-Kontakt anzugeben.
9m0. Identification Number ..... :In diesem Feld ist die Identifikationsnummer eines Dokuments anzugeben, welches die Identität des CED-Kontakts belegt. Bei Personen ist das in der Regel die Personalausweisnummer, bei juristischen Personen ein Registereintrag. Um welche Art von Nummer es sich handelt, wird in Feld 9m1 übergeben.
9m1. Form of Identity .......... :In diesem Feld ist die Art des Identifikationsdokuments anzugeben, auf das sich die Identifikationsnummer in Feld 9m0. bezieht (möglich sind: passport, certificate, legislation, societiesRegistry, politicalPartyRegistry).
9m2. Type of Entity ............ :In diesem Feld ist die Art der Rechtspersönlichkeit anzugeben, die sich mit der Identifikationsnummer in Feld 9m0 ausweist. Möglich ist hier (jeweils mit Erläuterung) naturalPerson (natürliche Person), corporation (Unternehmen), cooperative (Genossenschaft), partnership (Personengesellschaft), government (Regierungsinstitiution, Staat oder Gemeinde), politicalParty (Partei oder Gewerkschaft), society (Stiftung) oder institution (Institutionen).
Nameserver:
7a . Hidden-Primary DNS ........ :Dieses Feld ist optional. Falls Sie einen „Hidden-Primary-DNS“ verwenden wollen, tragen Sie hier die IP-Adresse (nicht den Hostnamen) dieses Servers ein. EPNIC legt dann eine Zone auf den EPAG-Nameservern an und ruft die Zoneneinträge bei dem hier angegebenen Hidden-Primary ab. Die Nutzung dieser Funktion ist nur möglich, wenn die EPAG-Nameserver dns1.epag.net und dns2.epag.net als Primary und Secondary Nameserver verwendet werden. Derzeit wird hier nur die Angabe einer IPv4-Adresse akzeptiert.
In den folgenden Feldern 7a0 bis 7h4 werden die öffentlich sichtbaren Nameserver eingetragen.
7a0. 1. Domainnameserver ....... :
7a1. 1. DNS IP ................. :
7a2. 2. DNS IP ................. :
7a3. 3. DNS IP ................. :
7a4. 4. DNS IP ................. :
7b0. 2. Domainnameserver ....... :
7b1. 1. DNS IP ................. :
7b2. 2. DNS IP ................. :
7b3. 3. DNS IP ................. :
7b4. 4. DNS IP ................. :
...
7h0. 8. Domainnameserver ....... :
7h1. 1. DNS IP ................. :
7h2. 2. DNS IP ................. :
7h3. 3. DNS IP ................. :
7h4. 4. DNS IP ................. :Für jede Domainregistrierung sind mindestens zwei Domainnameserver (DNS) erforderlich. Die Hostnamen dieser Nameserver sind in die Felder 7a0 und 7b0 einzutragen.
In der Regel wird vor Registrierung oder Update einer Domain ein Nameservertest ausgeführt, der die Gültigkeit der auf dem Nameserver für die Domain hinterlegten Zone prüft. Diese Prüfung berücksichtigt die bekannten Kriterien der Vergabestellen für die Nameserver-Konfiguration und liefert bei einem negativen Ergebnis eine detaillierte Fehlermeldung zurück.
Die Angabe der IP-Adresse in den Feldern 7a1-4, 7b1-4 etc. ist nur bei sogenannten „Glue Records“ erforderlich. „Glue Record“ bedeutet, dass der Hostname des Nameservers in der Domain liegt, die gerade registriert werden soll (Bsp.: Nutzung des Nameservers „dns1.epag.net“ bei der Registrierung der Domain „epag.net“). In diesem Fall legt EPNIC die gewünschten Nameserver automatisch mit den angegebenen IP-Adressen bei der Vergabestelle an.
Es können bis zu vier IPv4 und IPv6-Adressen angegeben werden. Bitte beachten Sie jedoch, dass IPv6-Adressen insbesondere bei ccTLDs nicht durchgängig unterstützt werden.
Zur Aktualisierung der "Glue Records" eines bereits registrierten Nameservers kann das Domain-Template verwendet werden. Senden Sie dazu einen Update-Auftrag für die Domain, unter der die Nameserver liegen, und tragen Sie die neuen IP-Adressen in die entsprechenden Templatefelder ein.
Wichtig:
Nur Aufträge für die Domain, unter welcher die Nameserver liegen, ändern die IP-Addressen der Nameserver bei der Registry.
## VERSION 6.4 DOMAIN (2008-04-18) DO NOT REMOVE OR CHANGE!
0 . EPNIC-Customer-ID ......... : 0815
0a . Requested Action .......... : MOD
1a . Domainname ................ : mydomain.net
7a0. 1. Domainnameserver ....... : dns1.mydomain.net
7a1. 1. DNS IP ................. : 212.123.27.44
7a2. 2. DNS IP ................. : 2019:db8:1234::12
7a3. 3. DNS IP ................. :
7a4. 4. DNS IP ................. :
7b0. 2. Domainnameserver ....... : dns2.mydomain.net
7b1. 1. DNS IP ................. : 212.123.33.89
7b2. 2. DNS IP ................. : 2019:db8:1234::7
7b3. 3. DNS IP ................. :
7b4. 4. DNS IP ................. :Treuhandservice (Trustee Service):
8i . Use Trustee Service........ :Für einige Top-Level-Domains stellt EPAG optional einen lokalen Ansprechpartner (Trustee) vor Ort, sofern dies für die Domainregistrierung erforderlich ist. Dieser Service kann mit einem „Yes“ in diesem Feld in Anspruch genommen werden. Mit einem „Yes“ in diesem Feld werden zudem implizit die jeweiligen Trustee-Vertragsbedingungen akzeptiert. Diese sind auf unserer Website www.epag.de zum Download verfügbar. Auch bei Nutzung des Treuhandservice ist ein Owner-Kontakt anzugeben.
Teilupdates einer Domain
Der UPDATE-Befehl erlaubt Ihnen, alle oder nur einzelne Teile einer Domain zu modifizieren. Wenn Sie nur einen Teil einer Domain modifizieren möchten, senden Sie nur diesen Keys im UPDATE-Befehl und lassen den Rest weg. Die nun folgenden Elemente können einzeln modifiziert werden. Sie können auch kombiniert werden, um z.B. der Status und AuthCode einer Domain mit nur einem Befehl zu ändern.
Teilupdates einer Domain sind für manche TLDs nicht verfügbar. Für .de z.B. müssen die Kontakt-Handles und Nameserver immer mit einem Update-Auftrag gesendet werden, auch wenn sich nur die Nameserver ändern.
AuthCode
Um nur den AuthCode einer Domain zu ändern, genügt es, die folgenden Keys zu senden:
## VERSION 6.4 DOMAIN (2008-04-18) DO NOT REMOVE OR CHANGE !!!!
0 . EPNIC-Customer-ID ......... : 40002
0a . Requested Action .......... : UPDATE
1a . Domainname ................ : example.com
1c . AuthCode .................. : NewAuthCodeDomain-Status
Sie können den Domain-Status modifizieren oder einen Status hinzufügen oder entfernen, indem Sie ein Plus- bzw. Minuszeichen als Präfix zum Status setzten. Im folgenden Beispiel
bleibt der aktuelle Status bestehen, zusätzlich wird der Status „clientTransferProhibited” hinzugefügt:
## VERSION 6.4 DOMAIN (2008-04-18) DO NOT REMOVE OR CHANGE !!!!
0 . EPNIC-Customer-ID ......... : 40002
0a . Requested Action .......... : UPDATE
1a . Domainname ................ : example.com
1e . Domain-Status ............. : +clientTransferProhibitedEine andere Option ist, den Domain-Status komplett neu zu setzten, ohne Präfixe zu verwenden.
## VERSION 6.4 DOMAIN (2008-04-18) DO NOT REMOVE OR CHANGE !!!!
0 . EPNIC-Customer-ID ......... : 40002
0a . Requested Action .......... : UPDATE
1a . Domainname ................ : example.com
1e . Domain-Status ............. : clientTransferProhibited, ClientDeleteProhibitedRenewal-Modus
Das folgende Beispiel zeigt, wie Sie den Renewal-Modus einer Domain anpassen können:
## VERSION 6.4 DOMAIN (2008-04-18) DO NOT REMOVE OR CHANGE !!!!
0 . EPNIC-Customer-ID ......... : 40002
0a . Requested Action .......... : UPDATE
1a . Domainname ................ : example.com
1g . Renewal Mode .............. : expireKontakt-Update
Kontakt-Updates werden etwas anders verarbeitet, weil immer alle Kontakte übermittelt werden müssen, auch wenn Sie nur einen einzigen Kontakt aktualisieren möchten. Um z.B. den Admin-c einer Domain zu aktualisieren, können Sie nicht nur den Key mit dem neuen Admin-Handle übermitteln. Stattdessen müssen Sie alle Handles im Befehl senden, einschließlich des neuen Admin-Handles:
## VERSION 6.4 DOMAIN (2008-04-18) DO NOT REMOVE OR CHANGE !!!!
0 . EPNIC-Customer-ID ......... : 40002
0a . Requested Action .......... : UPDATE
1a . Domainname ................ : example.com
2a . Owner EPNIC-Handle ........ : AD1-EPNIC
3a . Admin-C EPNIC-Handle ...... : AD2-EPNIC
4a . Tech-C EPNIC-Handle ....... : AD1-EPNIC
6a . Billing-C EPNIC-Handle .... : AD1-EPNICWenn Sie eine Domain aktualisieren, die Trustee-Service verwendet, müssen Sie auch den Trustee-Key mit dem UPDATE-Auftrag übermitteln.
Nameserver
Eine Änderung der Nameserver muss die folgenden Keys enthalten.
## VERSION 6.4 DOMAIN (2008-04-18) DO NOT REMOVE OR CHANGE !!!!
0 . EPNIC-Customer-ID ......... : 40002
0a . Requested Action .......... : UPDATE
1a . Domainname ................ : example.com
7a0. 1. Domainnameserver ....... : ns1.epample.com
7b0. 2. Domainnameserver ....... : ns2.epample.com