SWITCH EPP Manual Version 2.1.2
Contents
1. domain relD contact id of the requester domain reDate Date of request domain aclD ZERO domain acDate Execution date domain exDate This is omitted O SWITCH 2010 Subject to change Page 12 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Example of a poll response after successful transfer lt xml version 1 0 encoding UTF 8 gt lt epp xmlns urn ietf lt response gt params xml ns epp 1 0 gt lt result code 1301 gt lt msg lang en gt Command completed successfully ack to dequeue lt msg gt lt result gt lt msgQ count 1 id 1139047 gt lt qDate gt 2007 09 26T00 00 00 02 00 lt qDate gt lt msg gt Domain transfer completed successfully lt msg gt lt msgQ gt lt epp resData xmlns epp urn ietf params xml ns epp 1 0 gt lt domain trnData xmlns domain urn ietf params xml ns domain 1 0 gt lt domain lt domain lt domain lt domain lt domain name gt yourname ch lt domain name lt domain relD gt PartnerB lt domain relD gt trStatus gt ServerApproved lt domain trStatus gt reDate gt 2007 09 18T22 43 00 02 00 lt domain reDate gt acID gt NULL lt domain acID gt acDate gt 2007 09 18T22 43 00 02 00 lt domain acDate gt lt domain trnData gt lt epp resData gt lt trID gt lt clTRID gt Partner_00_2 lt clTRID gt lt svTRID gt 20071008 13688 27039 lt svTRID gt lt2. SWITCH 2010 Subject to change Page 22 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Registrant Future Registrar Registry Current Registrar 1 transfer request with password s 2 transfer request with authinfg 3 perform request 4 command response 5 put message for current registrar 6 command response i 7 poll The complete domain transfer process in seven steps 1 transfer request with password The holder must request a transfer code for their domain name from their current Partner if the holder is with SWITCH they can order their transfer code themselves via their web interface As soon as they have obtained the transfer code they can forward it to the new Partner 2 transfer request with authinfo The new Partner sends the domain transfer request with the corresponding transfer code to SWITCH via EPP SWITCH 2010 Subject to change Page 23 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch 3 perform request The EPP server checks the request and transfers the domain name if the transfer code is correct Any subordinate name servers will similarly be transferred see Paragraph 4 4 1 After the transfer the domain name comes under the new Partner s domain name portfolio The contac
3. lt epp gt Example of a domain create response lt epp xmlns urn ietf params xml ns epp 1 0 gt lt response gt lt result code 1000 gt lt extension gt keyData is optional If sent the calculation of the pubKey has to lead to the digest lt msg lang en gt Command completed successfully lt msg gt lt result gt lt resData gt lt domain creData xmlns domain urn ietf params xml ns domain 1 0 gt lt domain name gt yourname ch lt domain name gt lt domain crDate gt 1999 04 03T22 00 00 0Z lt domain lt domain exDate gt 2001 04 03T22 00 00 0Z lt domain lt domain creData gt lt resData gt lt triD gt lt c1TRID gt ABC 12345 lt c1TRID gt lt svTRID gt 54321 XYZ lt svTRID gt lt trID gt lt response gt lt epp gt SWITCH 2010 Subject to change crDate gt exDate gt Page 21 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch 4 2 7 domain delete domain delete is used to delete domain names with immediate effect A domain name can be deleted by the authorised Partner at any time observing the rules in Reference 06 A deleted domain name can only be re registered after the transition period as per Reference 07 gt e Transferring domain names to other holders The current partner deletes the domain name with domain delete and then registers it again immediately for a different person or organisation
4. Example of a contact create command lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt command gt lt create gt lt contact create xmlns contact urn ietf params xml ns contact 1 0 gt lt contact id gt TEST PARTNER C 5 lt contact id gt contact postalInfo type loc gt lt contact name gt Test User2 lt contact name gt lt contact org gt SWITCH lt contact org gt lt contact addr gt lt contact street gt Test department 2 lt contact street gt lt contact street gt Teststrasse 2 lt contact street gt lt contact city gt Aarau lt contact city gt lt contact pc gt 5000 lt contact pc gt lt contact cc gt CH lt contact cc gt lt contact addr gt lt contact postalinfo gt lt contact voice gt 41 22222555 lt contact voice lt contact email gt test2ftestl ch lt contact email gt lt contact authInfo gt lt contact pw gt lt contact authInfo gt lt contact create gt lt create gt lt c1TRID gt Test2 lt c1TRID gt lt command gt lt epp gt SWITCH 2010 Subject to change Page 32 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Example of a contact create response lt xml version 1 0 encoding UTF 8 gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt response gt lt result code 1000 gt lt msg lang en gt Command completed successfully lt msg gt lt r
5. Value from domain contact type tech Expected result Command completed successfully O SWITCH 2010 Subject to change Page 43 49 Step 10 Update domain 1 complete transfer SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Description Tag Value Comment domain name TEST PARTNER domain 1 ch Replace TEST PARTNER with the clID received domain add ns3 TEST PARTNER domain Replace TEST PARTNER with the domain ns 1 ch clID received domain add TEST PARTNER 1 Replace TEST PARTNER with the domain contact type tech or with another newly created contact clID received tech handle replaced with contact at this time no domain rem needed domain rem ns1 TEST PARTNER domain Replace TEST PARTNER with the domain ns 1 ch clID received domain chg TEST PARTNER 1 Replace TEST PARTNER with the domain registrant clID received Expected result Command completed successfully Step 11 Create contact 2 Description Tag Value Comment contact id TEST PARTNER 2 Replace TEST PARTNER with the clID received contact name Lastname2 Firstname2 contact org Organisation2 contact street Testdivision contact street Teststreet 999 contact city Bern contact pc 3001 contact cc CH contact voice 41 335555555 contact email test2 yourdom
6. and lt host crDate gt boxes are only disclosed for name servers administered by the Partner themselves Example of a host info command lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt command gt lt info gt lt host info xmlns host urn ietf params xml ns host 1 0 gt lt host name gt merapi switch ch lt host name gt lt host info gt lt info gt lt c1TRID gt ABC 12345 lt c1TRID gt lt command gt lt epp gt Example of a host check response lt xml version 1 0 encoding UTF 8 gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt response gt lt result code 1000 gt lt msg lang en gt Command completed successfully lt msg gt lt result gt lt resData gt lt host infData xmlns host urn ietf params xml ns host 1 0 gt lt host name gt merapi switch ch lt host name gt lt host roid gt H5734 SWITCH lt host roid gt lt host status s 0k gt lt host status s linked gt lt host addr ip v4 gt 130 59 211 10 lt host addr gt lt host addr ip v6 gt 2001 620 0 0 0 0 0 5 lt host addr gt lt host clID gt SWITCH PARTNER lt host clID gt lt host crID gt NOT SUPPORTED lt host crID gt lt host crDate gt 1999 11 24T14 48 50 01 00 lt host crDate gt lt host infData gt lt resData gt lt trID gt lt c1TRID gt ABC 12345 lt c1TRID gt lt svTRID gt 20071207 92693 285744 lt svTRID gt lt trID gt lt response g
7. clID received Expected result Command completed successfully The contact id is available O SWITCH 2010 Subject to change Page 42 49 Step 6 Create contact 1 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Description Tag Value Comment contact id TEST PARTNER 1 Replace TEST PARTNER with the clID received contact name Lastname Firstname contact org Organisation contact street Testabteilung contact street Teststrasse 999 contact city Bern contact pc 3001 contact cc CH contact voice 41 335555555 contact email test1 yourdomain ch Expected result Command completed successfully Step 7 Create name server 1 Description Tag Value Comment host name ns3 TEST PARTNER domain 1 ch Replace TEST PARTNER with the clID received host addr ip v4 240 1 1 1 Expected result Command completed successfully Step 8 Info domain 1 Description Tag Value Comment domain name TEST PARTNER domain 1 ch Replace TEST PARTNER with the clID received Expected result Command completed successfully The response contains the contact id for the technical contact for the next step Step 9 Info Tech Contact Description Tag Value Comment contact id
8. lt resData gt lt domain trnData xmlns domain urn ietf params xml ns domain 1 0 gt lt domain name gt yourname ch lt domain name gt lt domain trStatus gt serverApproved lt domain trStatus gt lt domain reID gt TEST PARTNER A lt domain reID gt lt domain reDate gt 2007 12 06T16 23 52 01 00 lt domain reDate gt lt domain acID gt TEST PARTNER A lt domain acID gt lt domain acDate gt 2007 12 06T16 23 52 01 00 lt domain acDate gt lt domain trnData gt lt resData gt lt triID gt lt c1TRID gt ABC 12345 lt c1TRID gt lt svTRID gt 20071206 91098 282082 lt svTRID gt lt trID gt lt response gt lt epp gt SWITCH 2010 Subject to change Page 25 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch 4 2 9 domain update Updates are made to the domain name with domain update This command can also be used to generate the transfer code lt domain authInfo gt which is then forwarded to the holder so that the domain name can be transferred If the domain update command does not change any entries in the boxes error code 2308 Data management policy violation will be returned If SWITCH contact IDs are registered at the time the domain update command is submitted because a transfer has taken place beforehand the Partner must enter their own contact IDs with domain update If only the contact ID for the holder is replaced the technical contact rem
9. www nic ch 4 2 2 DNSSEC DNSSEC can be used on an optional basis and is deployed for signing domain names DNSSEC Attribut M Comment alg Y algorithm actually 3 5 6 7 8 10 12 13 14 digestType Y 1 2 30r4 digest Y max 128 characters flags N 256 or 257 protocol N 3 keyTag Y 0 65535 value range pubKey N max 1024 characters M Mandatory Y Yes N No gt e Before a Partner can use DNSSEC it must have been activated for this Partner beforehand s DNSSEC has to be declared at login urn ietf params xml ns secDNS 1 1 e SWITCH does not make delegation checks and does not check if signed domain names are accessible e keyData entries are optional and will be saved in the database if sent e If keyData is used the flags protocol alg and pubKey attributes are mandatory e 1 1 only DS Data Interface is supported 4 2 3 RGP RGP can be used on an optional basis to delete restored domain names e RGP must be declared when logging in urn ietf params xml ns rgp 1 0 e Ifthe domain name belongs to the partner submitting the query the command domain info can be used to enquire whether the domain name is within the redemption period e There is no pendingRestore RGP status If the restore command has been successful then the gt EPP status of the domain name will switch to OK e The optional rgp report element in the rgp restore element is ignored e A separate rgp report command
10. 60 days and is then automatically removed e The Transfer Query command is not required since the transfer will be carried out immediately if the transfer code is valid The server will respond to a Transfer Query command with error code 2101 Unimplemented command e In the case of a bulk Partner transfer from SWITCH to a Partner who uses EPP the transfer codes will be put in the Partner s poll queue e Transferring a DNSSEC signed domain name to a partner who is not using DNSSEC is not possible In such case DNSSEC has to be deactivated first SWITCH 2010 Subject to change Page 24 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Example of a domain transfer command lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt command gt lt transfer op request gt lt domain transfer xmlns domain urn ietf params xml ns domain 1 0 gt lt domain name gt yourname ch lt domain name gt lt domain authInfo gt lt domain pw gt ABCDEF lt domain pw gt lt domain authInfo gt lt domain transfer gt lt transfer gt lt c1TRID gt ABC 12345 lt c1TRID gt lt command gt lt epp gt Example of a domain transfer response lt epp xmlns urn ietf params xml ns epp 1 0 gt lt response gt lt result code 1000 gt lt msg lang en gt Command completed successfully lt msg gt lt result gt
11. Aa 40 5 TE RE EE ER OE RE EO EE 41 51 ed ie ARE ER EE N Ee 41 5 2 LOGGING ON RE EE OR ER OR EE 41 5 3 Test procedure Ee winced ates RE EG RE EG RO EE AG GN eg Ge RE Ee ee ee bee EE Ke OR De ge 41 6 Ga eli aak el N ER OE EE E E EEEE E R 48 6 1 Web interface for EPP userS sees ee ee ee ese see see ede ee ee ee ee ee ee ee Re Re ee ee ee ee ee ee ee Re AA ee ee ee ee ee ee AR ede ee 48 AppendixA Abbreviations Term RE REEKSE eN ER OR Ee ed ge Deed GE DE be ae Ve Ee ee RS GE Ke SE Ee de 49 1 Management Summary The EPP Protocol Extensible Provisioning Protocol is an international standard for the administration of domain names It allows the information that has to be exchanged between Partners and the registry operator to be sent via a secure and permanent connection EPP allows Partners to integrate the administration of domain names in their existing system This document contains all the information that is required for connecting up the Partner s EPP client to the EPP Server at SWITCH EPP has been implemented extensively according to the international standard the SWITCH specific deviations are specially marked 2 Introduction SWITCH is the office responsible for the registration and administration of the country code Top Level Domain Names ccTLDs for Switzerland ch and Liechtenstein li One of the main tasks this involves is the registration of second level domain names under these ccTLDs which will simply be
12. EPP server only allows connections from clients whose IP addresses are registered at SWITCH e Only DNSSEC 1 1 is supported e In using DNSSEC extensions it is required that the partner has been DNSSEC enabled Otherwise he will receive an error message after login 4 1 2 logout The EPP client must end its session with the Logout command Example of a logout command lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt epp command xmlns epp urn ietf params xml ns epp 1 0 gt lt epp logout gt lt epp clTRID gt ABC 27 lt epp clTRID gt lt epp command gt lt epp gt Example of a logout response lt xml version 1 0 encoding UTF 8 gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt response gt lt result code 1500 gt lt msg lang en gt Command completed successfully ending session lt msg gt lt result gt lt triID gt lt c1TRID gt ABC 27 lt c1TRID gt lt svTRID gt 20071008 13747 27299 lt svTRID gt lt trID gt lt response gt lt epp gt SWITCH 2010 Subject to change Page 10 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch 4 1 3 hello The EPP client can use the hello command to see whether the EPP session is still active This command can also be used to prevent the session from being ended because it has been inactive for too long The EPP server answers a
13. P O Box CH 8021 Z rich www nic ch 5 Testing 5 1 General information SWITCH can activate access to the EPP test server epp test switch ch for test purposes The availability of the EPP test server is lower than that of the productive EPP servers As a rule the EPP test server will have the same software version installed on it as the productive EPP server Prior to new software releases the new version will generally be made available on the EPP test server one week before it is installed on the productive EPP server Exceptions to this rule apply in the case of urgent bug fixes security measures or major technical adjustments In such case the one week period changes or a new transition period will be set Before SWITCH activates the EPP interface to the productive environment epp nic ch for a Partner to use the test procedure described below must have been successfully completed A test period must be agreed on with SWITCH for conducting the test In addition to this the provisions set out in Reference 6 apply 5 2 Logging on Special contact IDs for Partners cllDs are available on the test system which are activated for a specific period of time In the following test procedure the value TEST PARTNER must be replaced by one of the clIDs allocated either TEST PARTNER A TEST PARTNER B or TEST PARTNER C 5 3 Test procedure The individual commands are to be worked through in the order shown Afte
14. all DS records that contain enclosed attributes will be deleted lt extension gt lt secDNS update xmlns secDNS urn ietf params xml ns secDNS 1 1 gt lt secDNS rem lt secDNS dsData gt lt secDNS keyTag gt 12346 lt secDNS keyTag gt lt secDNS alg gt 3 lt secDNS alg gt lt secDNS digestType gt 1 lt secDNS digestType gt lt secDNS digest gt 38EC35D5B3A34B4 4C39B lt secDNS digest gt lt secDNS dsData gt lt secDNS rem gt lt secDNS update gt lt extension gt Page 27 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Example of a domain update command with an RGP restore request lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt command gt lt update gt lt domain update xmlns domain urn ietf params xml ns domain 1 0 gt lt domain name gt yourname ch lt domain name gt lt domain chg gt lt domain update gt lt update gt lt extension gt lt rgp update xmlns rgp urn ietf params xml ns rgp 1 0 xsi schemaLocation urn ietf params xml ns rgp 1 0 rgp 1 0 xsd gt lt rgp restore op request gt lt rgp update gt lt extension gt lt clTRID gt Test3 lt clTRID gt lt command gt lt epp gt Example of a domain update response lt xml version 1 0 encoding UTF 8 gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt response gt lt result c
15. ends with ch or li Valid internal name server An internal name server of a registered superordinate domain name Invalid internal name server An internal name server of a non registered superordinate domain name Partner An Internet Service Provider with a Partner Agreement signed by SWITCH Registrant End customer who owns a domain name Registrar International designation for Partners Registry Organisation that acts as the registry for second level domain names Transfer Transferring the administrative rights to a domain name to another Partner TLS Transport Layer Security security protocol for internet connections employing a certificate Holder transfer The domain name is allocated to a different holder i e to another natural or legal person SWITCH 2010 Subject to change Page 49 49
16. leads to an error since there is no pendingRestore SWITCH 2010 Subject to change Page 17 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch 4 2 4 domain check Using domain check it is possible to check whether domain names exist The server will reply with registered not registered Bulk queries are only permitted to a limited extent as per Reference 06 gt A maximum of 10 domain names can be queried at a time in an individual command otherwise the server will answer with error code 2308 Data management policy violation Example of a domain check command lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt command gt lt check gt lt domain check xmlns domain urn ietf params xml ns domain 1 0 gt lt domain name gt yourname ch lt domain name gt lt domain name gt yourname 1li lt domain name gt lt domain name gt studen be ch lt domain name gt lt domain name gt fuerstentum li lt domain name gt lt domain check gt lt check gt lt c1TRID gt ABC 12345 lt c1TRID gt lt command gt lt epp gt Example of a domain check response lt epp xmlns urn ietf params xml ns epp 1 0 gt lt response gt lt result code 1000 gt lt msg lang en gt Command completed successfully lt msg gt lt result gt lt resData gt lt domain chkData xmlns domain urn ietf params xml ns do
17. lt host crDate gt 2007 12 07T14 40 04 01 00 lt host crDate gt lt host creData gt lt resData gt lt triID gt lt c1TRID gt ABC 12345 lt c1TRID gt lt svTRID gt 20071207 92694 285749 lt svTRID gt lt trID gt lt response gt lt epp gt 4 4 5 host transfer No provision is made for this command in Reference 03 and it will be rejected with error code 2000 Valid internal name servers belong to the holder of the corresponding domain name The name servers are transferred together with the domain name 4 4 6 host delete The host delete command is used to delete name servers Name servers may only be deleted if they are no longer referenced in the registration system if no domain name points to the name server SWITCH 2010 Subject to change Page 39 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Example of a host delete command lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt command gt lt delete gt lt host delete xmlns host urn ietf params xml ns host 1 0 gt lt host name gt nsl yourname ch lt host name gt lt host delete gt lt delete gt lt c1TRID gt ABC 12345 lt c1TRID gt lt command gt lt epp gt Example of a host delete response lt xml version 1 0 encoding UTF 8 gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt response gt lt result co
18. name is not registered It is permitted to register an invalid internal name server An invalid internal name server may only be allocated to the superordinate domain name thus making it into a valid internal name server If a domain name yourname ch is deleted the subordinate name servers ns1 yourname ch continue to exist If the domain name is re registered again later these name servers automatically belong to the holder of the new domain name External name servers such as ns1 yourname com for example can be registered and belong to the registry O SWITCH 2010 Subject to change Page 36 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Host attribute M U whois Comment Name Y N Y Roid Y N N Hnnnnnnnn SWITCH supplied by the registry Status Y N N clID Y N N Set by the registry crID NOT SUPPORTED crDate N N Set by the registry uplD This is omitted update N N This is omitted trDate N N This is omitted 4 4 2 host check With host check it is possible to check whether name servers exist The server will reply with registered not registered Bulk queries are only permitted to a limited extent as per Reference 06 gt e A maximum of 10 hosts can be queried at a time with host check otherwise the server will answer with error code 2308 Data management policy violation Example of a host ch
19. referred to as domain names in what follows SWITCH 2010 Subject to change Page 3 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch 2 1 EPP standard legal fundaments This Manual is based on the following documents Detailed examples of EPP commands are given in the RFCs listed below eke 01 RFC 5730 Extensible Provisioning Protocol EPP http Awww ietf org rfc rfc5730 txt 02 RFC 5731 Extensible Provisioning Protocol EPP Domain Name Mapping http www ietf org rfc rfc5731 txt 03 RFC 5732 Extensible Provisioning Protocol EPP Host Mapping http www ietf org rfc rfc5732 txt 04 RFC 5733 Extensible Provisioning Protocol EPP Contact Mapping http www ietf org rfc rfc5733 txt 05 RFC 5734 Extensible Provisioning Protocol EPP Transport Over TCP http www etf org rfc rfc5 734 txt 06 SWITCH Partner Agreement including Annexes 07 General Terms and Conditions GTCs for the registration and administration of domain names under ch and li The latest version is always available at www nic ch 08 RFC 5910 Domain Name System DNS Security Extensions Mapping for the Extensible Provisioning Protocol EPP http www ietf org rfc rfc5910 txt 09 RFC 3915 EPP Grace Period Mapping Redemption Grace Period RGP http www ietf org rfc rfc391 5 txt 10 RFC 3735 Guidelines on extending EPP http www ietf org rfc r
20. rem gt lt domain chg gt lt domain authInfo gt lt domain pw gt 2BARfoo lt domain pw gt lt domain authInfo gt lt domain chg gt lt domain update gt lt update gt lt c1TRID gt TeSt3 lt c1TRID gt lt command gt lt epp gt O SWITCH 2010 Subject to change SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch DNSSEC Estension adding DNSSEC data lt extension gt lt secDNS update xmlns secDNS urn ietf params xml ns secDNS 1 1 gt lt secDNS add lt secDNS dsData gt lt secDNS keyTag gt 12346 lt secDNS keyTag gt lt secDNS alg gt 3 lt secDNS alg gt lt secDNS digestType gt 1 lt secDNS digestType gt lt secDNS digest gt 38EC35D5B3A34B4 4C39B lt secDNS digest gt lt secDNS dsData gt lt secDNS add gt lt secDNS update gt lt extension gt replace DNSSEC data all existing DS records will be replaced lt extension gt lt secDNS update xmlns secDNS urn ietf params xml ns secDNS 1 1 gt lt secDNS rem gt lt secDNS all gt true lt secDNS all gt lt secDNS rem gt lt secDNS add lt secDNS dsData gt lt secDNS keyTag gt 12346 lt secDNS keyTag gt lt secDNS alg gt 3 lt secDNS alg gt lt secDNS digestType gt 1 lt secDNS digestType gt lt secDNS digest gt 38EC35D5B3A34B4 4C39B lt secDNS digest gt lt secDNS dsData gt lt secDNS add gt lt secDNS update gt lt extension gt remove DNSSEC data
21. result Command completed successfully SWITCH 2010 Subject to change Page 46 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Step 20 Update contact 2 All the values not mentioned should remain unchanged Description Tag Value Comment contact id TEST PARTNER 2 Replace TEST PARTNER with the clID received contact chg contact org Empty contact chg contact addr contact street New Division contact chg contact addr contact street Teststreet 999 previous value Expected result Command completed successfully Step 21 Delete domain 1 Description Tag Value Comment domain name TEST PARTNER domain 1 ch Replace TEST PARTNER with the clID received Expected result Command completed successfully Step 22 Update domain 2 with authinfo Description Tag Value Comment domain name TEST PARTNER domain 2 ch Replace TEST PARTNER with the clID received domain chg domain authInfo domain pw 2BARfoo Expected result Command completed successfully Step 23 Logout Expected result successfully completed ending session SWITCH 2010 Subject to change Page 47 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch 6 Further inf
22. server unique on the EPP server and contain at least one ASCII upper case letter Numbers and hyphens are permitted SWITCH 2010 Subject to change Page 34 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Example of a contact update command lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt command gt lt update gt lt contact update xmlns contact urn ietf params xml ns contact 1 0 gt lt contact id gt TEST PARTNER C 5 lt contact id gt lt contact chg gt lt contact postalInfo type loc gt lt contact org gt lt contact addr gt lt contact street gt 124 Example Dr lt contact street gt lt contact street gt Suite 200 lt contact street gt lt contact city gt Dulles lt contact city gt lt contact sp gt VA lt contact sp gt lt contact pc gt 20166 6503 lt contact pc gt lt contact cc gt US lt contact cc gt lt contact addr gt lt contact postalinfo gt lt contact voice gt 1 7034444444 lt contact voice gt lt contact fax gt lt contact authInfo gt lt contact pw gt lt contact authInfo gt lt contact chg gt lt contact update gt lt update gt lt cl1TRID gt freechoice lt clTRID gt lt command gt lt epp gt Example of a contact update response lt xml version 1 0 encoding UTF 8 gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt response g
23. 1 lt domain registrant gt lt domain contact type tech gt 5527981 lt domain contact gt lt domain ns gt lt domain hostObj gt ns1 yourname ch lt domain hostObj gt lt domain hostObj gt ns2 yourname ch lt domain hostObj gt lt domain ns gt lt domain clID gt 3703709 lt domain clID gt lt domain exDate gt 2009 01 31T00 00 00 01 00 lt domain exDate gt lt domain authInfo gt lt domain pw gt foo Bar lt domain pw gt lt domain authInfo gt lt domain infData gt lt resData gt lt extension gt lt rgp infData xmlns rgp urn ietf params xml ns rgp 1 0 xsi schemaLocation urn ietf params xml ns rgp 1 0 rgp 1 0 xsd gt lt rgp rgpStatus s redemptionPeriod gt lt rgp infData gt lt extension gt lt trID gt lt c1TRID gt ABC 12345 lt c1TRID gt lt svTRID gt 20080529 27664 913190 lt svTRID gt lt trID gt lt response gt lt epp gt Query about a domain name administered by the Partner who is submitting the query SWITCH 2010 Subject to change Page 20 49 4 2 6 domain create SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch domain create is used to register domain names Prior to this all the contacts the holder and the technical contact must have been entered if they do not already exist Name servers must also be registered beforehand so that they can be allocated to the domain name gt e lt admin gt not supported e lt bill
24. 4 1 Protocol commands In addition to what is set out below the protocol commands are described in detail in Reference 1 4 1 1 login An EPP session is set up by means of a a TLS connection to the EPP server and b a subsequent successful login with the EPP 1ogin command The EPP server acknowledges the successful establishment of the TLS connection with a greeting After the connection has been set up the client still has to sign on with the login command The EPP server then sends an EPP response Code 1000 means that the EPP session has been successfully established After a successful login the EPP response will say how many messages are waiting in the poll queue and what the first message is about Until the EPP client has sent a login only hello is supported The EPP login password can also be altered at the same time as the Login command is submitted lt pw gt old password lt pw gt lt newPW gt new password lt newPW gt The EPP login password must be 10 16 characters in length Particular attention should be paid to the provisions of the GTCs when it comes to the careful selection of passwords and to keeping passwords safe and confidential Example of a login command lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt DNSSEC Extension lt command gt lt login gt lt clID gt YOUR CLID lt clID gt svcExtension gt lt pw gt ABCDEF lt pw gt lt extUR
25. Ge ee ee ee ee ee Ee Re Re ee ee ee ee ea ee Ee Re Re ee ee ee 21 426 domaindelete us il ye ee wad ga VEE dds dad Ve be Dee N ERG Eed 22 RA OE ORE OE ER EE RE OR ER N EN 22 428 domainupdate sesse ERA ee eee ee Ee AR Ee AA ee ee ee ee ee Ee Re Re ee ee ee ee ea ee AR AA ee ee ee 26 4 3 Contact command eses Ge RE ed ae OS Kees Ee SR Ai ORE cages Re ede ES EE ER ee des GE ede 29 4 31 General information EER ESE EERS Re ES ER Ee Re GEN RE ROES EE ee RE De GEN See ee ee ee Deep ie 29 NT ees ee ee EE Ee Re AA Ee ee EA Re AA ee ee ee ee ee Ee Re Re ee ee ee ee ee Ee Re AA ee ee ee 30 A33 Ee AI N OE IE id 31 434 contact ereat a SR a Re ee GR Ee Ese Ee SR oe ee Ee ee aia 32 4 3 5 contactdelete cee 33 43 6 Contacts iii EERS RE ENE Ee ees Ge Se De ESE GEN Ge Ee AS SE ide ede Ge ee REM de 34 43 7 veoniactupdale ic SR ERROR ee GER Ke RR GERS ROES EE Gr ee be De GES bee sees gee loaner 34 4 4 AS nrn rr tnt tn ttrt ttt tttEE EEEE SESESEEEESESEEEEEEEEEEEEEEEEEEEEEEEEEE EERENS REENE EEE EEEE 36 AAA General MfOMatON AE EE EE coa 36 AAD NOSE CHECK AA a EE RE RE RE RE EN 37 EE EL GE OE a EE AE N 38 444 Ee EE OE EE OE RE ER 39 SWITCH 2010 Subject to change Page 2 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch 44 5 hostianster iss ER A e AG yb 39 AAO EE EE OE OR RE aii 39 44 7 hostupdate ss sesse ee ee ee ee ee AA AA AA AA ER ER ER EE ee ee ee ee ee ee ee ee ee ee ee ee ee AA AA
26. I gt urn ietf params xml ns secDNS 1 1 lt extURI gt lt svcExtension gt lt options gt lt version gt 1 0 lt version gt lt lang gt en lt lang gt lt options gt lt svcs gt lt objURI gt urn ietf params xml ns domain 1 0 lt objURI gt lt objURI gt urn ietf params xml ns contact 1 0 lt objURI gt lt objURI gt urn ietf params xml ns host 1 0 lt objURI gt lt svcs gt lt login gt lt c1TRID gt ABC 1 lt c1TRID gt lt command gt RGP Zusatz lt epp gt lt svcExtension gt lt extURI gt urn ietf params xml ns rgp 1 0 lt extURI gt lt svcExtension gt SWITCH 2010 Subject to change Page 9 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Example of a login response lt xml version 1 0 encoding UTF 8 gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt response gt lt result code 1000 gt lt msg lang en gt Command completed successfully lt msg gt lt result gt lt msgQ count 1 id 1139047 gt lt qDate gt 2007 09 26T00 00 00 02 00 lt qDate gt lt msg gt Domain transfercode lt msg gt lt msgQ gt lt triID gt lt c1TRID gt ABC 1 lt c1TRID gt lt svTRID gt 20071008 13747 27297 lt svTRID gt lt trID gt lt response gt lt epp gt TEST PARTNER A has an unacknowledged message in the poll queue gt e The EPP server epp nic ch is accessed with a TLS connection via Port 700 e The
27. SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch EPP Manual Version 2 1 2 with DNSSEC and RGP November 7 2013 SWITCH SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Contents 1 ET Eie EE OE EE EE N 3 VG Gee te es RE RE RE ER OR N EE EN EN Ee 3 2 1 EPP standard legal fundamente soroeensis ee ger eke Ge de Gie de ge eb Eg Se De eN SERE daa 4 22 oe oo AR AO RE EE OE N 4 3 UWsingithe EPP interlace i s esse eed dd be Dee ve ia bd 6 3 1 Options offered by the EPP interface oe ccc ee ee ees se ee ee ee ee ee ee Ge ee ee ee AA ee ee ee ee ee ee 6 3 2 SWITCH specific general points ii se se ee Re Ee ee GE ee Ee Re AA ee ee ee ee ee ee AR AA de ee ee ee ee ee ee Ee Re 7 343 SESSION Ended vsere el ER De Se Ee Re Ee uci E ee te xen el RS ee Ee oe ee ee ee De ee ee de 8 4 EPPcOmmandS suis a Ge A ge eed Ga id N Oe Ee EE kes GR eke eg 8 4 1 see Koei De RO RA ra EE EE EN 9 AVA ee ER OE N EE OE OE ER EE N 9 PA eel AE EE EE E EE NE due TE E A E A E E E 10 4 1 3 Meal cid EE EE RE EE EE RTN 11 EN N OR RUE RE OE RA EE eaers 11 4 2 DOMAIN COMMANGS iis iss ER be oe bos ee A oe Ge GR GE ba saddens dane 16 4 2 1 EI EN et Ge RE EE EE RE EE OE 16 4 22 ide ER RE RA RA EE RE EO iae 17 42 3 domaimch ek is EE ER Ge ed N ee Bg pests EE ii did 18 EE el EE OG EE RE EE EE 19 425 domaincreate sesse Re RA ee Ee ee ee ee ee EA Re AA
28. age 31 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch 4 3 4 contact create contact create is used to generate contact IDs Each Partner has to generate and update their own contact IDs for the domain names they administer This is particularly important in the case of a transfer since no updates can be made to a domain name before the Partner has entered their own contact IDs gt e lt contact postalInfo type loc gt Only the address type loc localized is supported The address type int international 7 bit ASCII characters is not permitted A command with this address type will be rejected If attributes with type int and type loc are submitted at the same time the address type with type int will be ignored e lt contact street gt An address can have up to three lines for the street address but must contain at least one lt contact street gt element If there is a PO Box this should be entered in this element e lt contact disclose gt is not supported e lt contact email gt The holder s e mail address must be specified under contacts The Partner s e mail address must not be entered in this box e lt contact pw gt is not used by SWITCH and is not saved Authentication is performed during the EPP login e lt contact id gt must be server unique on the EPP server and contain at least one ASCII upper case letter Numbers and hyphens are permitted
29. ain ch Expected result Command completed successfully SWITCH 2010 Subject to change Page 44 49 Step 12 Delete domain 1 for a holder transfer SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Description Tag Value Comment domain name TEST PARTNER domain 1 ch Replace TEST PARTNER with the clID received Expected result Command completed successfully Step 13 Create domain 1 Description Tag Value Comment domain name TEST PARTNER domain 1 ch Replace TEST PARTNER with the clID received domain hostObj ns2 TEST PARTNER domain 1 ch Replace TEST PARTNER with the clID received domain hostObj ns3 TEST PARTNER domain 1 ch Replace TEST PARTNER with the clID received domain registrant TEST PARTNER 2 Replace TEST PARTNER with the clID received Expected result Command completed successfully Step 14 Delete contact 1 Description Tag Value Comment contact id TEST PARTNER 1 Replace TEST PARTNER with the clID received Expected result Command completed successfully Step 15 Delete name server 1 Description Tag Value Comment host name ns1 TEST PARTNER domain 1 ch Replace TEST PARTNER with the clID received Expected result Command completed successful
30. ains empty Any technical contact in the box will be deleted gt lt admin gt and lt billing gt are ignored lt domain authInfo gt the transfer code must comply with the following rules e 6 60 characters character sets as per Paragraph 3 2 No blank spaces commas or semicolons Transferring domain names to other holders the direct transfer of a domain name by updating the holder is prohibited on legal grounds It is however possible for a domain name to be deleted and then registered again by the same Partner for another person or organisation see Paragraph 4 2 5 The transition period as per Reference 6 ensures that the domain name cannot be registered by any other Partners or end customers The partner must perform the registration for the new holder straightaway SWITCH 2010 Subject to change Page 26 49 Example of a domain update command lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt command gt lt update gt lt domain update xmlns domain urn ietf params xml ns domain 1 0 gt lt domain name gt yourname ch lt domain name gt lt domain add gt lt domain ns gt lt domain hostObj gt ns yourns ch lt domain hostObj gt lt domain ns gt lt domain contact type tech gt NEWTECHCONTACT lt domain contact gt lt domain add gt lt domain rem gt lt domain contact type tech gt OLDTECHCONTACT lt domain contact gt lt domain
31. code 1000 gt lt msg lang en gt Command completed successfully lt msg gt lt result gt lt trID gt lt c1TRID gt ABC 12345 lt c1TRID gt lt svTRID gt 20071207 92657 285565 lt svTRID gt lt trID gt lt response gt lt epp gt 4 3 6 contact transfer The contact transfer command is not supported and is rejected with error code 2101 4 3 7 contact update contact update is used to update contact IDs The conditions that apply here are the same as for contact create The lt contact addr gt address can only be updated as an entire block gt e lt contact postalInfo type loc gt Only the loc localized address type is supported The int international address type 7 bit ASCII characters is not permitted A command with this address type will be rejected If attributes with type int and type loc are sent at the same time the address type with type int will be ignored e lt contact street gt An address can have up to three lines for the street address but must contain at least one lt contact street gt element If there is a PO Box this should be entered in this element e lt contact disclose gt is not supported e lt contact email gt The holder s e mail address must be specified under contacts The Partner s e mail address must not appear in this box e lt contact pw gt is not used by SWITCH and is not saved Authentication is performed during the EPP login e lt contact id gt must be
32. contact 1 0 gt lt contact cd gt lt contact id avail 1 gt AVAILABLE CONTACT ID lt contact id gt lt contact cd gt lt contact cd gt lt contact id avail 0 gt NOT AVAILABLE CONTACT ID lt contact id gt lt contact reason gt In use lt contact reason gt lt contact cd gt lt contact chkData gt lt resData gt lt triID gt lt c1TRID gt ABC 12345 lt c1TRID gt lt svTRID gt 20071207 92655 285552 lt svTRID gt lt trID gt lt response gt lt epp gt SWITCH 2010 Subject to change Page 30 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch 4 3 3 contact info The contact info command is used to request information on contacts The lt contact email gt box is only disclosed for contacts administered by the Partner who has submitted the query gt Not supported is always returned for Contact password Example of a contact info command lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt command gt lt info gt lt contact info xmlns contact urn ietf params xml ns contact 1 0 gt lt contact id gt TEST PARTNER C 5 lt contact id gt lt contact info gt lt info gt lt c1TRID gt ABC 12345 lt c1TRID gt lt command gt lt epp gt Example of a contact info response lt xml version 1 0 encoding UTF 8 gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt
33. ct Y Y Y create Creates a new object Y Y Y delete Deletes an object Y Y Y renew Renews an object x 7 transfer Transfers an object Y x implicit update Updates the data for an object Y Y Y Y implemented x not implemented implicit this command is not provided for in EPP 3 2 SWITCH specific general points Under the terms of Reference 01 all EPP commands are atomic and are either processed in full or rejected in full If an EPP command is submitted twice the second command will also be processed once again If a domain name was already registered the first time the command was submitted an error message will be issued the second time the same domain name is submitted When requesting information on an object contact domain and host the data authorised for publication by the Swiss Decree on Addressing Resources in the Telecommunications Sector AEFV Art 14h will be returned unless the EPP user is authorised to see further information under the terms of the Partner Agreement e g the expiry date of a domain name for the managing partner SWITCH 2010 Subject to change Page 7 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch In general any information that is not mandatory and is not used which the EPP user submits will be ignored gt A status allocated to objects by the EPP client is not supported such as lt clientDeleteProhibited gt lt clientTra
34. de 1000 gt lt msg lang en gt Command completed successfully lt msg gt lt result gt lt trID gt lt c1TRID gt ABC 12345 lt c1TRID gt lt svTRID gt 20071210 94223 292958 lt svTRID gt lt trID gt lt response gt lt epp gt 4 4 7 host update Example of a host update command lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt command gt lt update gt lt host update xmlns host urn ietf params xml ns host 1 0 gt lt host name gt ns1 yourns ch lt host name gt lt host add gt lt host addr ip v4 gt 192 0 2 22 lt host addr gt lt host add gt lt host rem gt lt host addr ip v6 gt 1080 0 0 0 8 800 200C 417A lt host addr gt lt host rem gt lt host update gt lt update gt lt c1TRID gt ABC 12345 lt c1TRID gt lt command gt lt epp gt Example of a host update response lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt response gt lt result code 1000 gt lt msg gt Command completed successfully lt msg gt lt result gt lt trID gt lt c1TRID gt ABC 12345 lt c1TRID gt lt svTRID gt 20100112 436723 6100466 lt svITRID gt lt trID gt lt response gt lt epp gt The name of a name server cannot be updated via the EPP interface SWITCH 2010 Subject to change Page 40 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2
35. eck command lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt command gt lt check gt lt host check xmlns host urn ietf params xml ns host 1 0 gt lt host name gt merapi switch ch lt host name gt lt host name gt ns2 example com lt host name gt lt host check gt lt check gt lt Cc1TRID gt ABC 12345 lt c1TRID gt lt command gt lt epp gt O SWITCH 2010 Subject to change Page 37 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Example of a host check response lt xml version 1 0 encoding UTF 8 gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt response gt lt result code 1000 gt lt msg lang en gt Command completed successfully lt msg gt lt result gt lt resData gt lt host chkData xmlns host urn ietf params xml ns host 1 0 gt lt host cd gt lt host name avail 0 gt merapi switch ch lt host name gt lt host reason gt In use lt host reason gt lt host cd gt lt host cd gt lt host name avail 1 gt ns2 example com lt host name gt lt host cd gt lt host chkData gt lt resData gt lt triD gt lt c1TRID gt ABC 12345 lt c1TRID gt lt svTRID gt 20071207 92693 285743 lt svTRID gt lt trID gt lt response gt lt epp gt 4 4 3 host info host info is used to request information on name servers The lt host clID gt lt host crID gt
36. epp gt SWITCH 2010 Subject to change Page 15 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch 4 2 Domain commands 4 2 1 General information In addition to what is set out below the domain commands are described in detail in Reference 1 The holder of a domain name is saved in the domain registrant box The domain name transfer code may only be given to the holder of the domain name gt e Each domain name can be optionally allocated a maximum of one type tech contact Mention is made of a renew command in the EPP specification This is not implemented since a renew is performed by the server A renew is rejected with error code 2101 unimplemented command Domain attribute whois Comment name Y N Y roid Y N N Dnnnnnnnn SWITCH supplied by the registry status N N N registrant Y Y Y contact id contact type tech N Y Y contact id hostObj N Y Y clID Y N N Set by the registry crID This is omitted crDate Set by the registry exDate Set by the registry uplD This is omitted upDate This is omitted trDate This is omitted authinfo Blank spaces and are not permitted M Mandatory U Update possible Y Yes N No SWITCH 2010 Subject to change Page 16 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich
37. esult gt lt resData gt lt contact creData xmlns contact urn ietf params xml ns contact 1 0 gt lt contact id gt TEST PARTNER C 5 lt contact id gt lt contact crDate gt 2007 12 07T11 29 51 01 00 lt contact crDate gt lt contact creData gt lt resData gt lt triID gt lt c1TRID gt Test2 lt c1TRID gt lt svTRID gt 20071207 944 74886 lt svTRID gt lt trID gt lt response gt lt epp gt 4 3 5 contact delete Using contact delete it is possible to delete contact IDs insofar as they are not linked to anything do not have the status linked Only contact IDs administered by the Partner themselves can be deleted The Partner must delete any of their contact IDs that are no longer in use Example of a contact delete command lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt command gt lt delete gt lt contact delete xmlns contact urn ietf params xml ns contact 1 0 gt lt contact id gt TEST PARTNER C 6 lt contact id gt lt contact delete gt lt delete gt lt c1TRID gt ABC 12345 lt c1TRID gt lt command gt lt epp gt O SWITCH 2010 Subject to change Page 33 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Example of a contact delete response lt xml version 1 0 encoding UTF 8 gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt response gt lt result
38. fc3915 txt gt e This symbol denotes important SWITCH specific technical deviations from the international EPP standard The Partner Agreement and its Annexes always take precedence over this User Manual 2 2 Conditions of use The following conditions must be fulfilled for regular operation of the EPP interface SWITCH 2010 Subject to change Page 4 49 Assigned and valid Partner Agreement SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch An IP address for your EPP client that has been activated by SWITCH e A successfully completed test run see Paragraph 5 3 O SWITCH 2010 Subject to change Page 5 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch 3 Using the EPP interface An EPP client with a TLS connection is essential for using the EPP interface Before a TLS connection can be established the IP address of the EPP client must already have been activated by SWITCH Once the TLS connection has been established only the EPP commands of login and hello are permitted to begin with All other EPP commands are only possible after a successful login SWITCH does not offer a standard EPP client or an EPP library Any EPP client can be used that satisfies the referenced standards as per Paragraph 2 1 In addition to the standard RFC an EPP client must be configured in accordance with the provisions of this Manua
39. he query Example of a domain info command lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt command gt lt info gt lt domain info xmlns domain urn ietf params xml ns domain 1 0 gt lt domain name gt yourname ch lt domain name gt lt domain info gt lt info gt lt c1TRID gt ABC 12345 lt c1TRID gt lt command gt lt epp gt Example of a domain info response lt xml version 1 0 encoding UTF 8 gt lt epp as eee ee een epp 1 0 gt For DNSSEC signed domain names lt response gt lt result code 1000 gt lt extension gt lt msg lang en gt Command completed successfully lt msg gt lt secDNS infData lt result gt xmlns secDNS urn ietf params xml ns secDNS 1 1 gt lt resData gt lt dsData xmlns urn ietf params xml ns secDNS 1 1 gt lt domain infData xmlns domain urn ietf params xml ns lt keyTag gt 43837 lt keyTag gt domain 1 0 gt lt alg gt 5 lt alg gt lt domain name gt yourname ch lt domain name gt lt digestType gt 2 lt digestType gt lt domain roid gt D2586061 SWITCH lt domain roid gt lt digest gt 838C3D0966B9EE55 lt digest gt lt domain status s ok gt lt keyData gt lt domain registrant gt 5527981 lt domain registrant gt lt flags gt 257 lt flags gt lt domain contact type tech gt 5527981 lt domain contact gt lt protocol gt 3 lt protocol gt lt domain ns gt lt alg gt 5 lt alg gt lt do
40. hello command with the greeting Example of a hello command lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt hello gt lt epp gt Example of a hello response greeting lt xml version 1 0 encoding UTF 8 gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt greeting gt lt svID gt SWITCH_ EPP Server lt svID gt lt svDate gt 2007 10 09T08 44 14 02 00 lt svDate gt lt svcMenu gt lt version gt 1 0 lt version gt lt lang gt en lt lang gt lt objURI gt urn ietf params xml ns domain 1 0 lt objURI gt lt objURI gt urn ietf params xml ns contact 1 0 lt objURI gt lt objURI gt urn ietf params xml ns host 1 0 lt objURI gt lt svcExtension gt lt extURI gt urn ietf params xml ns secDNS 1 1 lt extURI gt lt svcExtension gt lt svcMenu gt lt dcp gt lt access gt lt personalAndOther gt lt access gt lt statement gt lt purpose gt lt admin gt lt other gt lt prov gt lt purpose gt lt recipient gt lt ours gt lt public gt lt recipient gt lt retention gt lt legal gt lt retention gt lt statement gt lt dcp gt lt greeting gt lt epp gt 4 1 4 poll The messages in the poll queue must be retrieved one after the other and acknowledged As soon as the first message has been acknowledged the second one can be retrieved etc Messages that have been acknowledged are deleted from the
41. ing gt not supported the Partner is always the billing contact Example of a domain create command lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt command gt lt create gt lt domain create xmlns domain urn ietf params xml ns domain 1 0 gt lt domain name gt yourname ch lt domain name gt lt domain ns gt lt domain hostObj gt nsl yourname ch lt domain hostObj gt lt domain hostObj gt ns2 yourname ch lt domain hostObj gt lt domain ns gt lt domain registrant gt HOLDERCONTACT lt domain registrant gt lt domain contact type tech gt TECHCONTACT lt domain contact gt lt domain authInfo gt lt domain pw gt lt domain authInfo gt lt domain create gt lt create DNSSEC Extension lt extension gt lt secDNS create xmlns secDNS urn ietf params xml ns secDNS 1 1 gt lt secDNS dsData gt lt secDNS keyTag gt 12345 lt secDNS keyTag gt lt secDNS alg gt 3 lt secDNS alg gt lt secDNS digestType gt 1 lt secDNS digestType gt lt secDNS digest gt 4 9FD4 6E6C4B45C55 lt secDNS digest gt lt secDNS keyData gt lt secDNS flags gt 256 lt secDNS flags gt lt secDNS protocol gt 3 lt secDNS protocol gt lt secDNS alg gt 3 lt secDNS alg gt lt secDNS pubKey gt TH3PUBL1ICK3Y lt secDNS pubKey gt lt secDNS keyData gt lt secDNS dsData gt lt secDNS create gt lt c1TRID gt ABC 12345 lt c1TRID gt lt command gt
42. ject to change Page 29 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Contact attribute M U whois Comment upDate N N This is omitted trDate N N This is omitted authinfo This is ignored not supported Disclose Error 2308 M Mandatory Y Yes U Update possible N No 4 3 2 contact check The contact check command can be used to check whether contacts actually exist The server replies with registered not registered Bulk queries are permitted as per Reference 06 for the purpose specified there and after consultation with SWITCH Example of a contact check command lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt command gt lt check gt contact check xmlns contact urn ietf params xml ns contact 1 0 gt lt contact id gt AVAILABLE CONTACT 1D lt contact id gt lt contact id gt NOT AVAILABLE CONTACT ID lt contact id gt lt contact check gt lt check gt lt c1TRID gt ABC 12345 lt c1TRID gt lt command gt lt epp gt Example of a contact check response lt xml version 1 0 encoding UTF 8 gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt response gt lt result code 1000 gt lt msg lang en gt Command completed successfully lt msg gt lt result gt lt resData gt lt contact chkData xmlns contact urn ietf params xml ns
43. l and the Partner Agreement including its Annexes The EPP server supports the UTF 8 unicode character set see Paragraph 3 2 Communication between the EPP client and the EPP server takes place by means of commands in XML format The server will immediately send back the corresponding reply Where there are several commands in succession pipelining these will be processed individually waiting until the reply has been sent to the previous command in each case 3 1 Options offered by the EPP interface The EPP interface has two main categories objects and commands actions The objects are domain e contact e host The commands are divided up into protocol commands and object specific commands The following Table gives an overview of the protocol commands Command Description hello Making contact login Logging onto the EPP server logout Logging off from the EPP server poll Retrieving messages from the poll queue on the EPP server this is the route by which the EPP user receives notifications from SWITCH O SWITCH 2010 Subject to change Page 6 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch The following Table gives an overview of the object specific commands Object specific commands domain contact Host check Checks the existence of an object Y Y Y info Supplies information on an obje
44. ly Step 16 Check domain 2 Description Tag Value Comment domain name TEST PARTNER domain 2 ch Replace TEST PARTNER with the clID received Expected result Command completed successfully The domain name is available SWITCH 2010 Subject to change Page 45 49 Step 17 Create domain 2 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Description Tag Value Comment domain name TEST PARTNER domain 2 ch Replace TEST PARTNER with the clID received domain hostObj ns3 TEST PARTNER domain 1 ch Replace TEST PARTNER with the clID received domain registrant TEST PARTNER 2 Replace TEST PARTNER with the clID received Expected result Command completed successfully Step 18 Create name server 2 subordinate of domain 2 Description Tag Value Comment host name ns1 TEST PARTNER domain 2 ch Replace TEST PARTNER with the clID received host addr ip v4 240 1 1 1 Expected result Command completed successfully Step 19 Update domain 1 with ns 2 Description Tag Value Comment domain name TEST PARTNER domain 1 ch Replace TEST PARTNER with the clID received domain add domain ns ns1 TEST PARTNER domain 2 ch Replace TEST PARTNER with the clID received Expected
45. main 1 0 gt lt domain cd gt lt domain name avail 0 gt yourname ch lt domain name gt lt domain reason gt In use lt domain reason gt lt domain cd gt lt domain cd lt domain name avail 1 gt yourname li lt domain name gt lt domain cd gt lt domain cd gt lt domain name avail 0 gt studen be ch lt domain name gt lt domain reason gt City domainname lt domain reason gt lt domain cd gt lt domain cd gt lt domain name avail 0 gt fuerstentum li lt domain name gt lt domain reason gt Legal reasons lt domain reason gt lt domain cd gt lt domain chkData gt lt resData gt lt triID gt lt c1TRID gt ABC 12345 lt c1TRID gt lt svTRID gt 20071009 14301 29655 lt svTRID gt lt trID gt lt response gt lt epp gt SWITCH 2010 Subject to change Page 18 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch 4 2 5 domain info The domain info command is used to have the data for the domain name disclosed with see Paragraph 3 2 In addition to the standard data the lt domain c11D gt box contains the ID of the sponsoring client i e the current Partner s ID Bulk queries are only permitted within the scope and for the purpose set out in Reference 06 The lt domain status gt lt domain exDate gt and lt domain authInfo gt boxes are only disclosed for domain names administered by the Partner who has submitted t
46. main hostObj gt ns1 yourname ch lt domain hostObj gt lt pubKe y gt TH3PUBL1CK3Y lt pubKey gt lt domain hostObj gt ns2 yourname ch lt domain hostObj gt lt keyData gt lt domain ns gt lt dsData gt lt domain clID gt 3703709 lt domain clID gt lt secDNS infData gt lt domain exDate gt 2009 01 31T00 00 00 01 00 lt extension gt lt domain exDate gt lt domain authInfo gt lt domain pw gt foo Bar lt domain pw gt lt domain authInfo gt lt domain infData gt lt resDapa gt lt triD gt lt c 1TRID gt ABC 12345 lt c1TRID gt lt svTRID gt 20080529 27664 913190 lt svTRID gt lt trID gt lt response gt lt epp gt Query about a domain name administered by the Partner who is submitting the query SWITCH 2010 Subject to change Page 19 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Example of a domain info response with redemptionPeriod status lt xml version 1 0 encoding UTF 8 gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt response gt lt result code 1000 gt lt msg lang en gt Command completed successfully lt msg gt lt result gt lt resData gt lt domain infData xmlns domain urn ietf params xml ns domain 1 0 gt lt domain name gt yourname ch lt domain name gt lt domain roid gt D2586061 SWITCH lt domain roid gt lt domain status s pendingDelete gt lt domain registrant gt 552798
47. n infData gt lt epp resData gt lt triID gt lt clTRID gt Partner_00_2 lt clTRID gt lt svTRID gt 20071008 13688 27039 lt svTRID gt lt trID gt lt response gt lt epp gt 4 1 4 3 Transfercode Reject message This message is placed in the future Partner s poll queue for a bulk Partner transfer if the holder has rejected a transfer Attribute Comment domain name Domain name domain roid Dnnnnnnnn SWITCH domain clID contact id of the current Partner SWITCH 2010 Subject to change Page 14 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Example of a bulk transfer code reject message lt xml version 1 0 encoding UTF 8 gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt response gt lt result code 1301 gt lt msg gt Command completed successfully ack to dequeue lt msg gt lt result gt lt msgQ count 1 id 1139047 gt lt qDate gt 2007 09 26T00 00 00 02 00 lt qDate gt lt msg gt Domain transfer rejected lt msg gt lt msgQ gt lt resData gt lt domain infData gt lt domain name gt yourname ch lt domain name gt lt domain roid gt D12345678 SWITCH lt domain roid gt lt domain clID gt SWITCH PARTNER lt domain clID gt lt domain infData gt lt resData gt lt trID gt lt c1TRID gt Partner_00_2 lt c1TRID gt lt svTRID gt 20071008 13688 27039 lt svTRID gt lt trID gt lt response gt lt
48. nsferProhibited gt etc e Each partner is allowed to connect to the EPP server with maximally three sessions simultaneously e In general the following UTF 8 characters are supported e Basic Latin U 0020 U 007E e Latin 1 Supplement U 00AE U 00FF U 00A1 U 00AC e Latin Extended A U 0100 U 017F e euro sign U 20AC e Dates are given in local time to the nearest second stating the difference compared with UTC For the example given for summer time below UTC is thus 2007 09 18Z1 2 32 00 Format yyyy mm ddThh mi ss hh mi T instead of Z Summer time 2007 09 18T14 32 00 02 00 Winter time 2007 12 18T13 32 00 01 00 3 3 Session ended An EPP session can be ended by the server for the following reasons e The EPP session has been inactive for more than 3 hours session timeout e The maximum number of unsuccessful EPP commands has been reached e Scheduled or non scheduled maintenance work on the EPP server 4 EPP commands Each Partner has a maximum number of EPP commands per minute available to them On average utilisation this is 100 EPP commands per minute Depending on the load on the registration system SWITCH may dynamically modify this rate Once the maximum number of commands per minute has been achieved the server will delay accepting any further EPP requests SWITCH 2010 Subject to change Page 8 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch
49. ode 1000 gt lt msg lang en gt Command completed successfully lt msg gt lt result gt lt triID gt lt c1TRID gt Test3 lt c1TRID gt lt svTRID gt 20071207 92654 285546 lt svTRID gt lt trID gt lt response gt lt epp gt SWITCH 2010 Subject to change Page 28 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch 4 3 Contact commands 4 3 1 General information In addition to what is set out below the contact commands are described in detail in Reference 3 Only the data permitted by law is published see Paragraph 3 2 The way in which access to other data and data updating is handled is governed by Reference 06 Contact attribute M U Whois Comment ld Y N N Server unique id ASCll upper case letters numbers and supplied by the registrar Roid Y N N Cnnnnnnnn SWITCH supplied by the registry Status Y N N Linked ok serverDeleteProhibited serverUpdateProhibited name type loc Y Y Y Last name First name org type loc N Y Y Street Y Y Y Street N Y Y Street N Y N City Y Y Y Maximum Length 30 signs Sp N Y N Canton Federal State Country Pc N Y Y Cc Y Y Y ISO 3166 1997 Voice N Y N Fax N Y N email Y Y N clID Y N N Set by the registry crID N N Set by the registry crDate N N Set by the registry upID N N This is omitted SWITCH 2010 Sub
50. ormation 6 1 Web interface for EPP users Account statements and other information is available via the web interface Domain names cannot be administered via the web interface Contact keyaccount nic ch SWITCH 2010 Subject to change Page 48 49 Appendix A SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Abbreviations Terms Term Explanation AuthInfo The transfer code that is required to transfer a domain name Bulk Partner Transfer Sending out the transfer codes for all domain names for which the Partner is entered as the billing contact ccTLDs country code Top Level domain names Command Command that can be sent by the EPP client in order to trigger a specific action on the EPP server The actions are allocated to an object domain name name server and contact Contact ID Handle object reference DNSSEC Domain Name System Security Extention EPP Extensible Provisioning Protocol EPP User Partners who communicate with SWITCH via the EPP interface EPP Interface Interface based on the EPP protocol External name server A name server that does not belong to the ccTLD administered by the registration system At SWITCH this is a name server that does not end with ch or li Internal name server A name server that belongs to the ccTLD administered by the registration system At SWITCH this is a name server that
51. poll queue SWITCH 2010 Subject to change Page 11 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Example of a poll command for retrieving a message lt epp xmlns urn ietf params xml ns epp 1 0 gt lt command gt lt poll op req gt lt clTRID gt Partner 00 2 lt cl1TRID gt lt command gt lt epp gt The possible answers can be seen in Paragraphs 4 1 4 1 to 4 1 4 3 Example of a poll command for confirming a message lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt command gt lt poll op ack msgID 1139047 gt lt clTRID gt Partner 00 3 lt cl1TRID gt lt command gt lt epp gt Example of a poll response for confirming a message lt xml version 1 0 encoding UTF 8 gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt response gt lt result code 1000 gt lt msg lang en gt Command completed successfully lt msg gt lt result gt lt msgQ count 0 id 1139047 gt lt triD gt lt clTRID gt Partner 00 3 lt clTRID gt lt svTRID gt 20071008 13689 27043 lt svTRID gt lt trID gt lt response gt lt epp gt 4 1 4 1 Domain Transfer Completed message This message is put in the poll queue of the Partner to date once a domain transfer has been completed Attribute Comment domain name Domain name domain trstatus ServerApproved
52. r each command the response from the EPP server must tally with the expected result Step1 Login and change password Description Tag Value Comment clID TEST PARTNER Test account client identifier Pw dio Initial passwort newPW dd Password chosen by the Partner observing the password rules in Reference 6 Expected result Command completed successfully SWITCH 2010 Subject to change Page 41 49 Step 2 Poll and confirm messages SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Description Tag Value Comment poll op req Extract Msg_ ld Expected result Command completed successfully ack to dequeue The message contains a transfer code for the next step Step 3 Transfer domain 1 Description Tag Value Comment domain name TEST PARTNER domain 1 ch Replace TEST PARTNER with the clID received domain pw Extract value from the message queue Expected result Command completed successfully Step 4 Acknowledge messages Description Tag Value Comment poll op ack msglD nn Extract msglD from the poll op req and insert at nn Expected result Command completed successfully Step 5 Check contact 1 Description Tag Value Comment contact id TEST PARTNER 1 Replace TEST PARTNER with the
53. response gt lt result code 1000 gt lt msg lang en gt Command completed successfully lt msg gt lt result gt lt resData gt lt contact infData xmlns contact urn ietf params xml ns contact 1 0 gt lt contact id gt TEST PARTNER C 5 lt contact id gt lt contact roid gt C10577393 SWITCH lt contact roid gt lt contact status s ok gt lt contact status s linked gt lt contact postalInfo type loc gt lt contact name gt Test User3 lt contact name gt lt contact org gt SWITCH lt contact org gt lt contact addr gt lt contact street gt Test department 3 lt contact street gt lt contact street gt Teststrasse 3 lt contact street gt lt contact city gt Aarau lt contact city gt lt contact pc gt 5000 lt contact pc gt lt contact cc gt CH lt contact cc gt lt contact addr gt lt contact postalinfo gt lt contact voice gt 41 22222555 lt contact voice gt lt contact email gt test2ftestl ch lt contact email gt lt contact clID gt TEST PARTNER C lt contact clID gt lt contact crID gt TEST PARTNER C lt contact crID gt lt contact crDate gt 2007 12 07T10 42 59 01 00 lt contact crDate gt lt contact infData gt lt resData gt lt triD gt lt c1TRID gt ABC 12345 lt c1TRID gt lt svTRID gt 20071207 92656 285558 lt svTRID gt lt trID gt lt response gt lt epp gt Query about a contact administered by the Partner who is submitting the query SWITCH 2010 Subject to change P
54. t lt epp gt SWITCH 2010 Subject to change Page 38 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch 4 4 4 host create The host create command is used to register name servers The authorisations listed under Paragraph 4 4 1 above apply Anyone is entitled to create external and invalid internal name servers Valid internal name servers can only be set up by the Partner who administers the superordinate domain name Example of a host create command lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt command gt lt create gt lt host create xmlns host urn ietf params xml ns host 1 0 gt lt host name gt ns1 yourname ch lt host name gt lt host addr ip v4 gt 192 0 2 2 lt host addr gt lt host addr ip v4 gt 192 0 2 29 lt host addr gt lt host addr ip v6 gt 1080 0 0 0 8 800 200C 417A lt host addr gt lt host create gt lt create gt lt c1TRID gt ABC 12345 lt c1TRID gt lt command gt lt epp gt Example of a host create response lt xml version 1 0 encoding UTF 8 gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt response gt lt result code 1000 gt lt msg lang en gt Command completed successfully lt msg gt lt result gt lt resData gt lt host creData xmlns host urn ietf params xml ns host 1 0 gt lt host name gt ns1 yourname ch lt host name gt
55. t lt result code 1000 gt lt msg lang en gt Command completed successfully lt msg gt lt result gt lt trID gt lt clTRID gt freechoice lt clTRID gt lt svTRID gt 20071207 92690 285728 lt svTRID gt lt trID gt lt response gt lt epp gt SWITCH 2010 Subject to change Page 35 49 4 4 Host commands 4 4 1 General information SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch In addition to what is set out below all the host commands are described in detail in Reference 4 A distinction is drawn between the following hosts name servers Valid internal name server under ch li Ends in ch or li superordinate domain name is registered ns1 iamregistered ch Domain name iamregistered ch is registered Invalid internal name server under ch li Ends in ch or li superordinate domain name is not registered ns1 iamnotregistered ch Domain name iamnotregistered ch is not registered External name server not under chi li Name server that does not end in ch or li ns1 yourname com Irrespective of whether yourname com is registered or not Valid internal name servers under ch li belong to the holder of the superordinate domain name and are administered by their Partner These are transferred together with the domain name Invalid internal name servers under ch li are administered by SWITCH insofar as the superordinate domain
56. t IDs are not supplied with a transfer and need to be replaced with contact IDs created by the new Partner The new Partner must use domain update to enter a contact ID that they have created for the holder a technical contact is not mandatory before further updates are permitted for the domain name Until this has been done check info delete and transfer are the only valid commands If there is a holder change at the same time transfer of a domain name to another holder it must be performed in subject to the regulations of Paragraph 4 2 5 and the Partner is not allowed to make changes of the holder in the existing contact ID 4 command response The EPP server sends the new Partner a confirmation message EPP response 5 put message for current registrar SWITCH puts a new message in the poll queue for the Partner to date confirming the transfer of the domain name to a new Partner or to SWITCH 6 command response The new Partner can inform the holder that the transfer has been completed SWITCH does not generally make contact with the holder as long as the holder is with a Partner except in the cases mentioned in Reference 06 7 poll The Partner to date can retrieve the message generated under Number 5 above from their poll queue gt e After a successful transfer the status lt serverTransferProhibited gt is assigned While the domain name has this status it cannot be transferred to another Partner This status lasts
57. trID gt lt response gt lt epp gt 4 1 4 2 Transfercode Send message This message is placed in the poll queue of the future Partner in the case of a bulk Partner transfer The Partner carries out the transfer themselves with the transfer code contained in the message Attribute Comment domain name Domain name domain roid Dnnnnnnnn SWITCH domain clID contact id of current Partner domain authinfo Transfer code SWITCH 2010 Subject to change Page 13 49 SWITCH Serving Swiss Universities SWITCH Werdstrasse 2 P O Box CH 8021 Z rich www nic ch Example of a poll response lt xml version 1 0 encoding UTF 8 gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt response gt lt result code 1301 gt lt msg lang en gt Command completed successfully ack to dequeue lt msg gt lt result gt lt msgQ count 1 id 1139047 gt lt qDate gt 2007 09 26T00 00 00 02 00 lt qDate gt lt msg gt Domain transfercode lt msg gt lt msgQ gt lt epp resData xmlns epp urn ietf params xml ns epp 1 0 gt lt domain infData xmlns domain urn ietf params xml ns domain 1 0 gt lt domain name gt test partner a domain 1 ch lt domain name gt lt domain roid gt D1234567 SWITCH lt domain roid gt lt domain clID gt SWITCH PARTNER lt domain clID gt lt domain authInfo gt lt domain pw gt the domain tranfercode lt domain pw gt lt domain authInfo gt lt domai
58. with domain create No other Partner or direct customer is able to register this domain name during the transition period Transferring domain names with domain update is prohibited on legal grounds e A domain name can be deleted even if subordinate name servers subordinate hosts are available These continue to be registered but can no longer be used see Paragraph 4 4 Example of a domain delete command lt xml version 1 0 encoding UTF 8 standalone no gt lt epp xmlns urn ietf params xml ns epp 1 0 gt lt command gt lt delete gt lt domain delete xmlns domain urn ietf params xml ns domain 1 0 gt lt domain name gt yourname ch lt domain name gt lt domain delete gt lt delete gt lt c1TRID gt ABC 12345 lt c1TRID gt lt command gt lt epp gt Example of a domain delete response lt epp xmlns urn ietf params xml ns epp 1 0 gt lt response gt lt result code 1000 gt lt msg lang en gt Command completed successfully lt msg gt lt result gt lt triID gt lt c1TRID gt ABC 12345 lt c1TRID gt lt svTRID gt 54321 XYZ lt svTRID gt lt trID gt lt response gt lt epp gt 4 2 8 domain transfer The holder can have their domain name administered by a Partner of their choice or by SWITCH The domain transfer command is used to transfer domain names If subordinate name servers are available for a domain name that is to be transferred then these will similarly be transferred
Download Pdf Manuals
Related Search