Home - Punktum-dk/epp-service-specification GitHub Wiki

Punktum dk EPP Service Wiki

Release Notes

These are the release notes for the Punktum dk Self-Service Portal. The service specification can be found here: https://github.com/Punktum-dk/epp-service-specification

EPP Version 4.11.0

This release contains several improvements to contact create and contact update commands, focusing on ensuring quality of received data from registrars. The changes are primarily related to validation of VAT and P numbers of Danish business entities by performing lookup in the Danish Business Registry (CVR)

Additionaly, the release introduces an updated XSD (dkhm-4.4) containg addition of extension dkhm:VID to the domain info command. This boolean field is used to inform if VID-service is associated with the requested domain, thus preventing numerous operations from being performed without accept of the designated domain VID contact. See https://punktum.dk/en/articles/vid-service for further information regarding VID.

Furthermore, the new EPP version will also be available in production located at epp.dk-hostmaster.dk. With this release, we introduce new infrastructure to support multiple XSD versions in parallel. Based on the XSD version specified in the received client command, the request is redirected to the server nodes running the corresponding EPP version, e.g.

dkhm-4.3 -> EPP version 4.10.1 dkhm-4.4 -> EPP version 4.11.0

This allows registrars to switch to the new version of EPP when they are ready to do so, not having to wait to a specific cut-over date.

Please note that dkhm-4.3 / EPP version 4.10.1 will be decommissioned on Wednesday, September 4th, 2024.

Complete list of changes in this release:

Validation of contact CVR and P numbers during contact creation and update
Addition of dkhm:VID extension (feature request #2021)
Remove option to change contact user type through update contact command
Addition of resData section to domain_activated and accept_agreement_expire poll messages
Correction of svTRID handling in poll messages
Correction of avail status error in poll messages related to domain updates (known issue #2500)
Addition performance logging to further improve performance monitoring
Correction of invalid response code 1000 on failed commands (known issue #1951)

Release 4.10.0 of the EPP service

Features

Feature Request #2082: EPP poll message when domain status changes

Various registry business processes can affect status of domains and thus what operations registrars are allowed to perform as well as payment status and expiry dates etc. Previously the only way for registrars to optain this information was by periodically request domain info for their entiry portfolio of domains. With this feature, poll messages are now being published instantly when these changes occur.

Limitations:

This feature supports registrar handled domains only
Poll messages are published to REG-* user. We have are separate feature request #2263 concerning the ability to enable registrars to define which users should be the default recipient of poll messages. This feature is not yet planned for development.

Bug fixes

Known Issue #2430: Incorrect exDate in resData on domain transfer
Known Issue #2432: resData missing in poll message on domain deletion

Release 4.9.0 of the EPP service

Features

When receiving a contact:create request for a Danish user containing dkhm:EAN, the provided value is verified against the public business registry and the user will automatically be set to receive invoicing via EAN

Bug fixes

Known issue #2280: Poll message on change nameservers occacionally missing host names

Release 4.8.1 of the EPP service

Bug fixes

Known Issue 2217: External redelegation with unlinked user id not possible
Known Issue 2236: Degraded performance of info:contact command

Release 4.8.0 of the EPP service

Features

Enable poll messaging on updates to and deletion of registrar handled contacts

Release 4.7.0 of the EPP service

Features

Known issue 2142: Allow transfer to registrar handling without triggering ID control

Release 4.6.1 of the EPP service

Bug fixes

Known Issue 2171: Error when attempting REDEL on non-registrar handled domains
Known Issue 2150: Error updating email on register locked contact via EPP when street2 is set
contact:create fails when dkhm:pnumber extension is specified

Release 4.6.0 of the EPP service

Features

Allow NSA to modify DNSSEC on registrar handled domains [known issue #2043]

Bug fixes

Possible to transfer domain name to yourself [known issue #1954]
Missing receipt to former NSA on completed domain redelegation [known issue #2038]
domain:paDate incorrectly formatted [known issue #2066]
host:create triggers request to linked NSA on non .dk nameservers [known issue #2071]

Release 4.5.0 of the EPP service

Features

Added resData section including domain for all relevant poll messages [known issue #1937]
Using external source for validation of EAN number (electonic invoice address for public Danish, Greenland og Faeroese institutions) submitted via the dkhm:EAN extension in create and update contact
Do not allow EAN to be submitted for non Danish, Greenland or Faeroese public institutions
Do not issue approval request on create nameserver for linked NSA [known issue #1950]

Bug fixes

Allow EPP service user to request change of name server administrator (NSA)
Error is returned after successful withdraw command
Make contact:voice a required field

Release 4.4.0 of the EPP service

Improved user match on contact creation when using AUTO instead of FORCE
Improved performance monitoring capabilities
Incorrect error messages on transfer being denied due to contact ID control status
Error when attempting to flush and add DSRECORDS when no records exists
Duplicated registrant email receipts on redelegation
Incorrect error code returned when trying to add DSRECORDS is being denied due to missing priveledge

Release 4.3.1 of the EPP service

Secondary email not updated
Remove unneeded limitations during nameserver change on registrar managed domains
Correct error message when attempting to flush DSRECORDS on domain without privilege

Release 4.3.0 of the EPP service

Improvement of return codes and error messages prohibiting and blocking transfers [known issue #10012]
Addition of data (VAT, EAN and P-number) to contact info response
Correction of status codes related to change of nameserver

Release 4.2.0 of the EPP service

Addition of EPP poll messages related to domain transfers [known issue #9863]
Addition of EPP poll messages related to change of ownership [known issue #9979]
Allow manual renewal up to the expiration date for a domain [known issue #10288]
Correction of error in EPP when attempting to become/remove payer using EPP service user

Release 4.1.1 of the EPP service

This is a minor bug fix release, addressing:

Support for _ in company names, the CVR register is quite liberal in it's set of allowed characters and it is no authoritative specification is available
The poll messages for registrars upon withdraw would contain some extra XML, which did not make sense in the context of the poll message, this has been removed

Release 4.1.0 of the EPP service

We have addressed the issue of the expiry dates being dependent on the status of the underlying financial transactions. The expiry dates are now only updated when the period is changed by renewals or cancellations. This addresses the issue on "Known Issues" listed as #9902
We have adjusted the business rules in relation to editing registrants under registrar management, so this is now possible via EPP and the registrar portal (RP) as the proxy role. This addresses the issue on the "Known Issues" list, identified as #9944
For the same feature (above) we have disabled the notification from DK Hostmaster to the registrant, any necessary communication is expected handled by the registrar
We have improved the authorization token format. This addresses the related issue listed on our roadmap. The format and feature has been added to the EPP service specifcation version 4.4. Do note the implementation is backwards compatible so already issued and active authorizations are still supported
Implemented error handling for change of ownership proces where the specificed registrant is similar to the existing registrant
Fixed issue with applications for domain names offered from waiting list, where the support for not using the authorization code resulted in an error
Correction to TLD handling where some TLDs where not recognized

Release 4.0.7 of the EPP service

A feature and bug fix release

Removal of notification sent to registrant upon manual renewal of a registrar managed domain name

Release 4.0.6 of the EPP service

This is a minor bug fix release, addressing:

When initiating a manual renewal it was not possible/supported to specify the domain name in punycode
EPP would not decline domain name applications, communicated via the domain create command, if the domain name was already created or enqueued. The domain application processor would be the provider of the response, instead of short-cutting the process in the EPP service
EPP service users would not be able to see the balance of the registrar account via the balance command. Do note that this fix does not address the observed issues with performance for getting the balance

Release 4.0.5 of the EPP service

This is a minor bug fix release, addressing:

DSRECORDS with keytag zero (0), would not render correctly in responses to domain info
Indication of a flush/deletion in conjunction with a addition of DSRECORDs, where no DSRECORDs would be present would result in a missing privilege error
Adjustment of recipient resolution for poll messages for asynchronous operations, requiring update of the domain application processor to version 6.0.0

Release 4.0.4 of the EPP service

This is a major bug fix release, addressing:

Error in account number resolution for service users, when attempting to check credit for prepaid account for domain name applications

Release 4.0.3 of the EPP service

This is a major bug fix release, addressing:

Registrar default setting for choice of management model was not being used, resulting in an error: Specified user handle not permitted without handling by registrar (2306) when asserting the contact specified as the designated registrant

Release 4.0.2 of the EPP service

This is a major bug fix release, addressing:

Corrected error handling on change of billing contact for a domain name, it would indicate success upon error
The creation of domain names for registrar management, now presents an error if the proxy or billing contacts are specified, these should not be specified for when applying for a domain name under registrar management, since these are implicitly the registrar. Specifying seperate proxy or billing contacts is only supported for registrant managed domain names. The error code 2306 now listed in the revision 4.1 of the EPP service specification for the create domain command

Release 4.0.1 of the EPP service

This is a minor bug fix release, addressing:

Addressing an issue with internal handling of authentication requests
A minor correction to XML output for response to info domain, which indicated an issue in our logs

Release 4.0.0 of the EPP service

This major release primarily introduces support for registrar/registrant management model. The article "New basis for collaboration between registrars and DK Hostmaster" outlines the overall concept.

Secondarily the release introduces a new process for changing name servers for a domain name registered with the DK Hostmaster registry.

More specific details are listed below.

The procedures for renewal and application/creation are not being changed, in regard to use and protocol, however the business policies in relation to these operations, do change, since the billing operation changes with the introduction with the use of registrar accounting, based on a prepaid model. Please see the article: "Registrar account for all registrars"
With the new accounting model, we introduction of support for balance command in EPP based on the VeriSign extension. See the EPP Service Specification
The support for two management models, introduces the optional extension dkhm:management, which can be used to overwrite the specified default settings for the registrar account. Please see the release documentation for the registrar portal version 3.0.0 for details on the handling and setting of defaults. The extension can be used for domain applications using the domain create command and the creation of users using the create contact command. See the EPP Service Specifcation
In conjunction with the initial setting for management model, the EPP service is opened for transfer between registrar portfolios using the transfer domain command, which will be based on AuthInfo tokens. See the EPP Service Specification
In addition to the transfer command, we introduce the use of the withdraw command based on the extension specified by Norid (PDF). See the EPP Service Specification
With the introduction of registrar management, the delete domain command is implemented to support cancellation of domain name subscriptions. See the EPP Service Specification
With the introduction of the delete command (above) the ability to restore domain name subscription that have been cancelled, all via update domain command based on RFC:3915. See the EPP Service Specification
With registrar model, the EPP service also opens for a more wide administration of contact/user data, via the update contact command
The update domain command has been extended to support:
- Setting and unsetting autorizations (AuthInfo) for both transfer of domain names and change of name servers. See the EPP Service Specification
- Support for change of name servers directly via authorization based on AuthInfo. See the EPP Service Specification
The domain info command has been extended to support presentation of the expiration of an anthorization (AuthInfo) via the extension: dkhm::authInfoExDate. See the EPP Service Service Specification
The status codes for domain names presented via the domain info command has been revisited and now support and reflect the registrar and registrant management models. See the EPP Service Specification
The status codes for contact objects presented via the contact info command has also revisited. See the EPP Service Specification
The status codes for host object presented via the host info command has been revisited. See the EPP Service Specification
The process for changing registrants via the domain update command has been extended to support change of registrants under registrar management. See the EPP Service Specification
This version of the EPP service uses version 4.3 of the DK Hostmaster EPP XSD
The rules for validation of the dkhm:orderConfirmationToken have been sharpened, limiting the EPOCH token to be specified as seconds as the supported resolution. See EPP Service Specification
All EPP implementation details described in this announcement are documented in version 4.0 of the EPP Service Specification