Quick start guide Version February Quick start guide. Release 3.1. Copyright 2015 DNS Belgium vzw

Transcription

1 Quick start guide Version February 2016 Quick start guide Release 3.1 Copyright 2015 DNS Belgium vzw

2 Table of contents TABLE OF CONTENTS INTRODUCTION Purpose Overview Document history COSTUMER SUPPORT CONTACTS CONFIGURATION Access LIVE system TEST system User accounts EPP credentials Period durations IDN DNSSEC EPP BASICS EPP FRAME EXAMPLES... 7 APPENDIX 1: ALLOWED IDN CHARACTERS... 9 Copyright 2015 DNS Belgium vzw 2

3 1 Introduction 1.1 Purpose This document gives a short introduction to use the systems of DNS Belgium for gtlds.vlaanderen and.brussels. Full documentation is contained in the Registrar Manual. Note that DNS Belgium provides two separate Registry Systems: Test / OT&E System: This system allows Registrars to test the integration of their infrastructure with the Registry systems. Transactions performed in that system do not affect the live TLD / WHOIS data. Various periods are set to shorter intervals in order to ease the testing process. Production System: Transactions in the production system affect the live objects in the TLD and WHOIS interfaces. 1.2 Overview Configuration EPP basics Launch phases Examples 1.3 Document history Date Change 07/04/2014 Initial version 01/08/2014 Description of all launch phases 30/04/2015 Removal of launch phases, GA only 05/02/2016 Removal of disclose policy. Addition of 2 DNSSEC algorithms. Copyright 2015 DNS Belgium vzw 3

4 2 Costumer support contacts The registry support team can be reached at: phone number: Configuration 3.1 Access LIVE system The registry system is reachable as follows: TLD.vlaanderen.brussels EPP hostname epp.nic.vlaanderen epp.nic.brussels EPP port Registrar-web registrar.nic.vlaanderen registrar.nic.brussels Command line WHOIS whois.nic.vlaanderen:43 whois.nic.brussels:43 Finger finger.nic.vlaanderen:79 finger.nic.brussels:79 Copyright 2015 DNS Belgium vzw 4

5 3.1.2 TEST system The registry TEST system is reachable as follows: TLD.vlaanderen.brussels EPP hostname test-epp.nic.vlaanderen test-epp.nic.brussels EPP port Registrar-web test-registrar.nic.vlaanderen test-registrar.nic.brussels Command line WHOIS test-whois.nic.vlaanderen:43 test-whois.nic.brussels:43 Finger test-finger.nic.vlaanderen:79 test-finger.nic.brussels: User accounts Each registrar will receive a user-name (registrar handle) and temporary password to login to registrar-web. After login to registrar-web, the web password can be changed and the EPP password can be set. On the test system, two separate registrar accounts will be provided in order to test transfers. 3.3 EPP credentials The EPP password can be set on registrar-web. Access to the EPP server needs to be enabled on a per-ip-address basis. Addresses can be added via the registrar web. The EPP interface does not require a client certificate. The number of concurrent sessions to the EPP server of the live system per username is limited to 4 but can drop to 2 on DNS Belgium s initiative. Copyright 2015 DNS Belgium vzw 5

6 3.4 Period durations The Registry supports the following periods. Note that in order to test the various periods, the test Registry uses minutes where the production registry would use days. For example, the Add Grace Period on the test registry lasts for 5 minutes, where the same period will last for 5 days on the production registry. A summary of periods follows (Production periods, with test periods in parentheses): Add Grace Period: 5 days (5 minutes) Renew Grace Period: 5 days (5 minutes) Transfer Grace Period: 5 days (5 minutes) Auto-Renew Grace Period: 45 days (45 minutes) Redemption Period: 30 days (30 minutes) Pending Restore Report: 7 days (7 minutes) Pending Delete: 5 days (5 minutes) Pending Transfer: 5 days (5 minutes) 3.5 IDN The registry supports IDN2008. The IDN implementation has the following properties: The list of allowed characters can be found in the annex of this document. There is no variant handling. On the EPP-Interface, the A-Label must be used. 3.6 DNSSEC The Registry supports provisioning of DNSSEC information, and has the following related properties: The Registry requires key material as dsdata in the EPP frames The use of keydata is not supported Copyright 2015 DNS Belgium vzw 6

7 4 EPP Basics The EPP server has the following properties (this refers to the stable operations of the registry): The EPP server offers host, contact, domain objects. Domain names must include the TLD (e.g. example.brussels ). Newly created domain names are active immediate (no pendingcreate / approval). Host attributes in domains cannot be used (Use host objects). External host objects do not allow for IP addresses, while internal host objects (below the TLD) require at least one IP address. In contact objects, only the internationalized ( type=int ) fields can be used. In domain objects, exactly one registrant, and at least one tech, admin contact each is required. The billing contact is not supported. Contact objects require an empty authinfo element on creation. Contact transfers are not supported. The default value for disclose on contacts is 1. Please don t change this value for risk of being audited by ICANN. A restore command requires a subsequent restore report. Domain names can be created without references to host objects however, this also means such domains are not included in the DNS. Domain transfer requests require the authinfo of the respective domain object. Domain Transfers are auto-approved after 5 days (or, 5 minutes on the test system), but can also be o Approved or rejected by the losing registrar. o Cancelled by the gaining registrar 5 EPP Frame examples The following section provides EPP examples for the TLD. Place holders need to be changed for the respective request, and will change in the EPP server s response. Copyright 2015 DNS Belgium vzw 7

8 Registrations for domains are submitted as follows: Request: <?xml version="1.0" encoding="utf-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:xsi=" 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:name>${domain}</domain:name> <domain:period unit="y">1</domain:period> <domain:ns> <domain:hostobj>${ns1}</domain:hostobj> <domain:hostobj>${ns2}</domain:hostobj> </domain:ns> <domain:registrant>${registrant}</domain:registrant> <domain:contact type="admin">${admin}</domain:contact> <domain:contact type="tech">${tech}</domain:contact> <domain:authinfo> <domain:pw>${authinfo}</domain:pw> </domain:authinfo> </domain:create> </create> <cltrid>${cltrid}</cltrid> </command> </epp> Response: <?xml version="1.0" encoding="utf-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:xsi=" <response> <result code="1000"> <msg>command completed successfully</msg> </result> <resdata> <domain:credata xmlns="urn:ietf:params:xml:ns:domain-1.0" xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <domain:name>${domain}</domain:name> <domain:crdate>${crdate}</domain:crdate> <domain:exdate>${exdate}</domain:exdate> </domain:credata> </resdata> <trid> <cltrid>${cltrid}</cltrid> <svtrid>${svtrid}</svtrid> </trid> </response> </epp> Copyright 2015 DNS Belgium vzw 8

9 Appendix 1: allowed IDN characters Copyright 2015 DNS Belgium vzw 9

10 Copyright 2015 DNS Belgium vzw 10