EPP Protocol

How do I reset my EPP users password?

You will need to log in to the portal as an admin user and go to the Admin > Users section. Search for the EPP user and click on the username when that is displayed.

Enter and confirm the new password in the Reset Password section at the bottom right and then click the green Update User button at the top of the left hand menu panel. You should then see “The command executed successfully” shown in green at the top right of the page.

Are there any new EPP extensions?

Yes, there are a number of standard extensions as listed below; however note we are yet to confirm whether we will use them all:

· contact-1.0 - RFC 5733

· domain-1.0 - RFC 5731

· epp-1.0, eppall-1.0, and eppcom-1.0 - RFC 5730

· fee-0.9 - RFC Draft: brown-epp-fees

· fee-0.11 - RFC Draft: regext-epp-fees

· host-1.0 - RFC 5732

· idn-1.0 - RFC Draft: eppext-idnmap

· launch-1.0 - RFC Draft: regext-launchphase

· mark-1.0 and signedMark-1.0 - RFC 7848

· rgp-1.0 - RFC 3915

· secDNS-1.1 - RFC 5910

The following are the custom extensions:

· fury 2.0 - Generic properties

· fury-rgp-1.0 - RGP

Is there a list of and explanation for error messages and codes?

In the portal help under Supplementary Documents there is a Error Codes and Messages sectikon detailing these.

How do I Re-Activate a domain that is in ‘pendingDelete’ state?

You will need to do a restore request (which can be done using a domain update) but you also need to do a restore report command.

Restore request example

<?xml version='1.0' encoding='UTF-8'?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   <command>
      <update>
         <domain:update xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
            <domain:name>testdomain3.nz</domain:name>
            <domain:chg/>
         </domain:update>
      </update>
      <extension>
         <rgp:update xmlns:rgp="urn:ietf:params:xml:ns:rgp-1.0">
            <rgp:restore op="request"/>
         </rgp:update>
      </extension>
      <clTRID>ABC-12345</clTRID>
   </command>
</epp>

Restore report example

<?xml version='1.0' encoding='UTF-8'?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   <command>
      <update>
         <domain:update xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
            <domain:name>testdomain3.nz</domain:name>
            <domain:chg/>
         </domain:update>
      </update>
      <extension>
         <rgp:update xmlns:rgp="urn:ietf:params:xml:ns:rgp-1.0">
            <rgp:restore op="report">
                <rgp:report>
                   <rgp:preData>Pre-delete registration data goes here.   Both XML and free text are allowed.</rgp:preData>
                   <rgp:postData>Post-restore registration data goes here.   Both XML and free text are allowed.</rgp:postData>
                   <rgp:delTime>2003-07-10T22:00:00.0Z</rgp:delTime>
                   <rgp:resTime>2003-07-20T22:00:00.0Z</rgp:resTime>
                   <rgp:resReason>Registrant error.</rgp:resReason>
                   <rgp:statement>This registrar has not restored the Registered Name in order to assume the rights to use or sell the Registered Name for itself or for any third party.</rgp:statement>
                   <rgp:statement>The information in this report is true to best of this registrar's knowledge, and this registrar acknowledges that intentionally supplying  false information in this report shall constitute an incurable material breach of the  Registry-Registrar Agreement.</rgp:statement>
                   <rgp:other>Supporting information goes  here.</rgp:other>
                 </rgp:report>
            </rgp:restore>
         </rgp:update>
      </extension>
   </command>
</epp>

Do an EPP domain info or use the portal to get the delTime and resTime details.

The preData and postData elements can be as below.

<rgp:preData>Not Applicable</rgp:preData>
<rgp:postData>Not Applicable</rgp:postData>

How do I change the hosts assigned to a domain?

You need to remove the existing hosts and add the new ones. This can be done using a domain update including a “domain:add” directive and a “domain:rem” directive as shown below.

<update>
  <domain:update xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
    <domain:name>domain.nz</domain:name>
    <domain:add>
      <domain:ns>
        <domain:hostObj>ns1.new-ns.nz/domain:hostObj>
        <domain:hostObj>ns2.new-ns.nz</domain:hostObj>
      </domain:ns>
    </domain:add>
    <domain:rem>
      <domain:ns>
        <domain:hostObj>ns1.old-ns.nz</domain:hostObj>
        <domain:hostObj>ns2.old-nz.nz</domain:hostObj>
      </domain:ns>
    </domain:rem>
  </domain:update>
</update>