Internet Engineering Task Force | W.T. Tan |
Internet-Draft | Cloud Registry |
Intended status: Standards Track | G.B. Brown |
Expires: June 07, 2013 | CentralNic Ltd |
J.G. Gould | |
VeriSign, Inc. | |
December 04, 2012 |
Launch Phase Mapping for the Extensible Provisioning Protocol (EPP)
draft-tan-epp-launchphase-04
This document describes an Extensible Provisioning Protocol (EPP) extension mapping for the provisioning and management of domain names during the launch phase of a domain name registry.
This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79.
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 June 07, 2013.
Copyright (c) 2012 IETF Trust and the persons identified as the document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http:/⁠/⁠trustee.ietf.org/⁠license-⁠info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.
This document describes an extension mapping for version 1.0 of the Extensible Provisioning Protocol (EPP) [RFC5730]. This EPP mapping specifies a flexible schema that can be used to implement several common use cases related to the provisioning and management of launch phase extension in a domain name registry.
It is typical for domain registries to operate in special modes within certain periods of time to facilitate allocation of domain names. This document uses the term "launch phase" and the shorter form "launch" to refer to such a period.
The EPP domain name mapping [RFC5731] is designed for the steady state operation of a registry. During the launch, the interface used at each phase of the launch could be different from what is defined in EPP domain name mapping [RFC5731]. for example, registries typically accept multiple applications for a given domain name during the "sunrise" launch phase, referred to as a launch application. A launch registration is used to refer to a registration made during a launch phase when the server uses a first-come-first-serve model. Even in a first-come-first-serve model additional steps and information might be required to support a launch phase, like the passing of trademark information on a create. In addition, the Proposed Trademark Claims Model defines a registry interface for the Trademark Claims or "claims" launch phase that includes support for presenting a Trademark Claims Notice to the Registrant. This document proposes an extension to the domain name extension in order to unambiguously manage the various launch phases known.
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].
XML is case sensitive. Unless stated otherwise, XML specifications and examples provided in this document MUST be interpreted in the character case presented in order to develop a conforming implementation.
"launch-1.0" is used as an abbreviation for "urn:ietf:params:xml:ns:launch-1.0". The XML namespace prefix "launch" 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.
"signedMark-1.0" is used as an abbreviation for "urn:ietf:params:xml:ns:signedMark-1.0". The XML namespace prefix "smd" 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.
"mark-1.0" is used as an abbreviation for "urn:ietf:params:xml:ns:mark-1.0". The XML namespace prefix "mark" 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.
This extension adds additional elements to the EPP domain name mapping [RFC5731]. Only those new elements are described here.
Servers MAY allow multiple applications, referred to as a launch application, of a given domain name during its launch phase operations. Upon receiving a request to create a domain name, the server creates an application object corresponding to the request and assigns an application identifier for the application and returns it to the client with the <launch:applicationID> element. In order to facilitate correlation, all subsequent launch operations on the application object MUST be qualified by the previously assigned application identifier using the <launch:applicationID> element.
The server MAY support multiple launch phases sequentially or simultaneously. The <launch:phase> element MUST be included by the client to define the target launch phase of the command.
The following launch phase values are defined:
For extensibility the <launch:phase> element includes an OPTIONAL "name" attribute that can define a sub-phase or the full name of the phase when the <launch:phase> element has the "custom" value. For example, the "claims1" launch phase could have two sub-phases that include "landrush" and "open".
A launch application object MAY have a status value. The <launch:status> element is used to convey extended status pertaining to the application object, beyond what is specified in the object mapping for this application object.
The following status values are defined using the required "s" attribute:
Each status value MAY be accompanied by a string of human-readable text that describes the rationale for the status applied to the object. The OPTIONAL "lang" attribute MAY be present to identify the language if the negotiated value is something other than the default value of "en" (English).
For extensibility the <launch:status> element includes an OPTIONAL "name" attribute that can define a sub-status or the full name of the status when the status value is "custom". The server SHOULD NOT use of the "custom" status value.
Certain status values MAY be combined. For example, an application can be invalid and rejected. Additionally certain statuses MAY be skipped. For example, an application MAY immediately start at the allocated status or an application MAY skip the pendingAuction status if server does not support an auction. If a <domain:create> processes a request synchronously without the use of an intermediate application, than an Application Identifier [applicationID] is not needed along with the application status.
| request v +---------+ | pending | +----+----+ | | +--------------+-----+-----------+--------------+ | | | | v v v v +-----------+ +---------+ +-------+ +-------+ | | | | / \ / \ | validated | | invalid +----->| rejected | | allocated | | | | | \ / \ / +----+------+ +----+----+ +-------+ +-------+ | | ^ ^ | | | | | +-----------------+ | | | | +---------------------------------+ | | ^ | | | | | +--------+-------+ | | | | | +----------------------->| pendingAuction +------+ | | +----------------+
Figure 1
A server MUST support one of four models for validating the trademark information:
More than one <launch:codeMark>, <smd:signedMark>, or <smd:encodedSignedMark> element MAY be specified. The maximum number of marks per domain name is up to server policy.
The <launch:codeMark> element that is used by the "code", "mark", and "code with mark" validation models, has the following child elements:
The following is an example <launch:codeMark> element with both a <launch:code> and <launch:mark> element.
<launch:codeMark> <launch:code>49FD46E6C4B45C55D4AC</launch:code> <mark:mark xmlns:mark="urn:ietf:params:xml:ns:mark-1.0"> <mark:name>Example One</mark:name> <mark:label>example-one</mark:label> <mark:label>exampleone</mark:label> <mark:issuer>IP Clearinghouse</mark:issuer> <mark:number>GE 3933232</mark:number> <mark:type>REG-TM-WORD</mark:type> <mark:class>1</mark:class> <mark:entitlement>owner</mark:entitlement> <mark:regDate>2011-09-09</mark:regDate> <mark:effectiveDate>2011-10-09</mark:effectiveDate> <mark:exDate>2013-09-09</mark:exDate> <mark:country>AU</mark:country> <mark:region>VIC</mark:region> <mark:owner> <mark:org>Example Inc.</mark:org> </mark:owner> <mark:contact> <mark:name>John Doe</mark:name> <mark:org>Example Inc.</mark:org> <mark:addr> <mark:street>123 Example Dr.</mark:street> <mark:street>Suite 100</mark:street> <mark:city>Reston</mark:city> <mark:sp>VA</mark:sp> <mark:pc>20190</mark:pc> <mark:cc>US</mark:cc> </mark:addr> <mark:voice x="1234">+1.7035555555</mark:voice> <mark:fax>+1.7035555556</mark:fax> <mark:email>jdoe@example.tld</mark:email> </mark:contact> </mark:mark> </launch:codeMark>
A <mark:mark> element describes an applicant's prior right to a given domain name that is used with the "mark", "mark with code", and the "signed mark" validation models.
The child elements of the <mark:mark> element include:
All of the child elements are OPTIONAL. Server policy may place additional constraints on the format and requirements of such elements.
The contact information contained within the Mark [mark] cannot be defined via a contact identifier as defined in the EPP contact mapping [RFC5733] since it is contact information defined outside of the server. Some of the contact elements defined in EPP contact mapping [RFC5733] are replicated in this extension.
The child elements of a contact using either the <mark:owner> or <mark:contact> elements include:
All of the child elements are OPTIONAL. Server policy may place additional constraints on the format and requirements of such elements.
Digital signatures MAY be used by the server to validate either the mark information, when using the "signed mark" validation model with the <smd:signedMark> element or the <smd:encodedSignedMark> element. The digital signatures are handled using an XML Signature around the entire <smd:signedMark> element. The <smd:encodedSignedMark> element includes an encoded form of the <smd:signedMark> element like the use of "base64" encoding. Once the digital signature is validated using the appropriate public key, the server can trust all of the information included in the <smd:signedMark> element. It's up to server policy how the public key is transferred.
To have the digital signature cover all of the elements of the <smd:signedMark> element, the XML Signature IDREF URI is set to the "id" attribute value of the <smd:signedMark> element and the Transform "http://www.w3.org/2000/09/xmldsig#enveloped-signature" is used. The digital signature covers the <smd:signedMark> element and the Signature element is embedded in the <smd:signedMark> element.
The <smd:signedMark> is the fragment of XML that is digitally signed using XML Signature. The <smd:signedMark> includes a required "id" attribute of type XSD ID for use with an IDREF URI from the Signature element. The child elements of the <smd:signedMark> element include:
The following is an example <smd:signedMark> using the XML Signature to sign all of the elements of <smd:signedMark> element.
<smd:signedMark id="signedMark" xmlns:smd="urn:ietf:params:xml:ns:signedMark-1.0"> <smd:serial>123456</smd:serial> <smd:zone>newtld</smd:zone> <smd:exDate>2012-08-16T09:00:00.0Z</smd:exDate> <mark:mark xmlns:mark="urn:ietf:params:xml:ns:mark-1.0"> <mark:name>Example One</mark:name> <mark:label>example-one</mark:label> <mark:label>exampleone</mark:label> <mark:issuer>IP Clearinghouse</mark:issuer> <mark:number>GE 3933232</mark:number> <mark:type>REG-TM-WORD</mark:type> <mark:class>1</mark:class> <mark:entitlement>owner</mark:entitlement> <mark:regDate>2011-09-09</mark:regDate> <mark:effectiveDate>2011-10-09</mark:effectiveDate> <mark:exDate>2013-09-09</mark:exDate> <mark:country>AU</mark:country> <mark:region>VIC</mark:region> <mark:owner> <mark:org>Example Inc.</mark:org> </mark:owner> <mark:contact> <mark:name>John Doe</mark:name> <mark:org>Example Inc.</mark:org> <mark:addr> <mark:street>123 Example Dr.</mark:street> <mark:street>Suite 100</mark:street> <mark:city>Reston</mark:city> <mark:sp>VA</mark:sp> <mark:pc>20190</mark:pc> <mark:cc>US</mark:cc> </mark:addr> <mark:voice x="1234">+1.7035555555</mark:voice> <mark:fax>+1.7035555556</mark:fax> <mark:email>jdoe@example.tld</mark:email> </mark:contact> </mark:mark> <dsig:Signature xmlns:dsig="http://www.w3.org/2000/09/xmldsig#"> <dsig:SignedInfo> <dsig:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/> <dsig:SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/> <dsig:Reference URI="#signedMark"> <dsig:Transforms> <dsig:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/> </dsig:Transforms> <dsig:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/> <dsig:DigestValue>6651T5s9GZgQOxifdCFmDfSIoUc=</dsig:DigestValue> </dsig:Reference> </dsig:SignedInfo> <dsig:SignatureValue> Gm7RnEb6jcijKcgmwEmxJ6j1L0vt2wFyXv3oKc9 a4b8nMOKdec8S3tG2hSx/NZa0RFHvx5zMsH/M jmxzrTBbl5d7W8Qql5VsW4XanSjJ+UgILs9k6XgVtZE2EvffMLBiL4xbCJM48ew RYRY7lVEzoNms91pmm3U5IlNRNjU/YFqZ1pXhhrhyhPjSi9Uon8FnAJaiBEfHcj G6815IJV/9RT+MTXri7i0s82CqIS4wDGbGpyZAs7/kDY3A3upqSOwTtrFSCFX1F +Craec72lBB/dKJHxmoVkbIO5KQhqIOd+E+h2kguE++RHKa4xoBIeyTgWqpWcLu MoFpM+GxwFcpSA== </dsig:SignatureValue> </dsig:Signature> </smd:signedMark>
The <smd:encodedSignedMark> element contains an encoded form of the digitally signed <smd:signedMark> element, described in Section 2.7.1, with the encoding defined by the "encoding" attribute with the default "encoding" value of "base64". The "base64" encoded text of the <smd:encodedSignedMark> element MUST conform to [RFC2045].
The following is an example an <smd:encodedSignedMark> element that uses the default "base64" for encoding a <smd:signedMark> element.
<smd:encodedSignedMark xmlns:smd="urn:ietf:params:xml:ns:signedMark-1.0"> D94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48c21kOnN pZ25lZE1hcmsgeG1sbnM6c21kPSJ1cm46aWV0ZjpwYXJhbXM6eG1sOm5zO nNpZ25lZE1hcmstMS4wIiBpZD0ic2lnbmVkTWFyayI-PHNtZDpzZXJpYWw -MTIzNDU2PC9zbWQ6c2VyaWFsPjxzbWQ6ZXhEYXRlPjIwMTItMTEtMjlUM Tg6MTY6NTQuMDg4MFo8L3NtZDpleERhdGU-PG1hcms6bWFyayB4bWxuczp tYXJrPSJ1cm46aWV0ZjpwYXJhbXM6eG1sOm5zOm1hcmstMS4wIj48bWFya zpuYW1lPkV4YW1wbGUgT25lPC9tYXJrOm5hbWU-PG1hcms6bGFiZWw-ZXh hbXBsZS1vbmU8L21hcms6bGFiZWw-PG1hcms6bGFiZWw-ZXhhbXBsZW9uZ TwvbWFyazpsYWJlbD48bWFyazppc3N1ZXI-SVAgQ2xlYXJpbmdob3VzZTw vbWFyazppc3N1ZXI-PG1hcms6bnVtYmVyPkdFIDM5MzMyMzI8L21hcms6b nVtYmVyPjxtYXJrOm51bWJlcj5vd25lcjwvbWFyazpudW1iZXI-PG1hcms 6cmVnRGF0ZT4yMDEyLTExLTI5VDE4OjE2OjU0LjA3NDZaPC9tYXJrOnJlZ 0RhdGU-PG1hcms6ZXhEYXRlPjIwMTItMTEtMjlUMTg6MTY6NTQuMDc0Nlo 8L21hcms6ZXhEYXRlPjxtYXJrOmNvdW50cnk-QVU8L21hcms6Y291bnRye T48bWFyazpyZWdpb24-VklDPC9tYXJrOnJlZ2lvbj48L21hcms6bWFyaz4 8ZHNpZzpTaWduYXR1cmUgeG1sbnM6ZHNpZz0iaHR0cDovL3d3dy53My5vc mcvMjAwMC8wOS94bWxkc2lnIyI-PGRzaWc6U2lnbmVkSW5mbz48ZHNpZzp DYW5vbmljYWxpemF0aW9uTWV0aG9kIEFsZ29yaXRobT0iaHR0cDovL3d3d y53My5vcmcvVFIvMjAwMS9SRUMteG1sLWMxNG4tMjAwMTAzMTUjV2l0aEN vbW1lbnRzIi8-PGRzaWc6U2lnbmF0dXJlTWV0aG9kIEFsZ29yaXRobT0ia HR0cDovL3d3dy53My5vcmcvMjAwMC8wOS94bWxkc2lnI3JzYS1zaGExIi8 -PGRzaWc6UmVmZXJlbmNlIFVSST0iI3NpZ25lZE1hcmsiPjxkc2lnOlRyY W5zZm9ybXM-PGRzaWc6VHJhbnNmb3JtIEFsZ29yaXRobT0iaHR0cDovL3d 3dy53My5vcmcvMjAwMC8wOS94bWxkc2lnI2VudmVsb3BlZC1zaWduYXR1c mUiLz48L2RzaWc6VHJhbnNmb3Jtcz48ZHNpZzpEaWdlc3RNZXRob2QgQWx nb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjc 2hhMSIvPjxkc2lnOkRpZ2VzdFZhbHVlPktIdVFrdFdUMnRYbXg4Y2ZWd2N vZ0JSUm5oRT08L2RzaWc6RGlnZXN0VmFsdWU-PC9kc2lnOlJlZmVyZW5jZ T48L2RzaWc6U2lnbmVkSW5mbz48ZHNpZzpTaWduYXR1cmVWYWx1ZT5RdWk 2d2xLVUlRcHMxS2N6ajhUaTVuNTBjaTVDc2pML2k2YjBwS0Z2NG16ZENhc WpWcXVvVDFiSzJCZnhKNG0rbXJiOWxLeFlrVnNFCnB4QnloSG5KSHpSMXV 1MG1NMmt4VURyWkVCc0dpV3FuaHMzQVBxOTJBcVdGZHZnUmV6ZHcycmNVb Vg3dGJyeWNGM3ZDMEJmRUg4RHoKb2FIUFRQb24xTUxObzF5bGtYTDA5bWJ qTHVhRlJSS3Z2UCs4djQ1VFJXRmkrbVJ0akJvMGg4blFiNTNtR2lKaU1Oe kFDaDBtK3pFeAp2bmxEUmRpdWJFZVVWbG9LV2dMY1BiSkd4QmFWL1gvQjQ vRnVRbXEzclcxaXNZOUlEYzA3U3ZheEZ0a1l4emVra25GQkNCSWNibXFTC nlOckMvOEp4Y2RRSHN0TUZWc1Z2SjdWUFJqS2VZM0RLcUwrTGhRPT08L2R zaWc6U2lnbmF0dXJlVmFsdWU-PC9kc2lnOlNpZ25hdHVyZT48L3NtZDpza WduZWRNYXJrPg </smd:encodedSignedMark>
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 the Launch Phase Extension.
This mapping is designed to be flexible, requiring only a minimum set of required elements.
While it is meant to serve several use cases, it does not prescribe any interpretation by the client or server. Such processing is typically highly policy-dependent and therefore specific to implementations.
Operations on application objects are done via one or more of the existing EPP verbs defined in the EPP domain name mapping [RFC5731]. Registries may choose to support a subset of the operations.
This extension defines additional elements to extend the EPP <check> command and response to be used in conjunction with the EPP domain name mapping [RFC5731].
This extension defines a new command called the Claims Check Command that is used to determine whether or not there are any matching trademarks, in the specified launch phase, for each domain name passed in the command. The availability check information defined in the EPP domain name mapping [RFC5731] MUST NOT be returned for the Claims Check Command. Instead of returning whether the domain name is available the Claims Check Command will return whether or not at least one matching trademark exists for the domain name. If there is at least one matching trademark that exists for the domain name a <launch:claimKey> element is returned. The value of that the <launch:claimKey> element can be used with an info service of a third party trademark provider like the Trademark Clearinghouse (TMCH) for getting the information needed to generate the trademark claims notice. The third party trademark provider should also return a unique notice identifier that can be passed in the <launch:noticeID> element of the extension to the Create Command [createCommand]. The <domain:name> elements in the EPP <check> command of EPP domain name mapping [RFC5731] define the domain names to check for matching trademarks. The <launch:check> element contains the following child elements:
Example Claims Check Command using the <check> domain command and the <launch:check> extension to determine if "example1.tld" and "example2.tld" have any matching trademarks during the "claims1" launch phase.
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <command> <check> <domain:check xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <domain:name>example1.tld</domain:name> <domain:name>example2.tld</domain:name> </domain:check> </check> <extension> <launch:check xmlns:launch="urn:ietf:params:xml:ns:launch-1.0"> <launch:phase>claims1</launch:phase> </launch:check> </extension> <clTRID>ABC-12345</clTRID> </command> </epp>
Example Claims Check Command using the <check> domain command and the <launch:check> extension to determine if "example3.tld" and "example4.tld" have any matching trademarks that opted into the "claims2" launch phase.
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <command> <check> <domain:check xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <domain:name>example3.tld</domain:name> <domain:name>example4.tld</domain:name> </domain:check> </check> <extension> <launch:check xmlns:launch="urn:ietf:params:xml:ns:launch-1.0"> <launch:phase>claims2</launch:phase> </launch:check> </extension> <clTRID>ABC-12345</clTRID> </command> </epp>
If the <check> command has been processed successfully, the EPP <resData> element MUST contains a child <launch:chkData> element that identifies the launch namespace. The <launch:chkData> element contains the following child elements:
Example Claims Check Response when no matching trademarks are found for the domain name example1.tld and matching trademarks are found for the domain name example2.tld for the "claims1" launch phase.
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <response> <result code="1000"> <msg>Command completed successfully</msg> </result> <resData> <launch:chkData xmlns:launch="urn:ietf:params:xml:ns:launch-1.0"> <launch:phase>claims1</launch:phase> <launch:cd> <launch:name exists="0">example1.tld</launch:name> </launch:cd> <launch:cd> <launch:name exists="1">example2.tld</launch:name> <launch:claimKey>abc123</launch:claimKey> </launch:cd> </launch:chkData> </resData> <trID> <clTRID>ABC-12345</clTRID> <svTRID>54322-XYZ</svTRID> </trID> </response> </epp>
Example Claims Check Response when no matching trademarks are found for the domain name example3.tld and matching trademarks are found for the domain name example4.tld for the "claims2" launch phase.
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <response> <result code="1000"> <msg>Command completed successfully</msg> </result> <resData> <launch:chkData xmlns:launch="urn:ietf:params:xml:ns:launch-1.0"> <launch:phase>claims2</launch:phase> <launch:cd> <launch:name exists="0">example3.tld</launch:name> </launch:cd> <launch:cd> <launch:name exists="1">example4.tld</launch:name> <launch:claimKey>abc123</launch:claimKey> </launch:cd> </launch:chkData> </resData> <trID> <clTRID>ABC-12345</clTRID> <svTRID>54322-XYZ</svTRID> </trID> </response> </epp>
This extension defines additional elements to extend the EPP <info> command and response to be used in conjunction with the EPP domain name mapping [RFC5731].
The EPP <info> command is used to retrieve information for a launch phase registration or application. The Application Identifier [applicationID] returned in the <launch:creData> element of the Create Response [createCommand] is used for retrieving information for a launch application. A <launch:info> element is sent along with the regular <info> domain command. The <launch:info> element contains the following child elements:
Example <info> domain command with the <launch:info> extension to retrieve information for the sunrise application for example.tld and application identifier "abc123".
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <command> <info> <domain:info xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <domain:name>example.tld</domain:name> </domain:info> </info> <extension> <launch:info xmlns:launch="urn:ietf:params:xml:ns:launch-1.0"> <launch:phase>sunrise</launch:phase> <launch:applicationID>abc123</launch:applicationID> </launch:info> </extension> <clTRID>ABC-12345</clTRID> </command> </epp>
Example <info> domain command with the <launch:info> extension to retrieve information for the sunrise registration for example.tld.
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <command> <info> <domain:info xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <domain:name>example.tld</domain:name> </domain:info> </info> <extension> <launch:info xmlns:launch="urn:ietf:params:xml:ns:launch-1.0"> <launch:phase>sunrise</launch:phase> </launch:info> </extension> <clTRID>ABC-12345</clTRID> </command> </epp>
If the query was successful, the server replies with an <launch:infData> element along with the regular EPP <resData>. The <launch:infData> contains the following child elements:
Example <info> domain response using the <launch:infData> extension with the mark information.
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <response> <result code="1000"> <msg>Command completed successfully</msg> </result> <resData> <domain:infData xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <domain:name>example.tld</domain:name> <domain:roid>EXAMPLE1-REP</domain:roid> <domain:status s="pendingCreate"/> <domain:registrant>jd1234</domain:registrant> <domain:contact type="admin">sh8013</domain:contact> <domain:contact type="tech">sh8013</domain:contact> <domain:clID>ClientX</domain:clID> <domain:crID>ClientY</domain:crID> <domain:crDate>2012-04-03T22:00:00.0Z</domain:crDate> <domain:authInfo> <domain:pw>2fooBAR</domain:pw> </domain:authInfo> </domain:infData> </resData> <extension> <launch:infData xmlns:launch="urn:ietf:params:xml:ns:launch-1.0"> <launch:phase>sunrise</launch:phase> <launch:applicationID>abc123</launch:applicationID> <launch:status s="pending"/> <mark:mark xmlns:mark="urn:ietf:params:xml:ns:mark-1.0"> <mark:name>Hello</mark:name> <mark:issuer>IP Clearinghouse</mark:issuer> <mark:number>GE 3933232</mark:number> <mark:type>REG-TM-WORD</mark:type> <mark:class>1</mark:class> <mark:entitlement>owner</mark:entitlement> <mark:regDate>2011-09-09</mark:regDate> <mark:effectiveDate>2011-10-09</mark:effectiveDate> <mark:exDate>2013-09-09</mark:exDate> <mark:country>AU</mark:country> <mark:region>VIC</mark:region> <mark:owner> <mark:org>Example Inc.</mark:org> </mark:owner> <mark:contact> <mark:name>John Doe</mark:name> <mark:org>Example Inc.</mark:org> <mark:addr> <mark:street>123 Example Dr.</mark:street> <mark:street>Suite 100</mark:street> <mark:city>Reston</mark:city> <mark:sp>VA</mark:sp> <mark:pc>20190</mark:pc> <mark:cc>US</mark:cc> </mark:addr> <mark:voice x="1234">+1.7035555555</mark:voice> <mark:fax>+1.7035555556</mark:fax> <mark:email>jdoe@example.tld</mark:email> </mark:contact> </mark:mark> </launch:infData> </extension> <trID> <clTRID>ABC-12345</clTRID> <svTRID>54322-XYZ</svTRID> </trID> </response> </epp>
There are two forms of the extension to the EPP <create> command that are dependent on the supported launch phases [phases] as defined below:
The Sunrise Create Form of the extension to the EPP domain name mapping [RFC5731] includes the verifiable trademark information that the server uses to match against the domain name to authorize the domain create. A server MUST support one of four models in Claim Validation Models [validationModels] to verify the trademark information passed by the client.
A <launch:create> element is sent along with the regular <create> domain command. The <launch:create> element contains the following child elements:
Following is an example <create> domain command using the <launch:create> extension, following the "code" validation model, with multiple sunrise codes.
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <command> <create> <domain:create xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <domain:name>example.tld</domain:name> <domain:registrant>jd1234</domain:registrant> <domain:contact type="admin">sh8013</domain:contact> <domain:contact type="tech">sh8013</domain:contact> <domain:authInfo> <domain:pw>2fooBAR</domain:pw> </domain:authInfo> </domain:create> </create> <extension> <launch:create xmlns:launch="urn:ietf:params:xml:ns:launch-1.0"> <launch:phase>sunrise</launch:phase> <launch:codeMark> <launch:code>49FD46E6C4B45C55D4AC</launch:code> </launch:codeMark> <launch:codeMark> <launch:code>49FD46E6C4B45C55D4AD</launch:code> </launch:codeMark> <launch:codeMark> <launch:code>49FD46E6C4B45C55D4AE</launch:code> </launch:codeMark> </launch:create> </extension> <clTRID>ABC-12345</clTRID> </command> </epp>
Following is an example <create> domain command using the <launch:create> extension, following the "mark" validation model, with the mark information.
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <command> <create> <domain:create xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <domain:name>exampleone.tld</domain:name> <domain:registrant>jd1234</domain:registrant> <domain:contact type="admin">sh8013</domain:contact> <domain:contact type="tech">sh8013</domain:contact> <domain:authInfo> <domain:pw>2fooBAR</domain:pw> </domain:authInfo> </domain:create> </create> <extension> <launch:create xmlns:launch="urn:ietf:params:xml:ns:launch-1.0"> <launch:phase>sunrise</launch:phase> <launch:codeMark> <mark:mark xmlns:mark="urn:ietf:params:xml:ns:mark-1.0"> <mark:name>Example One</mark:name> <mark:label>example-one</mark:label> <mark:label>exampleone</mark:label> <mark:issuer>IP Clearinghouse</mark:issuer> <mark:number>GE 3933232</mark:number> <mark:type>REG-TM-WORD</mark:type> <mark:class>1</mark:class> <mark:entitlement>owner</mark:entitlement> <mark:regDate>2011-09-09</mark:regDate> <mark:effectiveDate>2011-10-09</mark:effectiveDate> <mark:exDate>2013-09-09</mark:exDate> <mark:country>AU</mark:country> <mark:region>VIC</mark:region> <mark:owner> <mark:org>Example Inc.</mark:org> </mark:owner> <mark:contact> <mark:name>John Doe</mark:name> <mark:org>Example Inc.</mark:org> <mark:addr> <mark:street>123 Example Dr.</mark:street> <mark:street>Suite 100</mark:street> <mark:city>Reston</mark:city> <mark:sp>VA</mark:sp> <mark:pc>20190</mark:pc> <mark:cc>US</mark:cc> </mark:addr> <mark:voice x="1234">+1.7035555555</mark:voice> <mark:fax>+1.7035555556</mark:fax> <mark:email>jdoe@example.tld</mark:email> </mark:contact> </mark:mark> </launch:codeMark> </launch:create> </extension> <clTRID>ABC-12345</clTRID> </command> </epp>
Following is an example <create> domain command using the <launch:create> extension, following the "code with mark" validation model, with a code and mark information.
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <command> <create> <domain:create xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <domain:name>example.tld</domain:name> <domain:registrant>jd1234</domain:registrant> <domain:contact type="admin">sh8013</domain:contact> <domain:contact type="tech">sh8013</domain:contact> <domain:authInfo> <domain:pw>2fooBAR</domain:pw> </domain:authInfo> </domain:create> </create> <extension> <launch:create xmlns:launch="urn:ietf:params:xml:ns:launch-1.0"> <launch:phase>sunrise</launch:phase> <launch:codeMark> <launch:code>49FD46E6C4B45C55D4AC</launch:code> <mark:mark xmlns:mark="urn:ietf:params:xml:ns:mark-1.0"> <mark:name>Hello</mark:name> <mark:issuer>IP Clearinghouse</mark:issuer> <mark:number>GE 3933232</mark:number> <mark:type>REG-TM-WORD</mark:type> <mark:class>1</mark:class> <mark:entitlement>owner</mark:entitlement> <mark:regDate>2011-09-09</mark:regDate> <mark:effectiveDate>2011-10-09</mark:effectiveDate> <mark:exDate>2013-09-09</mark:exDate> <mark:country>AU</mark:country> <mark:region>VIC</mark:region> <mark:owner> <mark:org>Example Inc.</mark:org> </mark:owner> <mark:contact> <mark:name>John Doe</mark:name> <mark:org>Example Inc.</mark:org> <mark:addr> <mark:street>123 Example Dr.</mark:street> <mark:street>Suite 100</mark:street> <mark:city>Reston</mark:city> <mark:sp>VA</mark:sp> <mark:pc>20190</mark:pc> <mark:cc>US</mark:cc> </mark:addr> <mark:voice x="1234">+1.7035555555</mark:voice> <mark:fax>+1.7035555556</mark:fax> <mark:email>jdoe@example.tld</mark:email> </mark:contact> </mark:mark> </launch:codeMark> </launch:create> </extension> <clTRID>ABC-12345</clTRID> </command> </epp>
Following is an example <create> domain command using the <launch:create> extension, following the "signed mark" validation model, with the signed mark information.
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <command> <create> <domain:create xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <domain:name>exampleone.tld</domain:name> <domain:registrant>jd1234</domain:registrant> <domain:contact type="admin">sh8013</domain:contact> <domain:contact type="tech">sh8013</domain:contact> <domain:authInfo> <domain:pw>2fooBAR</domain:pw> </domain:authInfo> </domain:create> </create> <extension> <launch:create xmlns:launch="urn:ietf:params:xml:ns:launch-1.0"> <launch:phase>sunrise</launch:phase> <smd:signedMark id="signedMark" xmlns:smd="urn:ietf:params:xml:ns:signedMark-1.0"> <smd:serial>123456</smd:serial> <smd:exDate>2012-08-16T09:00:00.0Z</smd:exDate> <mark:mark xmlns:mark="urn:ietf:params:xml:ns:mark-1.0"> <mark:name>Example One</mark:name> <mark:label>example-one</mark:label> <mark:label>exampleone</mark:label> <mark:issuer>IP Clearinghouse</mark:issuer> <mark:number>GE 3933232</mark:number> <mark:type>REG-TM-WORD</mark:type> <mark:class>1</mark:class> <mark:entitlement>owner</mark:entitlement> <mark:regDate>2011-09-09</mark:regDate> <mark:effectiveDate>2011-10-09</mark:effectiveDate> <mark:exDate>2013-09-09</mark:exDate> <mark:country>AU</mark:country> <mark:region>VIC</mark:region> <mark:owner> <mark:org>Example Inc.</mark:org> </mark:owner> <mark:contact> <mark:name>John Doe</mark:name> <mark:org>Example Inc.</mark:org> <mark:addr> <mark:street>123 Example Dr.</mark:street> <mark:street>Suite 100</mark:street> <mark:city>Reston</mark:city> <mark:sp>VA</mark:sp> <mark:pc>20190</mark:pc> <mark:cc>US</mark:cc> </mark:addr> <mark:voice x="1234">+1.7035555555</mark:voice> <mark:fax>+1.7035555556</mark:fax> <mark:email>jdoe@example.tld</mark:email> </mark:contact> </mark:mark> <dsig:Signature xmlns:dsig="http://www.w3.org/2000/09/xmldsig#"> <dsig:SignedInfo> <dsig:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/> <dsig:SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/> <dsig:Reference URI="#signedMark"> <dsig:Transforms> <dsig:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/> </dsig:Transforms> <dsig:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/> <dsig:DigestValue>6651T5s9GZgQOxifdCFmDfSIoUc= </dsig:DigestValue> </dsig:Reference> </dsig:SignedInfo> <dsig:SignatureValue> Gm7RnEb6jcijKcgmwEmxJ6j1L0vt2wFyXv3oKc9a4b8nMOKdec8S3tG2hSx /NZa0RFHvx5zMsH/MjmxzrTBbl5d7W8Qql5VsW4XanSjJ+UgILs9k6XgVtZ E2EvffMLBiL4xbCJM48ewRYRY7lVEzoNms91pmm3U5IlNRNjU/YFqZ1pXhh rhyhPjSi9Uon8FnAJaiBEfHcjG6815IJV/9RT+MTXri7i0s82CqIS4wDGbG pyZAs7/kDY3A3upqSOwTtrFSCFX1F+Craec72lBB/dKJHxmoVkbIO5KQhqI Od+E+h2kguE++RHKa4xoBIeyTgWqpWcLuMoFpM+GxwFcpSA== </dsig:SignatureValue> </dsig:Signature> </smd:signedMark> </launch:create> </extension> <clTRID>ABC-12345</clTRID> </command> </epp>
Following is an example <create> domain command using the <launch:create> extension, following the "signed mark" validation model, with the base64 encoded signed mark information.
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <command> <create> <domain:create xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <domain:name>exampleone.tld</domain:name> <domain:registrant>jd1234</domain:registrant> <domain:contact type="admin">sh8013</domain:contact> <domain:contact type="tech">sh8013</domain:contact> <domain:authInfo> <domain:pw>2fooBAR</domain:pw> </domain:authInfo> </domain:create> </create> <extension> <launch:create xmlns:launch="urn:ietf:params:xml:ns:launch-1.0"> <launch:phase>sunrise</launch:phase> <smd:encodedSignedMark xmlns:smd="urn:ietf:params:xml:ns:signedMark-1.0"> D94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48c21kOnNpZ25 lZE1hcmsgeG1sbnM6c21kPSJ1cm46aWV0ZjpwYXJhbXM6eG1sOm5zOnNpZ25lZ E1hcmstMS4wIiBpZD0ic2lnbmVkTWFyayI-PHNtZDpzZXJpYWw-MTIzNDU2PC9 zbWQ6c2VyaWFsPjxzbWQ6ZXhEYXRlPjIwMTItMTEtMjlUMTg6MTY6NTQuMDg4M Fo8L3NtZDpleERhdGU-PG1hcms6bWFyayB4bWxuczptYXJrPSJ1cm46aWV0Zjp wYXJhbXM6eG1sOm5zOm1hcmstMS4wIj48bWFyazpuYW1lPkV4YW1wbGUgT25lP C9tYXJrOm5hbWU-PG1hcms6bGFiZWw-ZXhhbXBsZS1vbmU8L21hcms6bGFiZWw -PG1hcms6bGFiZWw-ZXhhbXBsZW9uZTwvbWFyazpsYWJlbD48bWFyazppc3N1Z XI-SVAgQ2xlYXJpbmdob3VzZTwvbWFyazppc3N1ZXI-PG1hcms6bnVtYmVyPkd FIDM5MzMyMzI8L21hcms6bnVtYmVyPjxtYXJrOm51bWJlcj5vd25lcjwvbWFya zpudW1iZXI-PG1hcms6cmVnRGF0ZT4yMDEyLTExLTI5VDE4OjE2OjU0LjA3NDZ aPC9tYXJrOnJlZ0RhdGU-PG1hcms6ZXhEYXRlPjIwMTItMTEtMjlUMTg6MTY6N TQuMDc0Nlo8L21hcms6ZXhEYXRlPjxtYXJrOmNvdW50cnk-QVU8L21hcms6Y29 1bnRyeT48bWFyazpyZWdpb24-VklDPC9tYXJrOnJlZ2lvbj48L21hcms6bWFya z48ZHNpZzpTaWduYXR1cmUgeG1sbnM6ZHNpZz0iaHR0cDovL3d3dy53My5vcmc vMjAwMC8wOS94bWxkc2lnIyI-PGRzaWc6U2lnbmVkSW5mbz48ZHNpZzpDYW5vb mljYWxpemF0aW9uTWV0aG9kIEFsZ29yaXRobT0iaHR0cDovL3d3dy53My5vcmc vVFIvMjAwMS9SRUMteG1sLWMxNG4tMjAwMTAzMTUjV2l0aENvbW1lbnRzIi8-P GRzaWc6U2lnbmF0dXJlTWV0aG9kIEFsZ29yaXRobT0iaHR0cDovL3d3dy53My5 vcmcvMjAwMC8wOS94bWxkc2lnI3JzYS1zaGExIi8-PGRzaWc6UmVmZXJlbmNlI FVSST0iI3NpZ25lZE1hcmsiPjxkc2lnOlRyYW5zZm9ybXM-PGRzaWc6VHJhbnN mb3JtIEFsZ29yaXRobT0iaHR0cDovL3d3dy53My5vcmcvMjAwMC8wOS94bWxkc 2lnI2VudmVsb3BlZC1zaWduYXR1cmUiLz48L2RzaWc6VHJhbnNmb3Jtcz48ZHN pZzpEaWdlc3RNZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yM DAwLzA5L3htbGRzaWcjc2hhMSIvPjxkc2lnOkRpZ2VzdFZhbHVlPktIdVFrdFd UMnRYbXg4Y2ZWd2NvZ0JSUm5oRT08L2RzaWc6RGlnZXN0VmFsdWU-PC9kc2lnO lJlZmVyZW5jZT48L2RzaWc6U2lnbmVkSW5mbz48ZHNpZzpTaWduYXR1cmVWYWx 1ZT5RdWk2d2xLVUlRcHMxS2N6ajhUaTVuNTBjaTVDc2pML2k2YjBwS0Z2NG16Z ENhcWpWcXVvVDFiSzJCZnhKNG0rbXJiOWxLeFlrVnNFCnB4QnloSG5KSHpSMXV 1MG1NMmt4VURyWkVCc0dpV3FuaHMzQVBxOTJBcVdGZHZnUmV6ZHcycmNVbVg3d GJyeWNGM3ZDMEJmRUg4RHoKb2FIUFRQb24xTUxObzF5bGtYTDA5bWJqTHVhRlJ SS3Z2UCs4djQ1VFJXRmkrbVJ0akJvMGg4blFiNTNtR2lKaU1OekFDaDBtK3pFe Ap2bmxEUmRpdWJFZVVWbG9LV2dMY1BiSkd4QmFWL1gvQjQvRnVRbXEzclcxaXN ZOUlEYzA3U3ZheEZ0a1l4emVra25GQkNCSWNibXFTCnlOckMvOEp4Y2RRSHN0T UZWc1Z2SjdWUFJqS2VZM0RLcUwrTGhRPT08L2RzaWc6U2lnbmF0dXJlVmFsdWU -PC9kc2lnOlNpZ25hdHVyZT48L3NtZDpzaWduZWRNYXJrPg </smd:encodedSignedMark> </launch:create> </extension> <clTRID>ABC-12345</clTRID> </command> </epp>
If the create was successful, the server MAY reply with the <launch:creData> element along with the regular EPP <resData> to indicate the server generated Application Identifier [applicationID] when multiple applications of a given domain name is supported; otherwise no extension is included with the regular EPP <resData>. The <launch:creData> element contains the following child elements:
An example response when multiple overlapping applications are supported by the server.
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <response> <result code="1000"> <msg>Command completed successfully</msg> </result> <resData> <domain:creData xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <domain:name>example.tld</domain:name> <domain:crDate>2010-08-10T15:38:26.623854Z</domain:crDate> <domain:exDate>2012-08-10T15:38:26.623854Z</domain:exDate> </domain:creData> </resData> <extension> <launch:creData xmlns:lp="urn:ietf:params:xml:ns:launchphase-1.0"> <launch:phase>sunrise</launch:phase> <launch:applicationID>2393-9323-E08C-03B1</launch:applicationID> </launch:creData> </extension> <trID> <clTRID>example:epp:239332</clTRID> <svTRID>server-8551292e23b</svTRID> </trID> </response> </epp>
The Claims Create Form of the extension to the EPP domain name mapping [RFC5731] includes the information related to the acceptance of the claims notice for the "claims1" launch phase and the display of the claims notice for the "claims2" launch phase.
A <launch:create> element is sent along with the regular <create> domain command. The <launch:create> element contains the following child elements:
Following is an example <create> domain command using the <launch:create> extension with the <launch:notice> information for the "claims1" claims launch phase.
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <command> <create> <domain:create xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <domain:name>example.tld</domain:name> <domain:registrant>jd1234</domain:registrant> <domain:contact type="admin">sh8013</domain:contact> <domain:contact type="tech">sh8013</domain:contact> <domain:authInfo> <domain:pw>2fooBAR</domain:pw> </domain:authInfo> </domain:create> </create> <extension> <launch:create xmlns:launch="urn:ietf:params:xml:ns:launch-1.0"> <launch:phase>claims1</launch:phase> <launch:notice> <launch:noticeID>49FD46E6C4B45C55D4AC</launch:noticeID> <launch:timestamp>2012-06-19T09:00:00.0Z</launch:timestamp> <launch:source>192.0.2.29</launch:source> </launch:notice> </launch:create> </extension> <clTRID>ABC-12345</clTRID> </command> </epp>
This extension does not define any extension to the response of an <create> domain command for the Claims Create Form. After processing the command, the server replies with a standard EPP response as defined in the EPP domain mapping.
This extension defines additional elements to extend the EPP <update> command to be used in conjunction with the domain name mapping.
A server that does not support allow multiple applications of a given domain name with a Application Identifier [applicationID] during its launch phase operations MUST return an EPP error result code of 2102.
Registry policies permitting, clients may update an application object by submitting an EPP <update> command along with an <launch:update> element to indicate the application object to be updated. The <launch:update> element contains the following child elements:
This extension does not define any extension to the response of an <update> domain command. After processing the command, the server replies with a standard EPP response as defined in the EPP domain mapping.
Following is an example <update> domain command with the <launch:update> extension to add and remove a name server of a sunrise application with the application identifier "abc123".
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <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>example.tld</domain:name> <domain:add> <domain:ns> <domain:hostObj>ns2.example.tld</domain:hostObj> </domain:ns> </domain:add> <domain:rem> <domain:ns> <domain:hostObj>ns1.example.tld</domain:hostObj> </domain:ns> </domain:rem> </domain:update> </update> <extension> <launch:update xmlns:launch="urn:ietf:params:xml:ns:launch-1.0"> <launch:phase>sunrise</launch:phase> <launch:applicationID>abc123</launch:applicationID> </launch:update> </extension> <clTRID>ABC-12345</clTRID> </command> </epp>
An example response that corresponds to the above command.
<?xml version="1.0" encoding="UTF-8"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <response> <result code="1000"> <msg>Command completed successfully</msg> </result> <trID> <clTRID>example:epp:239333</clTRID> <svTRID>server-8551292e23c</svTRID> </trID> </response> </epp>
This extension defines additional elements to extend the EPP <delete> command to be used in conjunction with the domain name mapping.
A server that does not support multiple applications of a given domain name with a Application Identifier [applicationID] during its launch phase operations MUST return an EPP error result code of 2102.
Registry policies permitting, clients MAY withdraw an application by submitting an EPP <delete> command along with an <launch:delete> element to indicate the application object to be deleted. The <launch:delete> element contains the following child elements:
This extension does not define any extension to the response of an <delete> domain command. After processing the command, the server replies with a standard EPP response as defined in the EPP domain mapping.
Following is an example <delete> domain command with the <launch:delete> extension.
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <command> <delete> <domain:delete xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <domain:name>example.tld</domain:name> </domain:delete> </delete> <extension> <launch:delete xmlns:launch="urn:ietf:params:xml:ns:launch-1.0"> <launch:phase>sunrise</launch:phase> <launch:applicationID>abc123</launch:applicationID> </launch:delete> </extension> <clTRID>ABC-12345</clTRID> </command> </epp>
An example response that corresponds to the above command.
<?xml version="1.0" encoding="UTF-8"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> <response> <result code="1000"> <msg>Command completed successfully</msg> </result> <trID> <clTRID>example:epp:239334</clTRID> <svTRID>server-8551292e23d</svTRID> </trID> </response> </epp>
This extension does not define any extension to the EPP <renew> command or response described in the EPP domain name mapping [RFC5731].
This extension does not define any extension to the EPP <transfer> command or response described in the EPP domain name mapping [RFC5731].
Three schemas are presented here. The first schema is the EPP Launch Phase Mapping schema. The second schema is a dependent schema for the Signed Mark. The third schema is a dependent schema for the Mark.
The formal syntax presented here is a complete schema representation of the object mapping suitable for automated validation of EPP XML instances. The BEGIN and END tags are not part of the schema; they are used to note the beginning and ending of the schema for URI registration purposes.
Copyright (c) 2012 IETF Trust and the persons identified as authors of the code. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
BEGIN <?xml version="1.0" encoding="UTF-8"?> <schema targetNamespace="urn:ietf:params:xml:ns:launch-1.0" xmlns:launch="urn:ietf:params:xml:ns:launch-1.0" xmlns:eppcom="urn:ietf:params:xml:ns:eppcom-1.0" xmlns:mark="urn:ietf:params:xml:ns:mark-1.0" xmlns:smd="urn:ietf:params:xml:ns:signedMark-1.0" xmlns="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"> <!-- Import common element types. --> <import namespace="urn:ietf:params:xml:ns:eppcom-1.0" schemaLocation="eppcom-1.0.xsd"/> <import namespace="urn:ietf:params:xml:ns:mark-1.0" schemaLocation="mark-1.0.xsd"/> <import namespace="urn:ietf:params:xml:ns:signedMark-1.0" schemaLocation="signedMark-1.0.xsd"/> <annotation> <documentation> Extensible Provisioning Protocol v1.0 domain name extension schema for the launch phase processing. </documentation> </annotation> <!-- Child elements found in EPP commands. --> <element name="check" type="launch:checkType"/> <element name="info" type="launch:infoType"/> <element name="create" type="launch:createType"/> <element name="update" type="launch:idContainerType"/> <element name="delete" type="launch:idContainerType"/> <!-- Common container of id (identifier) element --> <complexType name="idContainerType"> <sequence> <element name="phase" type="launch:phaseType"/> <element name="applicationID" type="token"/> </sequence> </complexType> <!-- Definition for application identifier --> <simpleType name="applicationIDType"> <restriction base="token"/> </simpleType> <!-- Definition for launch phase. Name is an optional attribute used to extend the phase type. For example, when using the phase type value of &qt;custom>, the name can be used to specify the custom phase. --> <complexType name="phaseType"> <simpleContent> <extension base="launch:phaseTypeValue"> <attribute name="name" type="token"/> </extension> </simpleContent> </complexType> <!-- Enumeration of for launch phase values. --> <simpleType name="phaseTypeValue"> <restriction base="token"> <enumeration value="sunrise"/> <enumeration value="landrush"/> <enumeration value="claims1"/> <enumeration value="claims2"/> <enumeration value="open"/> <enumeration value="custom"/> </restriction> </simpleType> <!-- Definition for the sunrise code --> <simpleType name="codeType"> <restriction base="base64Binary"> <minLength value="1"/> </restriction> </simpleType> <!-- Definition for the notice identifier --> <simpleType name="noticeIDType"> <restriction base="base64Binary"> <minLength value="1"/> </restriction> </simpleType> <!-- Possible status values for sunrise application --> <simpleType name="statusValueType"> <restriction base="token"> <enumeration value="pending"/> <enumeration value="validated"/> <enumeration value="invalid"/> <enumeration value="pendingAuction"/> <enumeration value="allocated"/> <enumeration value="rejected"/> <enumeration value="custom"/> </restriction> </simpleType> <!-- Status type definition --> <complexType name="statusType"> <simpleContent> <extension base="normalizedString"> <attribute name="s" type="launch:statusValueType" use="required"/> <attribute name="lang" type="language" default="en"/> <attribute name="name" type="token"/> </extension> </simpleContent> </complexType> <!-- codeMark Type that contains an optional code with mark information. --> <complexType name="codeMarkType"> <sequence> <element name="code" type="launch:codeType" minOccurs="0"/> <element ref="mark:mark" minOccurs="0"/> </sequence> </complexType> <!-- Child elements for the create command --> <complexType name="createType"> <sequence> <element name="phase" type="launch:phaseType"/> <choice> <element name="codeMark" type="launch:codeMarkType" maxOccurs="unbounded"/> <element ref="smd:signedMark" maxOccurs="unbounded"/> <element ref="smd:encodedSignedMark" maxOccurs="unbounded"/> <element name="notice" type="launch:createNoticeType"/> </choice> </sequence> </complexType> <!-- Child elements of the create notice element. --> <complexType name="createNoticeType"> <sequence> <element name="noticeID" type="launch:noticeIDType"/> <element name="timestamp" type="dateTime"/> <element name="source" type="token"/> </sequence> </complexType> <!-- Child elements of check (Claims Check Command). --> <complexType name="checkType"> <sequence> <element name="phase" type="launch:phaseType"/> </sequence> </complexType> <!-- Child elements of info command. --> <complexType name="infoType"> <sequence> <element name="phase" type="launch:phaseType"/> <element name="applicationID" type="launch:applicationIDType" minOccurs="0"/> </sequence> </complexType> <!-- Child response elements. --> <element name="chkData" type="launch:chkDataType"/> <element name="creData" type="launch:idContainerType"/> <element name="infData" type="launch:infDataType"/> <!-- <check> response elements. --> <complexType name="chkDataType"> <sequence> <element name="phase" type="launch:phaseType"/> <element name="cd" type="launch:cdType" maxOccurs="unbounded"/> </sequence> </complexType> <complexType name="cdType"> <sequence> <element name="name" type="launch:cdNameType"/> <element name="claimKey" type="token" minOccurs="0"/> </sequence> </complexType> <complexType name="cdNameType"> <simpleContent> <extension base="eppcom:labelType"> <attribute name="exists" type="boolean" use="required"/> </extension> </simpleContent> </complexType> <!-- <info> response elemenets --> <complexType name="infDataType"> <sequence> <element name="phase" type="launch:phaseType"/> <element name="applicationID" type="launch:applicationIDType" minOccurs="0"/> <element name="status" type="launch:statusType" minOccurs="0"/> <element ref="mark:mark" minOccurs="0" maxOccurs="unbounded"/> </sequence> </complexType> </schema> END
Copyright (c) 2012 IETF Trust and the persons identified as authors of the code. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
BEGIN <?xml version="1.0" encoding="UTF-8"?> <schema targetNamespace="urn:ietf:params:xml:ns:signedMark-1.0" xmlns:smd="urn:ietf:params:xml:ns:signedMark-1.0" xmlns:mark="urn:ietf:params:xml:ns:mark-1.0" xmlns:dsig="http://www.w3.org/2000/09/xmldsig#" xmlns="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"> <!-- Import common element types. --> <import namespace="http://www.w3.org/2000/09/xmldsig#" schemaLocation="xmldig-core-schema.xsd"/> <import namespace="urn:ietf:params:xml:ns:mark-1.0" schemaLocation="mark-1.0.xsd"/> <annotation> <documentation> Schema for representing a Signed Mark, also referred to as Signed Mark Data (SMD), that includes digitally signed trademark information. </documentation> </annotation> <!-- <smd:signedMark> element definition --> <element name="signedMark" type="smd:signedMarkType"/> <!-- <smd:encodedSignedMark> element definition --> <element name="encodedSignedMark" type="smd:encodedSignedMarkType"/> <!-- <smd:signedMark> child elements --> <complexType name="signedMarkType"> <sequence> <element name="serial" type="token"/> <element name="exDate" type="dateTime" minOccurs="0"/> <element ref="mark:mark"/> <element ref="dsig:Signature"/> </sequence> <attribute name="id" type="ID" use="required"/> </complexType> <!-- <smd:encodedSignedMark> element type --> <complexType name="encodedSignedMarkType"> <simpleContent> <extension base="token"> <attribute name="encoding" type="token" default="base64"/> </extension> </simpleContent> </complexType> </schema> END
Copyright (c) 2012 IETF Trust and the persons identified as authors of the code. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
BEGIN <?xml version="1.0" encoding="UTF-8"?> <schema targetNamespace="urn:ietf:params:xml:ns:mark-1.0" xmlns:mark="urn:ietf:params:xml:ns:mark-1.0" xmlns="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"> <annotation> <documentation> Schema for representing a Trademark, also referred to as Mark. </documentation> </annotation> <!-- <mark:mark> element definition --> <element name="mark" type="mark:markType"/> <!-- <mark:mark> child elements --> <complexType name="markType"> <sequence> <element name="id" type="token" minOccurs="0"/> <element name="name" type="token" minOccurs="0"/> <element name="label" type="mark:labelType" minOccurs="0" maxOccurs="unbounded"/> <element name="issuer" type="token" minOccurs="0"/> <element name="number" type="token" minOccurs="0"/> <element name="type" type="token" minOccurs="0"/> <element name="class" type="integer" minOccurs="0" maxOccurs="unbounded"/> <element name="entitlement" type="token" minOccurs="0"/> <element name="regDate" type="date" minOccurs="0"/> <element name="effectiveDate" type="date" minOccurs="0"/> <element name="exDate" type="date" minOccurs="0"/> <element name="country" type="mark:ccType" minOccurs="0"/> <element name="region" type="token" minOccurs="0"/> <element name="owner" type="mark:contactType" minOccurs="0"/> <element name="contact" type="mark:contactType" minOccurs="0"/> </sequence> </complexType> <!-- DNS label type definition --> <simpleType name="labelType"> <restriction base="token"> <minLength value="1"/> <maxLength value="255"/> </restriction> </simpleType> <!-- Postal code definition --> <simpleType name="pcType"> <restriction base="token"> <maxLength value="16"/> </restriction> </simpleType> <!-- Country code definition --> <simpleType name="ccType"> <restriction base="token"> <length value="2"/> </restriction> </simpleType> <!-- Phone number with extension definition --> <complexType name="e164Type"> <simpleContent> <extension base="mark:e164StringType"> <attribute name="x" type="token"/> </extension> </simpleContent> </complexType> <!-- Phone number with extension definition --> <simpleType name="e164StringType"> <restriction base="token"> <pattern value="(\+[0-9]{1,3}\.[0-9]{1,14})?"/> <maxLength value="17"/> </restriction> </simpleType> <!-- Address (<mark:addr>) child elements --> <complexType name="addrType"> <sequence> <element name="street" type="token" minOccurs="0" maxOccurs="3"/> <element name="city" type="token" minOccurs="0"/> <element name="sp" type="token" minOccurs="0"/> <element name="pc" type="mark:pcType" minOccurs="0"/> <element name="cc" type="mark:ccType" minOccurs="0"/> </sequence> </complexType> <!-- Type used for email addresses --> <simpleType name="minTokenType"> <restriction base="token"> <minLength value="1"/> </restriction> </simpleType> <!-- Contact (<mark:owner> or <mark:contact>) child elements --> <complexType name="contactType"> <sequence> <element name="name" type="token" minOccurs="0"/> <element name="org" type="token" minOccurs="0"/> <element name="addr" type="mark:addrType" minOccurs="0"/> <element name="voice" type="mark:e164Type" minOccurs="0"/> <element name="fax" type="mark:e164Type" minOccurs="0"/> <element name="email" type="mark:minTokenType" minOccurs="0"/> </sequence> </complexType> </schema> END
[to be filled in]
This document uses URNs to describe XML namespaces and XML schemas conforming to a registry mechanism described in [RFC3688]. Three URI assignments have been registered by the IANA.
Registration request for the Launch namespace:
Registration request for the Signed mark namespace:
Registration request for the Mark namespace:
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.
Updates to, and deletion of an application object must be restricted to clients authorized to perform the said operation on the object.
As information contained within an application, or even the mere fact that an application exists may be confidential. Any attempt to operate on an application object by an unauthorized client MUST be rejected with an EPP 2303 (object does not exist) or an appropriate auhorization error. Server policy may allow <info> operation with filtered output by clients other than the sponsoring client, in which case the <domain:infData> and <launch:infData> response SHOULD be filtered to include only fields that are publicly accessible.
[RFC2045] | Freed, N. and N.S. Borenstein, "Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies", RFC 2045, November 1996. |
[RFC2119] | Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. |
[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. |
[RFC5733] | Hollenbeck, S., "Extensible Provisioning Protocol (EPP) Contact Mapping", STD 69, RFC 5733, August 2009. |
[RFC3688] | Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, January 2004. |
[WIPO.ST3] | WIPO, "Recommended standard on two-letter codes for the representation of states, other entities and intergovernmental organizations", March 2007. |