Internet Engineering Task Force C. Wright Internet-Draft Q. Pham Intended status: Informational AusRegistry Expires: September 2, 2015 March 2015 Domain Name Price Extension Mapping for the Extensible Provisioning Protocol (EPP) draft-ar-price-domain-epp-mapping-02 Abstract This document describes an Extensible Provisioning Protocol (EPP) extension mapping for the provisioning and management of premium domain names. Status of this Memo This document is an Internet-Draft and is NOT offered in accordance with Section 10 of RFC 2026, and the author does not provide the IETF with any rights other than to publish as an Internet-Draft. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet- Drafts is at http://datatracker.ietf.org/drafts/current/. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." This Internet-Draft will expire on September 2, 2015. Wright & Pham Expires September 2, 2015 [Page 1] Internet-Draft EPP Domain Name Price Information Mapping March 2015 Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 1.1. Conventions Used in This Document . . . . . . . . . . . . 3 2. Object Attributes . . . . . . . . . . . . . . . . . . . . . . 3 2.1. Price . . . . . . . . . . . . . . . . . . . . . . . . . . 4 3. EPP Command Mapping . . . . . . . . . . . . . . . . . . . . . 4 3.1. EPP Query Commands . . . . . . . . . . . . . . . . . . . . 4 3.1.1. EPP Command . . . . . . . . . . . . . . . . . 4 3.1.2. EPP Command . . . . . . . . . . . . . . . . . . 7 3.1.3. EPP Command . . . . . . . . . . . . . . . . 8 3.2. EPP Transform Commands . . . . . . . . . . . . . . . . . . 8 3.2.1. EPP Command . . . . . . . . . . . . . . . . . 8 3.2.2. EPP Command . . . . . . . . . . . . . . . . . 10 3.2.3. EPP Command . . . . . . . . . . . . . . . . . 10 3.2.4. EPP Command . . . . . . . . . . . . . . . . 12 3.2.5. EPP Command . . . . . . . . . . . . . . . . . 14 4. Formal Syntax . . . . . . . . . . . . . . . . . . . . . . . . 15 5. acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 17 6. Security Considerations . . . . . . . . . . . . . . . . . . . 17 7. Normative References . . . . . . . . . . . . . . . . . . . . . 17 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 17 Wright & Pham Expires September 2, 2015 [Page 2] Internet-Draft EPP Domain Name Price Information Mapping March 2015 1. Introduction Registry operators may consider a subset of domain names to be premium and therefore attract a higher registration, renewal, transfer and restore price compared to regular or standard domain names. For example a registry operator may consider all two character domain names to be more valuable (premium) compared to domains names that are 3 characters or more long. Lack of controls in the registration, renewal, transfer and restoration process introduces risk to registrars of on-selling domain names to registrants at a price below their cost. This extension provides a mechanism for registrars to obtain the price of a domain name, not limited to premium domain names, and a mechanism to acknowledge the price charged for the registration, renewal, transfer or restoration of domain names. Acknowledgement takes place at time of registration, transfer, renewal and restoration. Updates to pricing information that affects existing registrations must be provided to registrars using an out of band mechanism. It is RECOMMENDED that acknowledgement by registrars is MANDATORY for premium names to ensure that registrars are aware of the higher cost of premium domain names. This specification does not preclude the publication of a price list. Registrars may prefer an externally accessible list to performing a check before every registration. 1.1. Conventions Used in This Document The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 [RFC2119]. "price-1.1" is used as an abbreviation for "urn:ar:params:xml:ns:price-1.1". The XML namespace prefix "price" is used, but implementations MUST NOT depend on it and instead employ a proper namespace-aware XML parser and serializer to interpret and output the XML documents. 2. Object Attributes This extension adds additional elements to the EPP Domain Name Mapping [RFC5731]. Only those new elements are described here. Wright & Pham Expires September 2, 2015 [Page 3] Internet-Draft EPP Domain Name Price Information Mapping March 2015 2.1. Price This extension defines price elements for the registration, renewal, transfer and restoration of domain names. Prices are expressed for the period requested by the registrar. In some cases the price MAY not reflect the period requested by the registrar depending on the server's business rules where a period does apply to a specific operation such as domain restoration. The prices returned by the server are indicative only and MAY not take into consideration discounts or other factors that would otherwise adjust the price. Registrars SHOULD confirm with server operators any terms that may adjust the price before assuming the actual price charged for the transaction. Price elements SHOULD be expressed in the currency that the registrar normally transacts in, or otherwise negotiated, using an out of band mechanism. 3. EPP Command Mapping A detailed description of the EPP syntax and semantics can be found in the EPP core protocol specification [RFC5730]. The command mappings described here are specifically for use in provisioning premium domain names. 3.1. EPP Query Commands EPP provides three commands to retrieve object information: to determine if an object is known to the server, to retrieve detailed information associated with an object, and to retrieve object transfer status information. 3.1.1. EPP Command This extension defines additional elements to extend the EPP command and response to be used in conjunction with the EPP Domain Name Mapping [RFC5731]. To enable registrars to identify the registration, renewal, transfer and restoration price, the command is extended with a element, which signals a registrar's intention to retrieve a domain name's price information. The extension element MAY contain the following child element: o An OPTIONAL element may be provided to obtain the price information of the domain names for the provided period. If a Wright & Pham Expires September 2, 2015 [Page 4] Internet-Draft EPP Domain Name Price Information Mapping March 2015 period is not provided the server SHOULD determine the price based on a pre-determined business rule. For example, provide the price information based on a 1 year period if no period is provided. Example command requesting domain name price information premium.example non-premium.example invalid 5 ABC-12345 When a command containing the element has been processed successfully, the server MUST NOT respond with the element described in the EPP Domain Name Mapping [RFC5731]. Instead, servers MUST respond with a element that contains one element for each domain name present in the command. The element contains the following child elements: o A element containing a domain name from the corresponding command. The order and composition of names in the response MUST be the same as the order and composition provided in the command, with exception to transformations required of validating XML parsers. An OPTIONAL "premium" attribute indicates whether the name attracts a premium price. o A element containing the price charged for the registration of the domain name based on the period returned. This element MAY be omitted if create price could not be determined. o A element containing the price charged for the renewal of the domain name based on the period returned. This element MAY be omitted if the renewal price can not be determined. Wright & Pham Expires September 2, 2015 [Page 5] Internet-Draft EPP Domain Name Price Information Mapping March 2015 o A element containing the price charged for the transfer of the domain name based on the period returned. This element MAY be omitted if the transfer price can not be determined. o A element containing the price charged for the restoration of the domain name based on the period returned. This element MAY be omitted if the restore price can not be determined. o A element containing the server-specific explanation for price information. The server SHOULD provide a reason if no price is determined. This element MAY be omitted if no reason exists. o A element containing the period to which the price information corresponds to. This element MAY be omitted if it could not be determined. The server SHOULD provide the , , and based on the returned in the response, however there MAY be situations where the period does not apply to specific transactions as pricing MAY not be period based. Wright & Pham Expires September 2, 2015 [Page 6] Internet-Draft EPP Domain Name Price Information Mapping March 2015 Example response providing domain name price information Command completed successfully premium.example 5 100 100 20 40 non-premium.example 5 10 10 2 40 invalid Invalid domain name ABC-12345 54321-XYZ 3.1.2. EPP Command This extension does not define any extension to the EPP command or response described in the EPP Domain Name Mapping [RFC5731]. Wright & Pham Expires September 2, 2015 [Page 7] Internet-Draft EPP Domain Name Price Information Mapping March 2015 3.1.3. EPP Command This extension does not define any extension to the EPP command or response described in the EPP Domain Name Mapping [RFC5731]. 3.2. EPP Transform Commands EPP provides five commands to transform objects: to create an instance of an object, to delete an instance of an object, to extend the validity period of an object, to manage object sponsorship changes, and to change information associated with an object. 3.2.1. EPP Command This extension defines additional elements for the EPP command described in the EPP Domain Name Mapping [RFC5731]. No additional elements are defined for the EPP response. To facilitate the registration of domain names that attract a premium registration price, the command is extended with a element, which signals a registrar's acknowledgement of the premium prices associated with the transaction. The element contains the following child elements: o A element that signals the registrar is aware of a premium price. Registrars MAY include a child element that contains the current premium price for the period requested. If provided, servers SHOULD confirm the information matches the current pricing information for the corresponding domain name. Wright & Pham Expires September 2, 2015 [Page 8] Internet-Draft EPP Domain Name Price Information Mapping March 2015 Example command with simple acknowledgement premium.example ns1.example.net ns2.example.net jd1234 sh8013 sh8013 2fooBAR ABC-12345 Wright & Pham Expires September 2, 2015 [Page 9] Internet-Draft EPP Domain Name Price Information Mapping March 2015 Example command including pricing information in the acknowledgement premium.example ns1.example.net ns2.example.net jd1234 sh8013 sh8013 2fooBAR 100 ABC-12345 Servers that require the use of this extension for the registration of premium names SHOULD return a 2003 "Required parameter missing" error in response to requests for registration of premium names that do not include this extension. 3.2.2. EPP Command This extension does not define any extension to the EPP command or response described in the EPP Domain Name Mapping [RFC5731]. 3.2.3. EPP Command This extension defines additional elements for the EPP command described in the EPP Domain Name Mapping [RFC5731]. No additional elements are defined for the EPP response. Wright & Pham Expires September 2, 2015 [Page 10] Internet-Draft EPP Domain Name Price Information Mapping March 2015 To facilitate the renewal of domain names that attract a premium renewal price, the command is extended with a element, which signals a registrar's acknowledgement of the premium prices associated with the transaction. The element contains the following child elements: o A element that signals the registrar is aware of a premium price. Registrars MAY include a child element that contains the current premium price for the period requested. If provided, servers SHOULD confirm the information matches the current pricing information for the corresponding domain name. Example command with simple acknowledgement domain-name.tld 2010-09-01 5 ABC-12345 Wright & Pham Expires September 2, 2015 [Page 11] Internet-Draft EPP Domain Name Price Information Mapping March 2015 Example command including pricing information in the acknowledgement domain-name.tld 2010-09-01 5 100 ABC-12345 Servers that require the use of this extension for the renewal of premium names SHOULD return a 2003 "Required parameter missing" error in response to requests for renewal of premium names that do not include this extension. 3.2.4. EPP Command This extension defines additional elements for the EPP command described in the EPP Domain Name Mapping [RFC5731]. No additional elements are defined for the EPP response. To enable registrars to transfer domain names that attract a premium price, the command is extended with a element, that signal a registrar's acknowledgement of the premium prices associated with the transaction. The element contains the following child elements: o A element that signals the registrar is aware of a premium price. Registrars MAY include a child element that contains the current transfer premium price. If provided, servers SHOULD confirm the information matches the current pricing information for the corresponding domain name. Wright & Pham Expires September 2, 2015 [Page 12] Internet-Draft EPP Domain Name Price Information Mapping March 2015 Example command with simple acknowledgement premium.example 2fooBAR ABC-12345 Example command including pricing information in the acknowledgement premium.example 2fooBAR 20 ABC-12345 Servers that require the use of this extension for the transfer of Wright & Pham Expires September 2, 2015 [Page 13] Internet-Draft EPP Domain Name Price Information Mapping March 2015 premium names SHOULD return a 2003 "Required parameter missing" error in response to requests for transfer of premium names that do not include this extension. 3.2.5. EPP Command This extension defines additional elements for the EPP command described in the Domain Registry Grace Period Mapping for the Extensible Provisioning Protocol (EPP) [RFC3915]. for the restore request (op=request) for a domain name that is in redemption. No additional elements are defined for the EPP response. To enable registrars to restore domain names that attract a premium price, the command is extended with a element, that signal a registrar's acknowledgement of the premium prices associated with the transaction. The element contains the following child elements: o A element that signals the registrar is aware that a domain name is premium. Registrars MAY include a child element that contains the current restore price. If provided, servers SHOULD confirm the information matches the current pricing information for the corresponding domain name. Example command with simple acknowledgement premium.example ABC-12345 Wright & Pham Expires September 2, 2015 [Page 14] Internet-Draft EPP Domain Name Price Information Mapping March 2015 Example command including pricing information in the acknowledgement premium.example 12.2 ABC-12345 Servers that require the use of this extension for the restoration of premium names SHOULD return a 2003 "Required parameter missing" error in response to requests for restoration of premium names that do not include this extension. 4. Formal Syntax Wright & Pham Expires September 2, 2015 [Page 15] Internet-Draft EPP Domain Name Price Information Mapping March 2015 Wright & Pham Expires September 2, 2015 [Page 16] Internet-Draft EPP Domain Name Price Information Mapping March 2015 5. acknowledgements This document was inspired by Verisign's Premium Domain extension and draws many similarities to increase familiarity and reduce development time. 6. Security Considerations The mapping extensions described in this document do not provide any security services beyond those described by EPP [RFC5730], the EPP Domain Name Mapping [RFC5731], and protocol layers used by EPP. The security considerations described in these other specifications apply to this specification as well. 7. Normative References [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. [RFC3915] Hollenbeck, S., "Domain Registry Grace Period Mapping for the Extensible Provisioning Protocol (EPP)", RFC 3915, September 2004. [RFC5730] Hollenbeck, S., "Extensible Provisioning Protocol (EPP)", STD 69, RFC 5730, August 2009. [RFC5731] Hollenbeck, S., "Extensible Provisioning Protocol (EPP) Domain Name Mapping", STD 69, RFC 5731, August 2009. Wright & Pham Expires September 2, 2015 [Page 17] Internet-Draft EPP Domain Name Price Information Mapping March 2015 Authors' Addresses Chris Wright AusRegistry 8/10 Queens Road Melbourne, Victoria 3004 AU Email: chris@ausregistry.com URI: www.ausregistry.com Quoc Pham AusRegistry 8/10 Queens Road Melbourne, Victoria 3004 AU Email: quoc.pham@ausregistry.com URI: www.ausregistry.com Wright & Pham Expires September 2, 2015 [Page 18]