Internet Engineering Task Force Y. Wang
Internet-Draft X. Lee
Intended status: Experimental S. Shen
Expires: June 10, 2011 H. Li
CNNIC
December 7, 2010
Practice of Extensible Provisioning Protocol (EPP)extension mapping for
Chinese Domain Name
draft-wang-epp-extension-cdn-00
Abstract
This document describes a practice of Extensible Provisioning
Protocol (EPP) extension mapping for supporting Chinese domain
names,especially for the variant chinese names. Specified in XML,
this mapping extends the EPP domain name mapping to provide
additional features required by Chinese domain names.
Status of this Memo
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 10, 2011.
Copyright Notice
Copyright (c) 2010 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
Wang, et al. Expires June 10, 2011 [Page 1]
Internet-Draft EPP Extension for CDN December 2010
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 may contain material from IETF Documents or IETF
Contributions published or made publicly available before November
10, 2008. The person(s) controlling the copyright in some of this
material may not have granted the IETF Trust the right to allow
modifications of such material outside the IETF Standards Process.
Without obtaining an adequate license from the person(s) controlling
the copyright in such materials, this document may not be modified
outside the IETF Standards Process, and derivative works of it may
not be created outside the IETF Standards Process, except to format
it for publication as an RFC or to translate it into languages other
than English.
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
2. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 3
3. EPP Command Mapping . . . . . . . . . . . . . . . . . . . . . 3
4. EPP <create> Command . . . . . . . . . . . . . . . . . . . . . 4
5. EPP <update> Command . . . . . . . . . . . . . . . . . . . . . 5
6. Formal Syntax . . . . . . . . . . . . . . . . . . . . . . . . 7
7. Internationalization Considerations . . . . . . . . . . . . . 9
8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 9
9. Security considerations . . . . . . . . . . . . . . . . . . . 9
10. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 9
11. Normative References . . . . . . . . . . . . . . . . . . . . . 9
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 10
Wang, et al. Expires June 10, 2011 [Page 2]
Internet-Draft EPP Extension for CDN December 2010
1. Introduction
As defined in [RFC3743], variant characters occur where a single
conceptual character has two or more graphic representations, which
may or may not be visually similar. Variant domain names contain one
or more characters that have such variants. For a Chinese domain
name, there may be several corresponding varint domain names.
This document describes a practice of Chinese domain name registry to
handle variant domain names, particularly, an Extensible Provisioning
Protocol (EPP) extension mapping which extends the EPP domain
<create> command and <update> command.
Accordding to the policy of this registration practice, a preferred
variant Chinese domain name is delegated to the same registrant
synchronously with the original Chinese domain name applied. The
<create> command is extended to assign the preferred variant names
when the registrants register Chinese domain names. In some cases,
the registrant may require to modify the preferred variant name of
its original name after the delegation. The <update> command is
extended to modifiy the preferred variant domain names when the
registrants need.
2. Terminology
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 [RFC2119].
In examples, "C:" represents lines sent by a protocol client and "S:"
represents lines returned by a protocol server. Indentation and
white space in examples are provided only to illustrate element
relationships and are not a REQUIRED feature of this specification.
XML is case sensitive. Unless stated otherwise, XML specifications
and examples provided in this document MUST be interpreted in the
character case presented to develop a conforming implementation.
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 implementing
Chinese domain name registration via EPP.
Wang, et al. Expires June 10, 2011 [Page 3]
Internet-Draft EPP Extension for CDN December 2010
4. EPP <create> Command
This extension defines additional elements to extend the EPP <create>
command described in the EPP domain mapping [RFC5731] for Chinese
domain name registration.
In addition to the EPP command elements described in the EPP domain
mapping [RFC5731], the <create> command MUST contain an <extension>
element. The <extension> element MUST contain a child <variant:
create> element that identifies the Chinses domain name namespace and
the location of the Chinese domain name schema. The <variant:create>
element contains a single <variant:name> element to indicate the
preferred vaiant domain name.
Example <create> command:
C:<?xml version="1.0" encoding="UTF-8" standalone="no"?>
C:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
C: <command>
C: <create>
C: <domain:create
C: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
C: <domain:name>xn--0zwm56d.xn--fiqs8s</domain:name>
C: <domain:period unit="y">2</domain:period>
C: <domain:registrant>jd1234</domain:registrant>
C: <domain:contact type="admin">sh8013</domain:contact>
C: <domain:contact type="tech">sh8013</domain:contact>
C: <domain:authInfo>
C: <domain:pw>2fooBAR</domain:pw>
C: </domain:authInfo>
C: </domain:create>
C: </create>
C: <extension:
C: <variant:create
C: xmlns:cnDomain="urn:iana:xml:ns: domain-1.0.xsd">
C: <variant:domain>xn--g6w251d.xn--fiqz9s</variant:domain>
C: </variant:create>
C: </extension>
C: <clTRID>ABC-12345</clTRID>
C: </command>
C:</epp>
When an extended <create> command has been processed, the EPP
response is just as described in [RFC5731].
Wang, et al. Expires June 10, 2011 [Page 4]
Internet-Draft EPP Extension for CDN December 2010
Example <create> response:
S:<?xml version="1.0" encoding="UTF-8" standalone="no"?>
S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
S: <response>
S: <result code="1000">
S: <msg>Command completed successfully</msg>
S: </result>
S: <resData>
S: <domain:creData
S: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
S: <domain:name>xn--0zwm56d.xn--fiqs8s</domain:name>
S: <domain:crDate>1999-04-03T22:00:00.0Z</domain:crDate>
S: <domain:exDate>2001-04-03T22:00:00.0Z</domain:exDate>
S: </domain:creData>
S: </resData>
S: <trID>
S: <clTRID>ABC-12345</clTRID>
S: <svTRID>54321-XYZ</svTRID>
S: </trID>
S: </response>
S:</epp>
5. EPP <update> Command
This extension defines additional elements to extend the EPP <update>
command described in the EPP domain mapping [RFC5731] for Chinese
domain name registration.
In addition to the EPP command elements described in the EPP domain
mapping [RFC5731], the <update> command MUST contain an <extension>
element. The <extension> element MUST contain a child <variant:
update> element that identifies the Chinses domain name namespace and
the location of the Chinese domain name schema. The <variant:update>
element contains the following child elements:
An OPTIONAL <variant:add> element that contains attribute values
to be added to the object.
An OPTIONAL <variant:rem> element that contains attribute values
to be removed from the object.
An OPTIONAL <variant:chg> element that contains object attribute
values to be changed.
At least one <variant:add>, <variant:rem>, or <variant:chg> element
MUST be provided. The <variant:add>, <variant:rem> and <variant:chg>
Wang, et al. Expires June 10, 2011 [Page 5]
Internet-Draft EPP Extension for CDN December 2010
elements contain the following child elements:
A <variant:domain> element contains the fully qualified name of
the variant domain name object to be updated.
A <variant:authInfo> element that contains authorization
information associated with the variant domain object.
Example <update> command:
C:<?xml version="1.0" encoding="UTF-8" standalone="no"?>
C:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
C: <command>
C: <update>
C: <domain:update
C: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
C: <domain:name>xn--0zwm56d.xn--fiqs8s<domain:name>
C: <domain:chg>
C: <domain:registrant>sh8013</domain:registrant>
C: <domain:authInfo>
C: <domain:pw>2BARfoo</domain:pw>
C: </domain:authInfo>
C: </domain:chg>
C: </domain:update>
C: </update>
C: <extension>
C: <variant:update
C: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
C: <variant:chg>
C: <variant:domain>xn--g6w251d.xn--fiqz9s</variant:domain>
C: <variant:authInfo>
C: <variant:pw>2BARfoo</variant:pw>
C: </variant:authInfo>
C: </variant:chg>
C: </variant:update>
C: </extension>
C: <clTRID>ABC-12345</clTRID>
C: </command>
C:</epp>
When an extended <update> command has been processed, the EPP
response is just as described in [RFC5731].
Wang, et al. Expires June 10, 2011 [Page 6]
Internet-Draft EPP Extension for CDN December 2010
Example <update> response:
S:<?xml version="1.0" encoding="UTF-8" standalone="no"?>
S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
S: <response>
S: <result code="1000">
S: <msg>Command completed successfully</msg>
S: </result>
S: <trID>
S: <clTRID>ABC-12345</clTRID>
S: <svTRID>54321-XYZ</svTRID>
S: </trID>
S: </response>
S:</epp>
6. Formal Syntax
An EPP object mapping is specified in XML Schema notation. 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.
BEGIN
<?xml version="1.0" encoding="UTF-8"?>
<schema targetNamespace="http://www.cnnic.net.cn/epp/domain-1.0"
xmlns:cdn="http://www.cnnic.net.cn/epp/domain-1.0"
xmlns:epp="urn:iana:xml:ns:epp-1.0"
xmlns:eppcom="urn:iana:xml:ns:eppcom-1.0"
xmlns="http://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified">
<!--
Import common element types.
-->
<import namespace="urn:iana:xml:ns:eppcom-1.0"/>
<import namespace="urn:iana:xml:ns:epp-1.0"/>
<annotation>
<documentation>
Extensible Provisioning Protocol v1.0
CDN Domain Extension Schema v1.0
</documentation>
</annotation>
Wang, et al. Expires June 10, 2011 [Page 7]
Internet-Draft EPP Extension for CDN December 2010
<!--
Child elements found in EPP commands.
-->
<element name="create" type="domainext:createType"/>
<element name="update" type="domainext:updateType"/>
<!--
Child elements of the <domainext:create> command
All elements must be present at time of creation
This label in <extension>
-->
<complexType name="createType">
<sequence>
<element name="variant" type="eppcom:labelType" minOccurs="0"/>
</sequence>
</complexType>
<!--
Child elements of the <domainext:update> command
All elements must be present at time of creation
-->
<complexType name="updateType">
<sequence>
<element name="chg" type="domainext:chgType" minOccurs="0"/>
<element name="add" type="domainext:addRemType" minOccurs="0"/>
<element name="rem" type="domainext:addRemType" minOccurs="0"/>
</sequence>
</complexType>
<complexType name="chgType">
<sequence>
<element name="variant" type="eppcom:labelType" minOccurs="0" />
</sequence>
</complexType>
<complexType name="addRemType">
<sequence>
<element name="variant:domain" type="eppcom:labelType" />
</sequence>
</complexType>
<!--
End of schema.
-->
</schema>
END
Wang, et al. Expires June 10, 2011 [Page 8]
Internet-Draft EPP Extension for CDN December 2010
7. Internationalization Considerations
EPP is represented in XML, which provides native support for encoding
information using the Unicode character set and its more compact
representations including UTF-8. Conformant XML processors recognize
both UTF-8 and UTF-16. Though XML includes provisions to identify
and use other character encodings through use of an "encoding"
attribute in an <?xml?> declaration, use of UTF-8 is RECOMMENDED.
As an extension of the EPP domain mapping, the elements, element
content described in this document MUST inherit the
internationalization conventions used to represent higher-layer
domain and core protocol structures present in an XML instance that
includes this extension.
8. IANA Considerations
to be added.
9. Security considerations
to be added
10. Acknowledgements
to be added
11. Normative References
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[RFC3743] Konishi, K., Huang, K., Qian, H., and Y. Ko, "Joint
Engineering Team (JET) Guidelines for Internationalized
Domain Names (IDN) Registration and Administration for
Chinese, Japanese, and Korean", RFC 3743, April 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.
Wang, et al. Expires June 10, 2011 [Page 9]
Internet-Draft EPP Extension for CDN December 2010
Authors' Addresses
Yan Wang
CNNIC
4 South 4th Street,Zhongguancun,Haidian District
Beijing, Beijing 100190
China
Phone: +86 10 5881 3315
Email: wangy@cnnic.cn
Xiaodong Lee
CNNIC
4 South 4th Street,Zhongguancun,Haidian District
Beijing, Beijing 100190
China
Phone: +86 10 5881 3020
Email: lee@cnnic.cn
Sean Shen
CNNIC
4 South 4th Street,Zhongguancun,Haidian District
Beijing, Beijing 100190
China
Phone: +86 10 5881 3038
Email: shenshuo@cnnic.cn
Hongtao Li
CNNIC
4 South 4th Street,Zhongguancun,Haidian District
Beijing, Beijing 100190
China
Phone: +86 10 5881 3164
Email: lihongtao@cnnic.cn
Wang, et al. Expires June 10, 2011 [Page 10]