Personal tools

From HEXONET Wiki

Jump to: navigation, search
(Expiring Authorization Codes)
(Registering Reserved Second Level Domains)
 
(27 intermediate revisions by 2 users not shown)
Line 4: Line 4:
 
| introduced = 1987
 
| introduced = 1987
 
| country = New Zealand
 
| country = New Zealand
| registry = NZRS Ltd
+
| registry = Internet New Zealand Incorporated (InternetNZ)
 
| idn capable = Yes
 
| idn capable = Yes
 
| webpage = [https://www.hexonet.net/domain-name/nz Register .NZ]
 
| webpage = [https://www.hexonet.net/domain-name/nz Register .NZ]
 
}}
 
}}
  
{{#repositoryinfo: NZEPP-LIVE-1API | co.nz }}  
+
{{#repositoryinfo: NZEPP2-LIVE-1API | co.nz }}  
 
{{Sidebar}}
 
{{Sidebar}}
 
<div style="font-size: 250%;">'''.NZ'''</div><br/>
 
<div style="font-size: 250%;">'''.NZ'''</div><br/>
Line 15: Line 15:
  
 
__TOC__
 
__TOC__
 +
= NOTE =
  
== Second Level Domain Registration Documents ==
+
<div class="alerthexonet alerthexonet-error">From '''12.04.2017''' all .NZ domains which will expire till '''15.04.2017''' or where expiration date lies in past, we will only accept transfer requests where "'''PERIOD=1'''" or "'''PERIOD=1Y'''" is explicitly stated. Requests where "'''PERIOD=0'''" or "'''No Period'''" is stated will not be accepted and result in an error.</div>
  * EPP Guide: [[Media:HEXONET_EPP_Guide_to_the_New_Procedures_for_NZ_Domains_v1.00.pdf|HEXONET_EPP_Guide_to_the_New_Procedures_for_NZ_Domains_v1.00.pdf]]
+
  
== Registry ==
+
= Registry =
 
{{Summarybox
 
{{Summarybox
 
| TLD={{#IfEmpty: {{#var:TLD}} | {{#var:TLD}} | - }}
 
| TLD={{#IfEmpty: {{#var:TLD}} | {{#var:TLD}} | - }}
Line 61: Line 61:
 
}}
 
}}
  
== Periods ==
+
= Periods =
 
{{Summarybox
 
{{Summarybox
 
| Registration Period={{#var:ZONEREGISTRATIONPERIODS}}
 
| Registration Period={{#var:ZONEREGISTRATIONPERIODS}}
Line 77: Line 77:
 
= API =
 
= API =
  
=== Domain Registration ===
+
== Domain Registration ==
 
{{#var:REGISTRATIONSENTENCE}}
 
{{#var:REGISTRATIONSENTENCE}}
 
{{#var:ADDDOMAINCOMMAND}}
 
{{#var:ADDDOMAINCOMMAND}}
Line 94: Line 94:
 
transferlock = 0 | 1 | <NULL>
 
transferlock = 0 | 1 | <NULL>
 
subuser = <TEXT> | <NULL>
 
subuser = <TEXT> | <NULL>
 +
X-DISCLOSE = 0 | 1 (0 = select privacy option, 1 = turn off privacy option)
 +
X-REGISTRANT-DISCLOSE = 0 | 1  (0 = select privacy option, 1 = turn off privacy option)
 +
X-ADMIN-DISCLOSE = 0 | 1 (0 = select privacy option, 1 = turn off privacy option)
 +
X-TECH-DISCLOSE = 0 | 1 (0 = select privacy option, 1 = turn off privacy option)
 
</pre>
 
</pre>
  
=== Domain Transfer ===
+
== Domain Transfer ==
 
{{#var:TRANSFERSENTENCE}}
 
{{#var:TRANSFERSENTENCE}}
 
{{#var:TRANSFERDOMAINCOMMAND}}
 
{{#var:TRANSFERDOMAINCOMMAND}}
Line 114: Line 118:
 
</pre>
 
</pre>
  
=== Delete Domain ===
+
== Delete Domain ==
 
{{#var:DELETESENTENCE}}
 
{{#var:DELETESENTENCE}}
 
{{#var:DELETEDOMAINCOMMAND}}
 
{{#var:DELETEDOMAINCOMMAND}}
Line 123: Line 127:
  
  
=== Restore Domain ===
+
== Restore Domain ==
 
{{#var:RESTOREPOLICYSENTENCE}}
 
{{#var:RESTOREPOLICYSENTENCE}}
 
{{#var:RESTOREDOMAINCOMMAND}}
 
{{#var:RESTOREDOMAINCOMMAND}}
Line 138: Line 142:
  
  
=== Ownerchange ===
+
== Ownerchange ==
 
{{#var:TRADESENTENCE}}
 
{{#var:TRADESENTENCE}}
  
== TLD specific ==
+
= TLD specific =
  
=== Generating a UDAI ===
 
In order to set a UDAI code (Unique Domain Authorisation ID) for your domain, please proceed as follows in the HEXONET Control Panel:
 
# Unlock the domain (remove the transfer lock)
 
# Wait a few minutes
 
# go to Tools > API Library > ObjectLog and enter the domain.
 
  
The latest response will deliver the NEW UDAI.  
+
== Individual Registrant Privacy Option (IRPO) ==
While using the API, after unlocking the domain, you will receive an Event from our system with the new UDAI code.
+
{{Warnbox|
 +
<p>The optional X-DISCLOSE flags allow a registrant to use the Individual Registrant Privacy Option (IRPO). Choosing to enable the IRPO will hide the phone number and address information for the domain contact(s) in WHOIS search results.</p>
  
==== Expiring Authorization Codes ====
+
<p>The X-DISCLOSE parameter applies privacy to all contacts, the X-REGISTRANT-DISCLOSE parameter applies privacy to registrant contact only, the X-ADMIN-DISCLOSE parameter applies privacy to admin contact only, and the X-TECH-DISCLOSE parameter applies privacy to tech contact only.</p>
  
Please note that UDAIs may only be obtained from the current registrar of a domain name, and that they expire after 30 days.
+
<p>The registrar contact is not subject to WHOIS privacy. If the registrar contact is similar to any of the above contacts, then there should be two contact handles, one which is applicable for WHOIS privacy and one that not subject to WHOIS privacy.</p>
  
=== Registering Reserved Second Level Domains ===
+
<p>By enabling this feature, a .NZ domain registrant guarantees that they are an individual registrant and not using their .NZ domain(s) for significant trade.</p>
 +
}}
  
In order to register a reserved second-level .NZ domain for an existing third-level domain, you can simply request a transfer of the desired second-level name and provide the UDAI of your third-level domain with a period of 1 (one) year. If necessary, see above on how to obtain a UDAI for an existing domain.
 
  
The transfer may then be requested in our Control Panel or with the following API command using the new UDAI (AUTH) of the third-level domain:
+
== Second Level Domain Registration Documents ==
 +
  * EPP Guide: [[Media:HEXONET_EPP_Guide_to_the_New_Procedures_for_NZ_Domains_v1.00.pdf|HEXONET_EPP_Guide_to_the_New_Procedures_for_NZ_Domains_v1.00.pdf]]
 +
 
 +
== Generating an Authorisation Code ==
 +
<pre>
 +
COMMAND = ModifyDomain
 +
GENERATERANDOMAUTH = 1
 +
DOMAIN = <domain>
 +
</pre>
 +
 
 +
=== Expiring Authorisation Codes ===
 +
 
 +
Please note that Auth Codes may only be obtained from the current registrar of a domain name, and that they expire after 30 days.
 +
 
 +
== Registering Reserved Second Level Domains ==
 +
 
 +
The .NZ Registry offers Registrants, who already own a .CO.NZ (NET.NZ / ORG.NZ ) domain the possibility to register the name-pendant under .NZ. Requirement is, that the .CO.NZ (NET.NZ / ORG.NZ )  is registered in HEXONET. If this is the case, you should submit a "transfer-request" for the corresponding .NZ domain, by providing the Auth code of the existing .CO.NZ (NET.NZ / ORG.NZ ) - Domain. If necessary, see above on how to obtain an Auth code for an existing domain.
 +
 
 +
The transfer may then be requested in the Control Panel or with the following API command using the new Auth code (AUTH) of the third-level domain:
  
 
<pre>
 
<pre>
Line 167: Line 185:
 
AUTH = ABCDE1234
 
AUTH = ABCDE1234
 
PERIOD = 1
 
PERIOD = 1
 +
EOF
 
</pre>
 
</pre>
  
 +
The resolved name can only be registered using details that match the registrant details used for the qualifying 3rd level domain name. Approval will not be given for registration under other details.
 +
 +
== Modify Contact ==
 +
Specify which dedicated contact details should be affected by the DISCLOSE parameter setting. If not stated the DISCLOSE parameter affects all possible contact details. Multiple values are possible and have to be separated by a blank space.
 +
<pre>
 +
command=modifycontact
 +
contact=<CONTACT-HANDLE>
 +
X-NZ-DISCLOSE=1
 +
X-NZ-DISCLOSE-ELEMENTS=ADDR VOICE FAX EMAIL VAT IDENT NOTIFYEMAIL
 +
</pre>
  
== Addons ==
+
= Addons =
  
 
{{#var:DOMAINADDONTABLE}}
 
{{#var:DOMAINADDONTABLE}}
  
== RegistrarOC ==
+
= RegistrarOC =
  
 
{{#var:REGISTRAROCSENTENCE}}
 
{{#var:REGISTRAROCSENTENCE}}
  
 
{{#var:CATEGORY}}
 
{{#var:CATEGORY}}

Latest revision as of 13:59, 1 March 2023

.NZ

.NZ is the country code domain for New Zealand. .NZ is available for New Zealand Kiwis and anyone related to or connected with New Zealand.

Nz-2014.png
Introduced 1987
Country New Zealand
Registry Internet New Zealand Incorporated (InternetNZ)
IDN Capable Yes
Webpage Register .NZ

Contents

[edit] NOTE

From 12.04.2017 all .NZ domains which will expire till 15.04.2017 or where expiration date lies in past, we will only accept transfer requests where "PERIOD=1" or "PERIOD=1Y" is explicitly stated. Requests where "PERIOD=0" or "No Period" is stated will not be accepted and result in an error.

[edit] Registry

TLD

-

Allowed TLDs

-

Registry

NZRS Ltd.

Dispute Policy

Rules

Registrar

1api GmbH

WHOIS-Server

whois.srs.net.nz

WHOIS-Update

Real-Time

Min. Characters

1

Max. Characters

63

Character Set
  • Letters and numbers
  • Hyphens ("-"), however not at the beginning or directly in front of the TLD
  • IDN: allowed
Limitations
  • Registrant Contacts: Required: 1 / Maximum: 1
  • Admin Contacts: Required: 1 / Maximum: 1
  • Tech Contacts: Required: 1 / Maximum: 1
  • Billing Contacts: Required: 0 / Maximum: 1

{{{Possible Extensions}}}

IDN capable

Yes

Restore capable

Real-Time

Handle Updates

Supported

Registration System

Real-Time

Allowed number of NS

0 to 10

Registry Nameservercheck

No

Host IP-Addresses Type

IPv4 / IPv6

Hosts managed as

Object

Root Nameserver Update

hourly

SEC DNS Interface

DS data interface

Transferclass

Pull

Transfer Periods

0Y,1Y

Transfer Authcode required

Yes

Transfer Real-Time

Yes

Transfer Lock

Yes

Transfer Confirmation (Request / Approve)

- / -

Owner Change by

Update


[edit] Periods

{{{Possible Extensions}}}

Registration Periods

1-10 years

Add Grace Period

0 days

Accounting Period

-1 day

Finalization Period

44 days

Failure Period

44 days

Payment Period

-61 days

Deletion Restorable Period

90 days

Deletion Hold Period

2 days

Explicit Renewals

Yes

Renewal Periods

1-9 years


[edit] API

[edit] Domain Registration

Domains can be registered in Real-Time with the API AddDomain command.

command = AddDomain
domain  = (DOMAIN)

REQUIRED

ownercontact0 = (CONTACT)
admincontact0 = (CONTACT)
techcontact0 = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0 = (NAMESERVER)
nameserver1 = (NAMESERVER)

OPTIONAL

auth = <TEXT> | <NULL>
transferlock = 0 | 1 | <NULL>
subuser = <TEXT> | <NULL>
X-DISCLOSE = 0 | 1 (0 = select privacy option, 1 = turn off privacy option) 
X-REGISTRANT-DISCLOSE = 0 | 1  (0 = select privacy option, 1 = turn off privacy option) 
X-ADMIN-DISCLOSE = 0 | 1 (0 = select privacy option, 1 = turn off privacy option) 
X-TECH-DISCLOSE = 0 | 1 (0 = select privacy option, 1 = turn off privacy option) 

[edit] Domain Transfer

The transfer has to be initiated by the gaining registrar and can be requested with the API TransferDomain command.
A valid Authorization Code must be provided to initiate a transfer successfully. You may obtain the authorization code from the losing registrar.
Domain transfers are processed in Real-Time.

command = TransferDomain
domain = (DOMAIN)

REQUIRED

action = REQUEST | APPROVE | DENY | CANCEL | USERTRANSFER
auth = <TEXT>

OPTIONAL

order = CREATE | REPLACE | UPDATE

subuser = <TEXT> | <NULL>
period = <PERIOD>
transferlock = 0 | 1 | <NULL>

[edit] Delete Domain

Domains can be deleted with the API DeleteDomain command.
There is a Deletion Restorable Period of 90 days and a following Deletion Hold Period of 2 days.

command = DeleteDomain
domain = (DOMAIN)

REQUIRED

n/a


[edit] Restore Domain

Restores can be processed in realtime. A restore is possible within 90 days upon deletion. Please use the command RestoreDomain.

command = RestoreDomain
domain = (DOMAIN)

REQUIRED

n/a

OPTIONAL

renewalmode = <NULL> | <TEXT>
subuser = <TEXT>


[edit] Ownerchange

An Ownerchange is free of charge and can be done with the API ModifyDomain command.

[edit] TLD specific

[edit] Individual Registrant Privacy Option (IRPO)

The optional X-DISCLOSE flags allow a registrant to use the Individual Registrant Privacy Option (IRPO). Choosing to enable the IRPO will hide the phone number and address information for the domain contact(s) in WHOIS search results.

The X-DISCLOSE parameter applies privacy to all contacts, the X-REGISTRANT-DISCLOSE parameter applies privacy to registrant contact only, the X-ADMIN-DISCLOSE parameter applies privacy to admin contact only, and the X-TECH-DISCLOSE parameter applies privacy to tech contact only.

The registrar contact is not subject to WHOIS privacy. If the registrar contact is similar to any of the above contacts, then there should be two contact handles, one which is applicable for WHOIS privacy and one that not subject to WHOIS privacy.

By enabling this feature, a .NZ domain registrant guarantees that they are an individual registrant and not using their .NZ domain(s) for significant trade.


[edit] Second Level Domain Registration Documents

 * EPP Guide: HEXONET_EPP_Guide_to_the_New_Procedures_for_NZ_Domains_v1.00.pdf

[edit] Generating an Authorisation Code

COMMAND = ModifyDomain
GENERATERANDOMAUTH = 1
DOMAIN = <domain>

[edit] Expiring Authorisation Codes

Please note that Auth Codes may only be obtained from the current registrar of a domain name, and that they expire after 30 days.

[edit] Registering Reserved Second Level Domains

The .NZ Registry offers Registrants, who already own a .CO.NZ (NET.NZ / ORG.NZ ) domain the possibility to register the name-pendant under .NZ. Requirement is, that the .CO.NZ (NET.NZ / ORG.NZ ) is registered in HEXONET. If this is the case, you should submit a "transfer-request" for the corresponding .NZ domain, by providing the Auth code of the existing .CO.NZ (NET.NZ / ORG.NZ ) - Domain. If necessary, see above on how to obtain an Auth code for an existing domain.

The transfer may then be requested in the Control Panel or with the following API command using the new Auth code (AUTH) of the third-level domain:

COMMAND = Transferdomain
DOMAIN = example.nz
AUTH = ABCDE1234
PERIOD = 1
EOF

The resolved name can only be registered using details that match the registrant details used for the qualifying 3rd level domain name. Approval will not be given for registration under other details.

[edit] Modify Contact

Specify which dedicated contact details should be affected by the DISCLOSE parameter setting. If not stated the DISCLOSE parameter affects all possible contact details. Multiple values are possible and have to be separated by a blank space.

command=modifycontact
contact=<CONTACT-HANDLE>
X-NZ-DISCLOSE=1
X-NZ-DISCLOSE-ELEMENTS=ADDR VOICE FAX EMAIL VAT IDENT NOTIFYEMAIL

[edit] Addons

[edit] RegistrarOC

Restore Process

To restore a domain as a RegistrarOC customer, you simply have to execute the RestoreDomain command. HEXONET directly forwards the restore request to the registry, which performs the restore in real-time. As soon as the restore is complete, the domain will get assigned to your account with the original domain data.

Please do not initiate a restore directly at the registry (e.g. using the registrar webinterface). All restore operations must be performed through our system.