Registry Concepts

Registrar Portal

The current registrar portal is being deprecated and replaced by the new IRS web portal. The IRS portal is significantly different; some of the key highlights of the IRS portal are:

  • It lets you carry out the full life cycle of domain management functions, including:

    • Domain search, information, create, update, renewal, transfer, delete and restore,

    • Contact search, information, create, update, and delete, and

    • Host search, information, create, update, and delete.

  • Provides the ability to view and acknowledge service messages,

  • Lets you manage users and assign role based permissions, as well as

  • Domain management and registrar business reporting.

Functionality in the current registrar portal which is not being provided by the IRS portal includes:

  • Graphical representation of domain information and reports,

  • List of second level names that are currently available for registration,

  • Conflicted domains list,

  • Zone scan validation report, and

  • Registrant data quality issues.

Reporting

The IRS portal can generate a number of business reports including:

  • Transaction Summary — displays a list of registrar transactions,

  • Monthly Scorecard — displays a list of complete and incomplete registrant contacts,

  • Registrant Profile Data Integrity — displays a list of contact profiles that have insufficient data, and

  • Account Measurement — displays measurement transaction activities and measurement balance for registrars.

Note

Full details of the features and functionality provided by the IRS portal and how to use it can be found in the registrar guide. The IRS portal also comes with an extensive online help.

Tip

The information presented in the new IRS portal is different to the current registrar portal. The new system provides a number of built-in reports. We also want to understand what additional information you may need, as it may be possible to add additional reports to meet your requirements.

Warning

This is a significant change for all portal users

Domain name life cycle

The different stages of a domain life cycle are the states that a domain name passes through from the beginning of its life cycle (the Available state) to the end of the life cycle (returning to the Available state).

Changes of note:

  • Registration grace period is now known as the “add period”.

  • Renewal grace period, an explicit registrar renewal is still 5 days.

  • Auto-Renew grace period, please note the auto-renew grace period changes from 5 days to 45 days.

  • Pending release is now known as “redemption period”.

  • Pending delete is new (see below under IRS life cycle).

  • Pending restore period is new — the period during which a domain name is being restored to the registry after having been in the redemption period stage and can be up to 5 days. Typically a restore is performed immediately though - see the Restoring a domain section for more info.

Note

Potential registrar process change - terminology and grace periods

SRS life Cycle

../../../_images/SRS_lifecycle.png

New IRS life cycle

../../../_images/IRS_lifecycle.png

The IRS registry platform implements a domain life cycle in accordance with Section 3.1 of RFC 3915.

The stages/states of a domain life cycle are(Note. EPP status codes in brackets):

  • Available - The domain name is available for registration.

  • Add period (addPeriod) - The grace period (5 days) after which the domain name has been added to the registry. If the domain is deleted during this period, there is a refund for the cost of the registration and the domain goes straight to a pending delete state, skipping the redmption period.

  • Registered (ok) - The domain name is registered and active.

  • Renew period (renewPeriod) - The grace period (5 days) after a domain has been explicitly renewed by the Registrar. This grace period following a domain name renewal allows the Registrar to delete the domain if necessary and obtain a credit for the cost of the renewal.

  • Auto-renew period (autoRenewPeriod) - This grace period (45 days) occurs after a domain has been automatically renewed by the Registry. If the domain is deleted during this period, there is a refund for the cost of the renewal.

  • Redemption period (redemptionPeriod) - The grace period (90 days) following the deletion of a domain name from the Registry. During this period, the domain name no longer resolves and cannot be renewed but the Registrar has the option to use the restore command to return the domain name to the registered state.

  • Pending restore (pendingRestore) - The period during which a domain name is in the process of being restored to the Registry after having been in the redemptionPeriod stage. i.e. the time allowed between posting a restore request and a restore report.

  • Pending delete (pendingDelete) - A successful Domain Delete request transitions a domain object into pending delete state within the Registry. (A domain name that has been deleted transitions from registered, to redemption, and then to pending delete.) In the pending delete state, the domain name cannot be renewed or restored under any circumstances and is in the process of being removed from the Registry database to become available when the period ends.

  • Registered (inactive) - The domain name is registered and inactive. The inactive EPP status code indicates that delegation information (name servers) have not been associated with the domain. The domain is not activated in the DNS and will not resolve.

Tip

pendingDelete is a lifecycle state and a domain server status. When a domain is deleted it goes into the redemptionPeriod life cycle state and is assigned a server status of pendingDelete. When a domain has completed the redemptionPeriod it goes into the pendingDelete life cycle state and has a server status of pendingDelete until the domain is made available.

Conflicted domains

There are now less than 2,000 domain names at the second level that are in a conflicted state and cannot be registered until the conflict is resolved. We will be making changes to the conflicted name process in the new system including:

  • How we intend to resolve conflicts,

  • How we assign the resolved name to a domain name holder,

  • How a registrar identifies a conflicted/resolved domain, and

  • How a registrar can register a resolved domain.

When the details are finalised we will publish them here in the docs.

Locking

Registry lock (new feature)

Registry lock is a service that helps protect domains against malicious actors and unintended changes that may affect the stability and availability of a website. The .nz registry lock service adds a layer of security checks to safeguard change requests to a .nz domain name before executing them. The additional security checks make it deliberately harder to cause damaging changes to a domain name.

We are finalising the details of the registry lock service and when this is complete we will publish them here in the docs.

Note

This registry lock service is for registrars to provide to their customers and it is different to the registry lock that is used in the current SRS. Please refer to the compliance lock below.

Compliance lock (new feature)

This compliance lock feature replaces the registry lock that was used in the SRS.

The Domain Name Commission have a complaints and disputes process to help improve the safety of the .nz space. Complaints and disputes that the Commission assist with are broadly divided into three main categories:

  • Complaints linked to domain name registration details,

  • Dispute Resolution Service complaints, and

  • Any other complaints, including complaints about providers of .nz domain names.

In some case an investigation may be required to resolve a complaint or dispute. Part of the DNC investigation process may lead to the locking of the domain name and associated contacts. This lock is called a compliance lock. A compliance locked domain cannot be transferred (registrar or registrant), cancelled or released and the registration details cannot be modified.

Registrars will be notified of the lock/unlock by services messages to their poll message queue which is accessible via EPP or the IRS portal. Example messages:

  • Domain xxxxxxxxxxxx.nz has been locked and all associated contacts have been copied and locked. Changes are not allowed. Contact the registry/regulator for questions.

  • Domain xxxxxxxxxxxx.nz has been unlocked. Changes are now allowed. Contact the registry/regulator for questions.

Registrant lock (new feature)

A new feature to IRS is registrant lock. Registry Support can apply a lock to a Registrant for a domain so that no updates to the Registrant ID or Registrant Name can be made through either the IRS portal or EPP. Registrars can still make changes to other information for that contact when the lock is applied.

Changes can only be made to the Registrant ID or Registrant Name if Registrant Lock is unlocked.

Billing

Billing Cycle

Under the SRS, monthly billing would occur around the 6th day of the following month, to ensure any subsequent grace period actions were accounted for in the billing run.

This changes with the IRS, with the billing cycle being the first of every month, and any subsequent grace period actions, triggering rebate transactions, being applied to the following month’s invoice.

Registrant reference (deleted)

In the SRS the registrant reference (reg_customer_ref) is an optional field that registrars populate with reference information for the registrant, e.g. a customer number, that flows through to the invoice. It’s free-format and is associated with the domain. This field will not be available in the IRS and the data will not be migrated.

Note

This means that the registrant reference will not be present in the CSV file produced with the invoice.

Fees

The minimum domain name term for registrations and renewals is changing from monthly to yearly. The current wholesale fee for 1 month is $1.50 and for 12 months it is $18.00.

A table of domain registration and renewal fees, and any other fees we decide to add in the future, will be available in the IRS portal.

The current minimum monthly fee of $48.00 is also being removed.

Invoicing

Our invoice process and invoice statements are undergoing a redesign. When this has been completed, we will let you know the details of any changes that may impact you. We will also use this opportunity to review and update our billing polices and procedures to ensure they are consistent with the updated .nz rules and the new registry system - details to come.

Note

Potential registrar process change - invoicing, no minimum monthly fee charge and grace periods

Domain automation jobs

In the SRS there are two domain automation scheduled jobs run by the registry system, renew domains and release domains. These jobs are replaced in the IRS by an automation system called housekeepers.

IRS uses housekeepers, set to run at periodic intervals, to transition domains through lifecycle phases. Specifically the domain_job_frequency housekeeper is responsible for all domain related housekeeper operations, including:

  1. Expired status:

    • Deletes domain statuses, other than pending delete, if their expiry date has passed. If there are no remaining statuses for the domain, the “ok” status is added.

  2. Expired lifecycle stage:

    • Transitions domains from one life cycle state to another, including statuses, except for domains under a pending transfer. It may attempt to renew a domain if conditions are met.

  3. Cancelled TBR (droplist) session:

    • When a TBR session is cancelled, any remaining domains are moved to the next TBR session, if it exists. The domain’s stage of life expiry date may be affected.

The domain_job_frequency housekeeper is set to run every 320 seconds (~5.34 minutes).

This housekeeper changes current state operations, replacing the following SRS scheduled jobs:

  • Renew domains - daily at 2330, and

  • Release domains - daily at 0029.

It also replaces current immediate system actions associated with lifecycle transitions, including:

  • Immediate renew (triggered by an update to an expired domain), and

  • Immediate delete (triggered by a cancel during the add grace period).

Note

Potential registrar process change - daily renew and release domains processes and some immediate system actions change to periodic intervals (approx. every 5 minutes)

Protocol

SRS

The SRS protocol has been retired and will not be supported in the IRS.

EPP

The EPP protocol is supported in the IRS.

Objects

TThe SRS EPP used two object types: domain and contact.

The IRS EPP protocol uses three object types:

  1. Domain objects contain information about domain names,

  2. Contact objects contain information about the contacts that are associated with domain names, like the registrant, the admin contact, the technical contact and the new optional billing contact; See the Contacts section for more info, and

  3. Host objects contain nameserver information.

Object Sponsorship

In the IRS registry, each object is required to have a sponsor and the sponsor, by default, is the registrar who creates the object.

Only the sponsor can change an object, i.e. update, renew, delete.

The sponsorship of a domain can be changed by a domain transfer.

A contact object can be associated with multiple domains belonging to the same sponsor. The sponsorship of a contact cannot be changed. Contacts associated to domains will be copied on transfer, not moved, to the new registrar.

A host object may be associated with multiple domains, with the same or different sponsors. Hosts are transferred when the superordinate domain is transferred.

Date Fields

For our current system we present all date/times as NZT with the UTC offset, e.g. (UTC +12/UTC+13).

This is changing in IRS and date/times are expressed in UTC (Coordinated Universal Time), with a special UTC designator (“Z”) at the end, e.g. 2021-11-25T21:31:29.425Z.

Tip

This includes EPP, WHOIS, RDAP and the IRS Portal.

In the IRS portal, however, two dates will be displayed in the search result, date columns: UTC and the client’s local time.

../../../_images/screenshot_UTC_and_local_dates.png