GUIDE TECHNIQUE avril 2014 1 Spécifications fonctionnelles de l'ouverture des 1 et 2 caractères en.fr pour EPP
GUIDE TECHNIQUE avril 2014 2 T a b l e d e s m a t i è r e s 1. Préface... 3 2. Fonctionnement des différentes phases... 3 2.1.1. Caractéristiques communes... 3 2.1.2. Sunrise... 3 2.1.3. Landrush... 4 2.1.4. Ouverture générale... 4 3. EPP... 4 3.1. Serveurs de production et de test EPP... 4 3.1.1. Serveur de production... 5 3.1.2. Serveur de test... 5 3.2. L extension «Launch Phase»... 5 3.3. Sunrise... 5 3.3.1. Le login... 5 3.3.2. Vérifier la disponibilité d un nom de domaine... 6 3.3.3. Déposer une demande... 7 3.3.4. Consulter l état d une demande... 8 3.3.5. Supprimer une demande... 9 3.4. Landrush et ouverture générale... 10 3.5. Notifications EPP... 10 3.6. Codes retours du serveur EPP... 11 4. Extranet... 11 5. Transmission des justificatifs... 11
GUIDE TECHNIQUE avril 2014 3 1. Préface Ce document décrit le fonctionnement de l ouverture des 1 et 2 caractères sur le.fr via le protocole EPP. 2. Fonctionnement des différentes phases 2.1.1. Caractéristiques communes 2.1.1.1. Périmètre Les noms de domaine compris dans cette ouverture sont ceux composés : - Soit d un seul caractère alphabétique - Soit d un seul caractère numérique - Soit de deux caractères alphanumériques Les versions IDN des caractères alphabétiques sont fournies ci-dessous. 2.1.1.2. Contraintes syntaxiques Caractères acceptés : a, à, á, â, ã, ä, å, æ, b, c, ç, d, e, è, é, ê, ë, f, g, h, i, ì, í, î, ï, j, k, l, m, n, ñ, o, ò, ó, ô, õ, ö, œ, p, q, r, s, t, u, ù, ú, û, ü, v, w, x, y, ý, ÿ, z, ß, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 2.1.1.3. Exclusion de noms de domaine - Exclusion des noms de domaine composés des codes pays du territoire national (fr.fr, re.fr, pm.fr, yt.fr, tf.fr, wf.fr, nc.fr, pf.fr, mf.fr, bl.fr, gp.fr, mq.fr, gf.fr) ainsi que leur version IDN. - Exclusion des noms de domaine co.fr, tm.fr, nh.fr 2.1.2. Sunrise La Sunrise est une phase de dépôt de demandes avec la règle du premier arrivé premier servi. Les demandes sont empilées et traitées au fur et à mesure de leur arrivée. Les justificatifs nécessaires pour qu une demande soit valide seront à transmettre via l extranet. Dès qu une demande est valide et éligible selon la politique d enregistrement, le nom de domaine est effectivement créé. Cette phase dure 2 mois.
GUIDE TECHNIQUE avril 2014 4 Liste des différents états d une demande : Etat via EPP Correspondance état (domain:info) via Extranet (liste des demandes) pendingvalidation A compléter pendingvalidation En attente de validation Description La demande est déposée, il reste à transmettre le(s) justificatif(s) via l extranet pour que la demande soit complète La demande a été complétée. Elle est en attente de validation par l Afnic rejected Rejetée La demande a été rejetée. Soit la demande est invalide, soit une demande antérieure a été allouée selon la règle du premier arrivé premier servi. allocated Attribuée La demande a été allouée. Le nom de domaine est créé. 2.1.3. Landrush Le Landrush est une phase d enregistrement immédiat avec la règle du premier arrivé premier servi. Aucun nom de domaine demandé en phase Sunrise ne pourra être déposé tant que la ou les demandes n auront pas été traitées par l Afnic. Cette phase dure 1 mois. 2.1.4. Ouverture générale 3. EPP L ouverture générale est une phase d enregistrement immédiat avec la règle du premier arrivé premier servi. Aucun nom de domaine demandé en phase Sunrise ne pourra être déposé tant que la ou les demandes n auront pas été traitées par l Afnic. Cette phase est sans durée. Ce chapitre décrit les paramètres de connexion et comment est utilisée l extension launchphase pour la phase Sunrise. 3.1. Serveurs de production et de test EPP
GUIDE TECHNIQUE avril 2014 5 3.1.1. Serveur de production Serveur EPP : epp.nic.fr port : 700 3.1.2. Serveur de test Serveur EPP : epp.sandbox.nic.fr port : 700 3.2. L extension «Launch Phase» L extension Launch Phase Mapping est utilisée pour la gestion de la phase Sunrise (http://tools.ietf.org/html/draft-ietf-eppext-launchphase-01). Nous vous invitons à bien lire les spécifications de l extension afin de faciliter son intégration dans votre client EPP. 3.3. Sunrise 3.3.1. Le login Comme le mentionnera le greetings du serveur EPP, la déclaration au login de l extension Launch Phase est obligatoire si vous souhaitez déposer une demande pour un nom de domaine d 1 ou 2 caractères en phase de Sunrise. Exemple de requête de login : <?xml version="1.0" encoding="utf-8"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd"> <command> <login> <clid>-test-.fr</clid> <pw>motdepasse</pw> <options> <version>1.0</version> <lang>en</lang> </options> <svcs> <objuri>urn:ietf:params:xml:ns:domain-1.0</objuri> <objuri>urn:ietf:params:xml:ns:contact-1.0</objuri> <svcextension> <exturi>http://www.afnic.fr/xml/epp/frnic-1.2</exturi> <exturi>urn:ietf:params:xml:ns:rgp-1.0</exturi> <exturi>urn:ietf:params:xml:ns:secdns-1.1</exturi> <exturi>urn:ietf:params:xml:ns:launch-1.0</exturi> </svcextension> </svcs> </login> <cltrid>test-login</cltrid> </command>
GUIDE TECHNIQUE avril 2014 6 3.3.2. Vérifier la disponibilité d un nom de domaine Pendant toute la durée de la Sunrise vous pouvez vérifier la disponibilité des noms de domaine en 1 ou 2 caractères. Etant donné que nous utilisons l extension LaunchPhase, vous devez indiquer le type du launch:check ( avail ) et la phase ( custom / name= 1et2car ). La commande peut contenir jusqu à sept noms de domaine. Exemple de requête à envoyer pour la phase Sunrise : <?xml version="1.0" encoding="utf-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <command> <check> <domain:check xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <domain:name>po.fr</domain:name> </domain:check> </check> <launch:check xmlns:launch="urn:ietf:params:xml:ns:launch-1.0" type="avail"> <launch:phase name= 1et2car >custom</launch:phase> </launch:check> <cltrid>8d81f30bc2ca9bbf0539e32bd9eab91680001ba2</cltrid> </command> Réponse reçue par le serveur EPP : <?xml version="1.0" encoding="utf-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <response> <result code="1000"> <msg>command completed successfully</msg> </result> <resdata> <domain:chkdata xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <domain:cd> <domain:name avail="1">po.fr</domain:name> </domain:cd> <domain:cd> <domain:name avail="1">aa.fr</domain:name> </domain:cd> </domain:chkdata> </resdata> <trid> <cltrid>8d81f30bc2ca9bbf0539e32bd9eab91680001ba2</cltrid> <svtrid>fr-sandbox-epp01-7915-15-1404459363.85108</svtrid> </trid> </response>
GUIDE TECHNIQUE avril 2014 7 3.3.3. Déposer une demande Pour déposer une demande en phase de Sunrise, vous devez spécifier le type de launch:create ( application ) et la phase ( custom / name= 1et2car ). Le serveur vous donnera en réponse un numéro de demande (applicationid). Voici un exemple de requête à envoyer : <epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd"> <command> <create> <domain:create xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" xsi:schemalocation="urn:ietf:params:xml:ns:domain-1.0 domain- 1.0.xsd"> <domain:period unit="y">1</domain:period> <domain:registrant>jj100</domain:registrant> <domain:contact type="admin">jj100</domain:contact> <domain:contact type="tech">jj100</domain:contact> <domain:authinfo> <domain:pw>test</domain:pw> </domain:authinfo> </domain:create> </create> <launch:create xmlns:launch="urn:ietf:params:xml:ns:launch-1.0" type="application"> <launch:phase name="1et2car">custom</launch:phase> </launch:create> <cltrid>exemple-1et2car-application</cltrid> </command> Voici la réponse du serveur : <?xml version="1.0" encoding="utf-8" standalone="yes"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd"> <response> <result code="1001"> <msg>command completed successfully; action pending</msg> </result> <msgq count="229" id="54"/> <resdata> <domain:credata xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <domain:crdate>2014-07-03t13:03:54z</domain:crdate> <domain:exdate>2015-07-03t13:03:54z</domain:exdate> </domain:credata> </resdata> <launch:credata xmlns:launch="urn:ietf:params:xml:ns:launch-1.0">
GUIDE TECHNIQUE avril 2014 8 <launch:phase name="1et2car">custom</launch:phase> <launch:applicationid> FRS20140703150354GOVIZYPU35723348</launch:applicationID> </launch:credata> <trid> <cltrid>exemple-1et2car-application</cltrid> <svtrid>fr-sandbox-epp01-6236-48-1404392606.90141</svtrid> </trid> </response> 3.3.4. Consulter l état d une demande Une fois vos demandes déposées, vous pouvez consulter leur état grâce à l applicationid reçu lors d un dépôt de demande. Exemple de requête à envoyer : <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <command> <info> <domain:info xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> </domain:info> </info> <launch:info xmlns:launch="urn:ietf:params:xml:ns:launch-1.0"> <launch:phase name= 1et2car >custom</launch:phase> <launch:applicationid>frs20140703150354govizypu35723348 </launch:applicationid> </launch:info> <cltrid>exemple-1et2car-info</cltrid> </command> Réponse du serveur : <?xml version="1.0" encoding="utf-8" standalone="yes"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd"> <response> <result code="1001"> <msg>command completed successfully</msg> </result> <msgq count="235" id="54"/> <resdata> <domain:infdata xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <domain:roid/> <domain:status s="inactive"/> <domain:status s="pendingcreate"/> <domain:registrant>jj100</domain:registrant> <domain:contact type="admin">jj100</domain:contact> <domain:contact type="tech">jj100</domain:contact> <domain:clid>>-test-.fr</domain:clid>
GUIDE TECHNIQUE avril 2014 9 <domain:crid>>-test-.fr</domain:crid> <domain:crdate>2014-07-03t13:03:54z</domain:crdate> <domain:exdate>2015-07-03t13:03:54z</domain:exdate> <domain:upid>-registry-.fr</domain:upid> <domain:update>2014-07-03t13:04:00z</domain:update> <domain:authinfo> <domain:pw>test</domain:pw> </domain:authinfo> </domain:infdata> </resdata> <launch:infdata xmlns:launch="urn:ietf:params:xml:ns:launch-1.0"> <launch:phase name= 1et2car >custom</launch:phase> <launch:applicationid>frs20140703150354govizypu35723348 </launch:applicationid> <launch:status s="pendingvalidation"/> </launch:infdata> <trid> <cltrid>exemple-1et2car-info</cltrid> <svtrid>fr-sandbox-epp01-9366-2-1404463244.55512</svtrid> </trid> </response> 3.3.5. Supprimer une demande La suppression de la demande est possible uniquement si la demande n est pas déjà en état «allocated» ou «rejected». La suppression provoquera le passage de l application en état «rejected» et il sera impossible de la restaurer. Exemple de requête pour supprimer une demande : <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <command> <delete> <domain:delete xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> </domain:delete> </delete> <launch:delete xmlns:launch="urn:ietf:params:xml:ns:launch-1.0"> <launch:phase name= 1et2car >custom</launch:phase> <launch:applicationid>frs20140703150354govizypu35723348 </launch:applicationid> </launch:delete> <cltrid>bc2ade1b460823674647afc5c8acb5d433a71ddf</cltrid> </command> Réponse du serveur : <?xml version="1.0" encoding="utf-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <response> <result code="1000">
GUIDE TECHNIQUE avril 2014 10 <msg>command completed successfully</msg> </result> <trid> <cltrid>bc2ade1b460823674647afc5c8acb5d433a71ddf</cltrid> <svtrid>fr-sandbox-epp01-20214-21-1407851320.34299</svtrid> </trid> </response> 3.4. Landrush et ouverture générale Ces 2 phases ne nécessitent pas l utilisation de l extension «Launch Phase» dans les commandes de création. Il suffira donc d envoyer des requêtes de création de nom de domaine sans l extension. 3.5. Notifications EPP Une notification EPP est empilée sur votre file de «poll» dès qu un changement d état d une application est effectué. Il vous suffit de dépiler votre file de «poll» pour prendre connaissance du changement d état sur l application concernée. Exemple de notification reçue lors du rejet d une demande : <?xml version="1.0" encoding="utf-8" standalone="yes"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd"> <response> <result code="1301"> <msg>command completed successfully; ack to dequeue</msg> </result> <msgq count="1" id="4739"> <qdate>2014-08-20t15:53:49.0z</qdate> <msg>application switches to "rejected" state</msg> </msgq> <resdata> <domain:pandata xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <domain:name paresult="0">pp.fr</domain:name> <domain:patrid> <cltrid>4775f6768d4f58187578e72ce8ee248a8e795338</cltrid> <svtrid>fr-sandbox-epp01-17597-21-1408549890.35671</svtrid> </domain:patrid> <domain:padate>2014-08-20t15:53:49.0z</domain:padate> </domain:pandata> </resdata> <trid> <cltrid>9b00d99fefe12bec420ff16cbc59de9290969e66</cltrid> <svtrid>fr-sandbox-epp01-17597-25-1408550005.08481</svtrid> </trid> </response>
GUIDE TECHNIQUE avril 2014 11 3.6. Codes retours du serveur EPP Les codes retours du serveur EPP sont décrits dans le RFC 5730. (http://tools.ietf.org/html/rfc5730#section-3) Les réponses du serveur EPP contiennent généralement un <msg> pertinent pour un debug si un problème est rencontré. 4. Extranet Il sera possible de soumettre vos demandes directement via l Extranet. Un second formulaire de création dédié à la phase Sunrise sera disponible dans la rubrique «Mes formulaires». 5. Transmission des justificatifs Cette rubrique concerne uniquement la phase de Sunrise. Le serveur EPP (et le formulaire de création dans l Extranet) ne permettant pas de fournir tous les types de justificatifs nécessaires afin de valider vos demandes de noms de domaine, une interface Web a été développée dans votre Extranet. Cette interface permettra de : - Voir toutes vos demandes reçues et acceptées par le serveur EPP (ou par l Extranet) ainsi que leur état, - Ajouter des justificatifs à vos demandes reçues et acceptées par le serveur EPP (ou par l Extranet).