Network Working Group J. Gould Internet-Draft C. Thippeswamy Intended status: Standards Track Verisign Expires: May 9, 2013 November 5, 2012 Domain Name Registration Data (DNRD) Comma-Separated Values (CSV) Objects Mapping draft-gould-thippeswamy-dnrd-csv-mapping-00 Abstract This document specifies the format and contents of Data Escrow deposits for the standard set of Domain Name Registration Data (DNRD) objects including domain, host, contact, and registrar using XML for definition and Comma-Separated Values (CSV) Files for data. 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 May 9, 2013. Copyright Notice 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. Gould & Thippeswamy Expires May 9, 2013 [Page 1] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 2. Conventions Used in This Document . . . . . . . . . . . . . . 3 3. Object Attributes . . . . . . . . . . . . . . . . . . . . . . 4 3.1. Date and Time . . . . . . . . . . . . . . . . . . . . . . 4 3.2. Country names . . . . . . . . . . . . . . . . . . . . . . 4 3.3. Telephone numbers . . . . . . . . . . . . . . . . . . . . 4 3.4. Internationalized and Localized Elements . . . . . . . . . 4 3.5. IP addresses . . . . . . . . . . . . . . . . . . . . . . . 6 3.6. CSV elements . . . . . . . . . . . . . . . . . . . . . . . 6 4. Protocol Description . . . . . . . . . . . . . . . . . . . . . 11 4.1. Domain Name Object . . . . . . . . . . . . . . . . . . . . 11 4.2. Host Object . . . . . . . . . . . . . . . . . . . . . . . 21 4.3. Contact Object . . . . . . . . . . . . . . . . . . . . . . 24 4.4. Registrar Object . . . . . . . . . . . . . . . . . . . . . 35 4.5. IDN Language Object . . . . . . . . . . . . . . . . . . . 47 5. Formal Syntax . . . . . . . . . . . . . . . . . . . . . . . . 49 5.1. RDE CSV Schema . . . . . . . . . . . . . . . . . . . . . . 49 5.2. Domain Object . . . . . . . . . . . . . . . . . . . . . . 58 5.3. Host Object . . . . . . . . . . . . . . . . . . . . . . . 62 5.4. Contact Object . . . . . . . . . . . . . . . . . . . . . . 64 5.5. Registrar Object . . . . . . . . . . . . . . . . . . . . . 70 5.6. IDN Language Object . . . . . . . . . . . . . . . . . . . 74 5.7. Extension Guidelines . . . . . . . . . . . . . . . . . . . 75 5.8. Internationalization Considerations . . . . . . . . . . . 75 5.9. IANA Considerations . . . . . . . . . . . . . . . . . . . 76 5.10. Security Considerations . . . . . . . . . . . . . . . . . 78 5.11. Acknowledgments . . . . . . . . . . . . . . . . . . . . . 79 5.12. Change History . . . . . . . . . . . . . . . . . . . . . . 79 6. References . . . . . . . . . . . . . . . . . . . . . . . . . . 79 6.1. Normative References . . . . . . . . . . . . . . . . . . . 79 6.2. Informative References . . . . . . . . . . . . . . . . . . 80 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 80 Gould & Thippeswamy Expires May 9, 2013 [Page 2] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 1. Introduction The Registry Data Escrow Specification [1] can be extended to support any type of object that is included in a data escrow. This document defines the data escrow structure of the standard set of objects for Domain Name Registration Data (DNRD), using XML for definition and Comma-Seperated Values (CSV) files for data, which include: Domain: Internet domain names that are typically provisioned in a Domain Name Registry using the EPP domain name mapping [RFC5731]. The attributes defined in the EPP domain name mapping [RFC5731] are fully supported by this document. Host: Internet host names that are typically provisioned in a Domain Name Registry using the EPP host mapping [RFC5732]. The attributes defined in the EPP host mapping [RFC5732] are fully supported by this document. Contact: Individual or organization social information provisioned in a Domain Name Registry using the EPP contact mapping [RFC5733]. The attributes defined in the EPP contact mapping [RFC5733] are fully supported by this document. Registrar: The organization that sponsors objects like domains, hosts, and contacts in a Domain Name Registry. The Registrar MAY also be associated with contacts, referred to as Registrars contacts. IDN language rules: Internationalized Domain Names (IDN) in the Domain Object Data Escrow include references to the languages rules that define the set of character code points allowed for a specific language. Bulk data exports and imports from and to a database is a natural fit for the use of Comma-Seperated Values (CSV) files, but CSV files don't provide any formal description that is a natural fit for the use of XML. This document fully supports the full, incremental, and differential deposits defined in the Registry Data Escrow Specification [1] with a flexible and extensible model for Domain Name Registration Data (DNRD) that leverages Comma-Seperated Values (CSV) files for creating and consuming the deposits in a cost effective manner. 2. Conventions Used in This Document The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this Gould & Thippeswamy Expires May 9, 2013 [Page 3] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 document are to be interpreted as described in RFC 2119 [RFC2119]. 3. Object Attributes 3.1. Date and Time Numerous fields indicate "dates", such as the creation and expiry dates for domains. These fields SHALL contain timestamps indicating the date and time in UTC as specified in [RFC3339], with no offset from the zero meridian. 3.2. Country names Country identifiers SHALL be represented using two character identifiers as specified in [ISO-3166-1]. 3.3. Telephone numbers Telephone numbers (both voice and fax) SHALL be formatted based on structures defined in [ITU-E164]. Telephone numbers described in this specification are character strings that MUST begin with a plus sign ("+", ASCII value 0x002B), followed by a country code defined in [ITU-E164], followed by a dot (".", ASCII value 0x002E), followed by a sequence of digits representing the telephone number. 3.4. Internationalized and Localized Elements Some elements MAY be provided in either internationalized form ("int") or provided in localized form ("loc"). Those elements use a field value or "isLoc" attribute to specify the form used. If an "isLoc" attribute is used, a value of "true" indicates the use of the localized form and a value of "false" indicates the use of the internationalized form. This MAY override the form specified for a parent element. A value of "int" is used to indicate the internationalized form and a value of "loc" is used to indicate the localized form. When the internalized form ("int") is provided, the field value MUST be represented in a subset of UTF-8 that can be represented in the 7-bit US-ASCII character set. When the localized form ("loc") is provided, the field value MAY be represented in unrestricted UTF-8. Some of the field elements below of the "registrar" element specify the internationalized form with the isLoc="false" attribute: Gould & Thippeswamy Expires May 9, 2013 [Page 4] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 ... ... , registrar-YYYYMMDD.csv ... ... The following is an example of using the field value to define the internationalized or localized form of the remainder of the "contactPostal" field values. Gould & Thippeswamy Expires May 9, 2013 [Page 5] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 ... ... , contactPostal-YYYYMMDD.csv ... ... 3.5. IP addresses IP addresses syntax MUST conform either to, Internet Protocol [RFC0791], for IPv4 addresses, or IP Version 6 Addressing Architecture [RFC4291], for IPv6 addresses. 3.6. CSV elements 3.6.1. and elements To support a CSV model with the Registry Data Escrow Specification [1], a element is defined that substitutes for as a child element of a substitute element like the element. A element substitutes for as a child element of the element. The and elements share the following child elements: Gould & Thippeswamy Expires May 9, 2013 [Page 6] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Optional definition of the CSV separator characters with the default separator character of ",". Ordered list of CSV fields used in the CSV files. There is one or more child elements that substitute for the abstract element. Each element defines the format of the CSV field contained in the CSV files. elements by convention support the "type" attribute that defines the XML data type of the field elements, an optional "list" attribute that when "true" indicates that the field is a list with the list elements type defined by the "type" attribute, and an optional "sep" attribute for list fields that defines the list element separator characters with a default seperator of ','. List fields MUST be enclosed in double quotes '"'. By convention all fields are optional, where an undefined field can be represented with an empty field value ",," in the CSV file, where ',' is the seperator character. A list of one or more CSV files using the child element. The child element defines a reference to the CSV file name and has the following optional attributes: compression If the CSV file is compressed, the "compression" attribute defines the compression format like "gzip" or "zip". encoding Defines the encoding of the CSV file with the default encoding of "UTF-8". chksum Defines the checksum CRC (UNIX cksum) of the CSV file. This attribute is used to validate that the full CSV file exists and has not been tampered with. The and elements requires a "name" attribute that defines the purpose of the CSV file with values like "domain", "host", "contact". The supported "name" attribute values are defined for each object type. The following is an example of the element for domain name records. Gould & Thippeswamy Expires May 9, 2013 [Page 7] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 , domain-YYYYMMDD.csv The following is example of the "domain-YYYYMMDD.csv" file with a single record matching the definition. domain1.test,domain1-TEST,0,,0,0,,0,"pendingDelete", "pendingDelete",registrantid,"adminid","techid","billingid", "ns1.example.com,ns1.example.net",clientX,clientY, 1999-04-03T22:00:00.0Z,clientX,2009-12-03T09:05:00.0Z, 2015-04-03T22:00:00.0Z,2fooBAR domain2.test,domain2-TEST,0,,0,0,,0,"ok",,registrantid, "adminid","techid","billingid","ns1.example.com,ns1.example.net", clientX,clientY,2009-04-03T22:00:00.0Z,clientX, 2009-12-03T09:05:00.0Z,2015-04-03T22:00:00.0Z,2fooBAR The following is an example of the element for domain Gould & Thippeswamy Expires May 9, 2013 [Page 8] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 name records. domain-delete-YYYYMMDD.csv The following is example of the "domain-delete-YYYYMMDD.csv" file with a single record and matching the single field. domain1.test domain2.test domainN.test 3.6.2. CSV common field elements The element defined in the and elements (Section 3.6.1) section has child elements that substitute for the abstract element. By convention elements incude an 'f' prefix to identify it as a field definition element. There are a set of common field elements that are used across multiple data escrow objects. The common field elements are defined using the "urn:ietf:params:xml:ns:rdeCsv-1.0" namespace and using the "rdeCsv" sample namespace prefix. The CSV common field elements include: Name field with type="eppcom:labelType". UTF-8 encoded name field with type="eppcom: labelType". Repository Object IDentifier (ROID) field with type="eppcom:roidType". Registrant contact identifier with type="eppcom:clIDType". Gould & Thippeswamy Expires May 9, 2013 [Page 9] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 List of administration contact identifiers with the list elements type="eppcom:clIDType". List of technical contact identifiers with the list elements type="eppcom:clIDType". List of billing contact identifiers with the list elements type="eppcom:clIDType". List of statuses with the list element type="eppcom:statusType". Identifier of client that sponsors the object with type="eppcom:clIDType". Identifier of client that created the object with type="eppcom:clIDType". Identifier of client that updated the object with type="eppcom:clIDType". Identifier of client that requested the transfer with type="eppcom:clIDType". Identifier of client that should take or took action for transfer with type="eppcom:clIDType". Created date of object with type="datetime". Updated date of object with type="datetime". Expiration date of object with type="datetime". Date that transfer was requested with type="datetime". Date that transfer action should be taken or has been taken with type="datetime". Date of last transfer with type="datetime". State of the most recent transfer request with type="eppcom:trStatusType". General token field with type="token". Gould & Thippeswamy Expires May 9, 2013 [Page 10] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 General language field with type="language". General positive integer field with type="positiveInteger". Password authorization info value with type="normalizedString". Custom field with name attribute that defines the custom field name" with type="token". 4. Protocol Description The following is a format for Data Escrow deposits for the standard set of objects for Domain Name Registration Data (DNRD). Format elements are reused from the EPP [RFC5730] and related RFCs. 4.1. Domain Name Object The domain name object is based on the EPP domain name mapping in [RFC5731]. The elements used for the Domain Name Object is defined in this section. The child element of the element is used to hold the domain name objects for the deposit. The and the elements, defined in the " and elements (Section 3.6.1)" section, are used with the following supported "name" attribute values: "domain" Defines the fields and CSV file references used for the domain name object records. The following field elements were added for use in the "domain" element: Boolean flag indicating if the domain name object is an IDN domain name object with type="boolean". Boolean flag indicating if the domain name object is an IDN variant domain name object with type="boolean". Fully qualified name of the original IDN domain name object related to the variant domain name object with type="eppcom:labelType". Gould & Thippeswamy Expires May 9, 2013 [Page 11] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Boolean flag indicating if the domain name object is a reserved domain with type="boolean". List of Registry Grace Period (RGP) status descriptors with the list elements type="rgp:statusType" as defined in [RFC3915]. List of fully qualified names of the delegated host objects associated with the domain name object with the list elements type="eppcom:labelType". The following "rdeCsv" fields, defined in section CSV common field elements (Section 3.6.2), MAY be used in the "domain" and elements: Gould & Thippeswamy Expires May 9, 2013 [Page 12] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Example of a "domain" element: ... ... , domain-YYYYMMDD.csv ... ... Gould & Thippeswamy Expires May 9, 2013 [Page 13] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Example of the corresponding domain-YYYYMMDD.csv file. The file contains four records (active ASCII domain, pendingDelete domain, original IDN with LANG1 language rules, and variant IDN with LANG1 language rules). domain1.test,Ddomain2-TEST,0,,0,0,,0,"ok",,registrantid, "adminid","techid","billingid","ns1.example.com,ns1.example.net", clientX,clientY,2009-04-03T22:00:00.0Z,clientX, 2009-12-03T09:05:00.0Z,2015-04-03T22:00:00.0Z,2fooBAR domain2.test,Ddomain1-TEST,0,,0,0,,0,"pendingDelete","pendingDelete", registrantid,"adminid","techid","billingid", "ns1.example.com,ns1.example.net",clientX,clientY, 1999-04-03T22:00:00.0Z,clientX,2009-12-03T09:05:00.0Z, 2015-04-03T22:00:00.0Z,2fooBAR xn-abc123.test,Dxn-abc123-TEST,1,LANG1,0,1,,0,"ok",, registrantid,"adminid","techid","billingid", "ns1.example.com,ns1.example.net",clientX,clientY, 2009-04-03T22:00:00.0Z,clientX,2009-12-03T09:05:00.0Z, 2015-04-03T22:00:00.0Z,2fooBAR xn-abc321.test,Dxn-abc321-TEST,1,LANG1,1, 0,xn-abc123.test,0,"ok",,registrantid,"adminid", "techid","billingid","ns1.example.com,ns1.example.net", clientX,clientY,2009-04-03T22:00:00.0Z,clientX, 2009-12-03T09:05:00.0Z,2015-04-03T22:00:00.0Z,2fooBAR Example of a "domain" element: ... ... domain-delete-YYYYMMDD.csv ... ... Gould & Thippeswamy Expires May 9, 2013 [Page 14] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Example of the corresponding domain-delete-YYYYMMDD.csv file. The file contains three domain name records. domain1.test domain2.test domainN.test "dnssec" Defines the fields and CSV file referenes used for the domain name object DNSSEC records (DS or Key Data). The following field elements were added for use in the "dnssec" and rdeCsv:fields> elements: Indicates a child's preference for the number of seconds after signature generation when the parent's signature on the DS information provided by the child will expire with type="secDNS:maxSigLifeType" defined in [RFC5910]. Contains the DS key tag value per [RFC5910] with type="unsignedShort". Contains the DS algorithm value per [RFC5910] with type="unsignedByte". Contains the DS digest type value per [RFC5910] with type="unsignedByte". Contains the DS digest value per [RFC5910] with type="hexBinary". Contains the flags field value per [RFC5910] with type="unsignedShort". Contains the Key protocol value per [RFC5910] with type="unsignedByte". Contains the Key algorithm value per [RFC5910] with type="unsignedByte". Contains the public key value per [RFC5910] with type="secDNS:keyType". Gould & Thippeswamy Expires May 9, 2013 [Page 15] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 The following "rdeCsv" fields, defined in section CSV common field elements (Section 3.6.2), MAY be used in the "dnssec" and elements: Example of a "dnssec" element with the DS Data Interface of [RFC5910]: ... , dnssec-YYYYMMDD.csv ... ... Example of the corresponding dnssec-YYYYMMDD.csv file. The file contains two DS records for domain1.test. domain1.test,604800,12345,3,1,49FD46E6C4B45C55D4AC domain1.test,604800,12346,3,1,38EC35D5B3A34B44C39B Gould & Thippeswamy Expires May 9, 2013 [Page 16] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Example of a "dnssec" element with the Key Data Interface of [RFC5910]: ... , dnssec-YYYYMMDD.csv ... ... Example of the corresponding dnssec-YYYYMMDD.csv file. The file contains two key records for domain1.test. domain1.test,604800,257,3,1,AQPJ////4Q== domain1.test,604800,257,3,1,AQPJ////4QQQ Example of a "dnssec" element with the DS Data Interface of [RFC5910]: Gould & Thippeswamy Expires May 9, 2013 [Page 17] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 ... ... dnssec-delete-YYYYMMDD.csv ... ... Example of the corresponding dnssec-delete-YYYYMMDD.csv file. The file contains two DS records for domain1.test. domain1.test,604800,12345,3,1,49FD46E6C4B45C55D4AC domain1.test,604800,12346,3,1,38EC35D5B3A34B44C39B Example of a "dnssec" element with the Key Data Interface of [RFC5910]: Gould & Thippeswamy Expires May 9, 2013 [Page 18] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 ... ... dnssec-delete-YYYYMMDD.csv ... ... Example of the corresponding dnssec-delete-YYYYMMDD.csv file. The file contains two key records for domain1.test. domain1.test,257,3,1,AQPJ////4Q== domain1.test,257,3,1,AQPJ////4QQQ "domainTransfer" Defines the fields and CSV file referenes used for the domain name object pending and completed transfer records. No additional field elements were added for use in the "domainTransfer" element. The following "rdeCsv" fields, defined in section CSV common field elements (Section 3.6.2), MAY be used in the "domainTransfer" and elements: Gould & Thippeswamy Expires May 9, 2013 [Page 19] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Example of a "domainTransfer" element: ... ... , domainTransfer-YYYYMMDD.csv ... ... Example of the corresponding domainTransfer-YYYYMMDD.csv file. The file contains two domain transfer records, with one in pending status and the second in clientApproved status. domain1.test,pending,clientW,2011-03-08T19:38:00.0Z, clientX,2011-03-13T23:59:59.0Z,2016-04-03T22:00:00.0Z domain2.test,clientApproved,clientW,2012-03-08T19:38:00.0Z, clientX,2012-03-09T23:59:59.0Z,2016-05-04T23:00:00.0Z Gould & Thippeswamy Expires May 9, 2013 [Page 20] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Example of a "domainTransfer" element: ... ... domainTransfer-delete-YYYYMMDD.csv ... ... Example of the corresponding domainTransfer-delete-YYYYMMDD.csv file. The file contains two domain transfer records. domain1.test,2011-03-08T19:38:00.0Z domain2.test,2012-03-08T19:38:00.0Z 4.2. Host Object The host object is based on the EPP host mapping in [RFC5732]. The elements used for Host Object is defined in this section. The child element of the element is used to hold the host objects for the deposit. The and the elements, defined in the " and elements (Section 3.6.1)" section, are used with the following supported "name" attribute values: "host" Defines the fields and CSV file references used for the host object records. The following field elements were added for use in the "host" element: Gould & Thippeswamy Expires May 9, 2013 [Page 21] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Contains parent domain name for the subordinate host object with type="eppcom:labelType". Boolean flag indicating if the host object is an IDN host object with type="boolean". List of IPv4 IP addresses for the host object with the list elements type="host:addrStringType". List of IPv6 IP addresses for the host object with the list elements type="host:addrStringType". The following "rdeCsv" fields, defined in section CSV common field elements (Section 3.6.2), MAY be used in the "host" and elements: Example of a "host" element: Gould & Thippeswamy Expires May 9, 2013 [Page 22] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 ... ... , host-YYYYMMDD.csv ... ... Example of the corresponding host-YYYYMMDD.csv file. The file contains two host records with one being an internal host and the second being an external host. ns1.example.test,Hns1_example_test-TEST,example.test, "linked,clientUpdateProhibited","192.0.2.2,192.0.2.29", "1080:0:0:0:8:800:200C:417A",clientY,clientX, 1999-05-08T12:10:00.0Z,clientX,2009-10-03T09:34:00.0Z, 2007-01-08T09:19:00.0Z ns1.example.test2,Hns1_example_test2-TEST,, "linked,clientUpdateProhibited",,,clientY,clientX, 2009-05-08T12:10:00.0Z,clientX,2010-10-03T09:34:00.0Z, Gould & Thippeswamy Expires May 9, 2013 [Page 23] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Example of a "host" element: ... ... host-delete-YYYYMMDD.csv ... ... Example of the host-delete-YYYYMMDD.csv file. The file contains two host records. ns1.example.test ns1.example.test2 4.3. Contact Object The contact object is based on the EPP contact mapping in [RFC5733]. The elements used for the Contact Object are defined in this sections The child element of the element to hold the contact objects for the deposit. The and the elements, defined in the " and elements (Section 3.6.1)" section, are used with the following supported "name" attribute values: "contact" Defines the fields and CSV file references used for the contact object records. The following field elements were added for use in the "contact" and elements: Gould & Thippeswamy Expires May 9, 2013 [Page 24] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Contains the server-unique contact identifier with type="eppcom:clIDType". Contains the contact's voice telephone number with type="contact:e164StringType". Contains the contact's voice telephone number extension with type="token". Contains the contact's facsimile telephone number with type="contact:e164StringType". Contains the contact's facsimile telephone number extension with type="token". Contains the contact's email address with type="eppcom:minTokenType". The following "rdeCsv" fields, defined in section CSV common field elements (Section 3.6.2), MAY be used in the "contact" element: Gould & Thippeswamy Expires May 9, 2013 [Page 25] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Example of a "contact" element: ... ... , contact-YYYYMMDD.csv ... ... Example of the contact-YYYYMMDD.csv file. The file contains two contact records. sh8013,Csh8013-TEST,"linked,clientDeleteProhibited", +1.7035555555,1234,+1.7035555556,,jdoe@example.test,clientY, clientX,2009-09-13T08:01:00.0Z,clientX, 2009-11-26T09:10:00.0Z,2fooBAR mycontactid,Cmycontactid-TEST,"ok",+1.7034444444,1234, +1.7033333333,,jsmith@example.test,clientY,clientX, 2010-09-13T08:01:00.0Z,clientX,2011-11-26T09:10:00.0Z,2fooBAR Gould & Thippeswamy Expires May 9, 2013 [Page 26] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Example of a "contact" element: ... ... contact-delete-YYYYMMDD.csv ... ... Example of the contact-delete-YYYYMMDD.csv file. The file contains two contact records. sh8013 mycontactid "contactPostal" Defines the fields and CSV file references used for the contact postal info object records. The following field elements were added for use in the "contactPostal" element: Contains the form of the postal-address information with type="contact:postalLineType". This field specifies the form ("int" or "loc"), as defined in Section 3.4, of the , , , , , , fields. Contains the contact's name of the individual or role represented by the contact with type="contact: postalLineType". An OPTIONAL "isLoc" attribute to used to indicate the localized or internationalized form as defined in Gould & Thippeswamy Expires May 9, 2013 [Page 27] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 section Section 3.4. Contains the name of the organization with which the contact is affiliated with type="contact: optPostalLineType". An OPTIONAL "isLoc" attribute to used to indicate the localized or internationalized form as defined in section Section 3.4. Contains the contact's contact's street address line with type="contact:fPostalLineType". An index attribute is required to indicate which street address line the field represents with index "0" for the first line and index "2" for the last line. An OPTIONAL "isLoc" attribute to used to indicate the localized or internationalized form as defined in section Section 3.4. Contains the contact's city with type="contact:postalLineType". An OPTIONAL "isLoc" attribute to used to indicate the localized or internationalized form as defined in section Section 3.4. Contains the contact's state or province with type="contact:optPostalLineType". An OPTIONAL "isLoc" attribute to used to indicate the localized or internationalized form as defined in section Section 3.4. Contains the contact's postal code with type="contact:pcType". An OPTIONAL "isLoc" attribute to used to indicate the localized or internationalized form as defined in section Section 3.4. Contains the contact's country code with type="contact:ccType". An OPTIONAL "isLoc" attribute to used to indicate the localized or internationalized form as defined in section Section 3.4. The following "csvContact" fields, defined for the "contact" element, is used in the "contactPostal" and elements: Gould & Thippeswamy Expires May 9, 2013 [Page 28] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Example of a "contactPostal" element: ... ... , contactPostal-YYYYMMDD.csv ... ... Example of the contactPostal-YYYYMMDD.csv file. The file contains two contact postal records. sh8013,int,"John Doe","Example Inc.", "123 Example Dr.","Suite 100",,Reston,VA,20190,US mycontactid,int,"John Smith","Acme Inc.", "123 Sample Dr.",,,Reston,VA,20190,US Example of a "contactPostal" element: Gould & Thippeswamy Expires May 9, 2013 [Page 29] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 ... ... , contactPostal-delete-YYYYMMDD.csv ... ... Example of the contactPostal-delete-YYYYMMDD.csv file. The file contains two contact postal records. sh8013,int mycontactid,int "contactTransfer" Defines the fields and CSV file referenes used for the contact object pending and completed transfer records. No additional field elements were added for use in the "contactTransfer" element. The following "rdeCsv" fields, defined in section CSV common field elements (Section 3.6.2), MAY be used in the "contactTransfer" element: Gould & Thippeswamy Expires May 9, 2013 [Page 30] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 The following "csvContact" fields, defined for the "contact" element, is used in the "contactTransfer" and elements: Example of a "contactTransfer" element: ... ... , contactTransfer-YYYYMMDD.csv ... ... Example of the contactTransfer-YYYYMMDD.csv file. The file contains two contact transfer records with one in pending status and the second in clientApproved status. Gould & Thippeswamy Expires May 9, 2013 [Page 31] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 sh8013,pending,clientW,2011-03-08T19:38:00.0Z, clientX,2011-03-13T23:59:59.0Z mycontactid,clientApproved,clientW,2011-04-08T19:38:00.0Z, clientX,2011-04-09T20:38:00.0Z Example of a "contactTransfer" element: ... ... contactTransfer-delete-YYYYMMDD.csv ... ... Example of the contactTransfer-delete-YYYYMMDD.csv file. The file contains two contact transfer records. sh8013,2011-03-08T19:38:00.0Z mycontactid,2011-04-08T19:38:00.0Z "contactDisclose" Defines the fields and CSV file references used for the contact disclose object records. The following field elements were added for use in the "contactDisclose" element: Gould & Thippeswamy Expires May 9, 2013 [Page 32] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Contains flag with a value of "true" or "1" (one) notes the preference to allow disclosure of the specified elements as an exception to the stated data- collection policy. A value of "false" or "0" (zero) notes a client preference to not allow disclosure of the specified elements as an exception to the stated data-collection policy with type="boolean". The additional fields define specific exceptional disclosure preferences based on the field. Exceptional disclosure preference flag for the localized form of the contact name with type="boolean". Exceptional disclosure preference flag for the internationalized form of the contact name with type="boolean". Exceptional disclosure preference flag for the localized form of the contact organization with type="boolean". with type="boolean". Exceptional disclosure preference flag for the internationalized form of the contact organization with type="boolean". with type="boolean". Exceptional disclosure preference flag for the localized form of the contact address with type="boolean". Exceptional disclosure preference flag for the internationalized form of the contact address with type="boolean". Exceptional disclosure preference flag of the contact voice telephone number with type="boolean". Exceptional disclosure preference flag of the contact facsimile telephone number with type="boolean". Exceptional disclosure preference flag of the contact email address with type="boolean". The following "csvContact" fields, defined for the "contact" element, is used in the "contactDisclose" and elements: Gould & Thippeswamy Expires May 9, 2013 [Page 33] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Example of a "contactDisclose" element: ... ... , contactDisclose-YYYYMMDD.csv ... ... Example of the contactDisclose-YYYYMMDD.csv file. The file contains two disclosure records. The first contact disables disclosure of voice, fax, and email. The second contact enables disclosure of the localized and internationalized form of the name. sh8013,0,0,0,0,0,0,0,1,1,1 mycontactid,1,1,1,0,0,0,0,0,0,0 Gould & Thippeswamy Expires May 9, 2013 [Page 34] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Example of a "contactDisclose" element: ... ... contactDisclose-delete-YYYYMMDD.csv ... ... Example of the contactDisclose-delete-YYYYMMDD.csv file. The file contains two disclosure records. sh8013 mycontactid 4.4. Registrar Object The registrar object represents the sponsoring client for other objects. The registrar object MAY be related to registrar contacts using Contact Object, as defined in Section 4.3, references or MAY contain registrar contacts. The elements used for the Registrar Object references are defined in this section. The child element of the element holds the registrar objects for the deposit. The and the elements, defined in the " and elements (Section 3.6.1)" section, are used with the following supported "name" attribute values: "registrar" Defines the fields and CSV file references used for the registrar object records. The following field elements were added for use in the "registrar" and elements: Gould & Thippeswamy Expires May 9, 2013 [Page 35] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Contains the server-unique registrar identifier with type="eppcom:clIDType". Contains the name of the registrar with type="normalizedString". Contains the ID assigned by ICANN with type="positiveInteger". Contains the status of the registrar with type="csvRegistrar:statusValueType". Contains the name of the registrar sub-status or the full name of the status when the fStatus value is "custom" with type="token". Contains the URL of the registrar with type="anyURI". Contains the Whois URL of the registrar with type="anyURI". The following "rdeCsv" fields, defined in section CSV common field elements (Section 3.6.2), MAY be used in the "registrar" element: Gould & Thippeswamy Expires May 9, 2013 [Page 36] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 The following "csvContact" fields, defined in section Section 4.3, MAY be used in the "registrar" element: Example of a "registrar" element with no registrar contact object references: Gould & Thippeswamy Expires May 9, 2013 [Page 37] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 ... ... , registrar-YYYYMMDD.csv ... ... Example of the registrar-YYYYMMDD.csv file. The file contains one registrar record. Gould & Thippeswamy Expires May 9, 2013 [Page 38] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 EXAMPLE,REGISTRAR123-TEST,"Example Inc.",1234,ok,"123 Example Dr.", "Suite 100",,Dulles,VA,20166-6503,US,+1.7035555555,1234, +1.7035555556,,jdoe@example.test,http://www.example.test, http://whois.example.test,clientX,2005-04-23T11:49:00.0Z, clientY,2009-02-17T17:51:00.0Z Example of a "registrar" element with registrant contact object references: Gould & Thippeswamy Expires May 9, 2013 [Page 39] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 ... ... , registrar-YYYYMMDD.csv ... ... Gould & Thippeswamy Expires May 9, 2013 [Page 40] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Example of the registrar-YYYYMMDD.csv file. The file contains one registrar record with the registrar contact object references. EXAMPLE,REGISTRAR123-TEST,"Example Inc.",1234,ok,"123 Example Dr.", "Suite 100",,Dulles,VA,20166-6503,US,+1.7035555555,1234, +1.7035555556,,jdoe@example.test,http://www.example.test, http://whois.example.test,"sh8013,mycontactid","sh8013,mycontactid", "sh8013,mycontactid",clientX,2005-04-23T11:49:00.0Z, clientY,2009-02-17T17:51:00.0Z Example of a "registrar" element: ... ... registrar-delete-YYYYMMDD.csv ... ... Example of the registrar-delete-YYYYMMDD.csv file. The file contains two registrar records. EXAMPLE EXAMPLE2 "registrarContact" Defines the fields and CSV file references used for the registrar contact attribute records. The registrar contact attribute records SHALL NOT be referenced by more than one registrar or referenced by any other object. The following field elements were added for use in the "registrarContact" element: Gould & Thippeswamy Expires May 9, 2013 [Page 41] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 List of registrar contact types for the registrar contact attribute record with list elements type="csvRegistrar:contactTypeType", which is an enumerated list of values "admin", "tech", "billing", and "custom". The following "csvRegistrar" fields, defined for the "registrar" element, is used in the "registrarContact" and elements: The following "csvContact" fields, defined for the "contact" element, MAY be used in the "registrarContact" and elements: Gould & Thippeswamy Expires May 9, 2013 [Page 42] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 The following "rdeCsv" fields, defined in section CSV common field elements (Section 3.6.2), MAY be used in the "registrarContact" and elements: Example of a "registrarContact" element without any postal information information: Gould & Thippeswamy Expires May 9, 2013 [Page 43] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 ... ... , registrarcontact-YYYYMMDD.csv ... ... Example of the registrarcontact-YYYYMMDD.csv file. The file contains two registrar contact records. EXAMPLE,rr0013,REGISTRARCONTACT12345-VRSN,"John Doe", "admin",+1.7035555555,1234,+1.7035555556,,johndoe@example.test, clientY,clientX,2009-09-13T08:01:00.0Z, clientX,2009-11-26T09:10:00.0Z EXAMPLE,rr0012,REGISTRARCONTACT12346-VRSN,"Jane Doe", "tech",+1.7035555555,1235,+1.7035555556,,janedoe@example.test, clientY,clientX,2009-09-13T08:01:00.0Z, clientX,2009-11-26T09:10:00.0Z Gould & Thippeswamy Expires May 9, 2013 [Page 44] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Example of a "registrarContact" element with support for both "int" and "loc" postal information: ... ... , registrarcontact-YYYYMMDD.csv Gould & Thippeswamy Expires May 9, 2013 [Page 45] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 ... ... Example of the registrarcontact-YYYYMMDD.csv file. The file contains one registrar contact record. EXAMPLE,rr0013,REGISTRARCONTACT12345-VRSN,"John Doe","admin", int,"123 Example Dr.","Suite 100",,Reston,VA,20190,US, loc,int,"123 Example Dr.","Suite 100",,Reston,VA,20190,US, +1.7035555555,1234,+1.7035555556,,johndoe@example.test, clientY,clientX,2009-09-13T08:01:00.0Z, clientX,2009-11-26T09:10:00.0Z Example of a "registrarContact" element: ... ... , registrarContact-delete-YYYYMMDD.csv ... ... Example of the registrarContact-delete-YYYYMMDD.csv file. The file contains two registrar contact record. Gould & Thippeswamy Expires May 9, 2013 [Page 46] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 EXAMPLE,rr0013 EXAMPLE,rr0012 4.5. IDN Language Object The IDN domain names, defined in Section 4.1, MAY have references to the IDN language using the field element. The IDN language object defines the mapping of a language to a language table URL. The language table URL defines the character code points that can be used for the language. The elements used for the IDN language object is defined in this section. The child element of the element is used to hold the IDN language objects for the deposit. The and the elements, defined in the " and elements (Section 3.6.1)" section, are used with the following supported "name" attribute values: "idnLanguage" Defines the fields and CSV file references used for the IDN language object records. The following "rdeCsv" fields, defined in Section 3.6.2, MAY be used in the "idnLanguage" and elements: Example of a "idnLanguage" element: Gould & Thippeswamy Expires May 9, 2013 [Page 47] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 ... ... , idnLanguage-YYYYMMDD.csv ... ... Example of the corresponding idnLanguage-YYYYMMDD.csv file. The file contains two IDN language records. LANG1,http://www.iana.org/domains/idn-tables/tables/test_tab1_1.1.txt LANG2,http://www.iana.org/domains/idn-tables/tables/test_tab2_1.1.txt Example of a "idnLanguage" element: ... ... idnLanguage-YYYYMMDD.csv ... Gould & Thippeswamy Expires May 9, 2013 [Page 48] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 ... Example of the idnLanguage-delete-YYYYMMDD.csv file. The file contains two IDN language records. LANG1 LANG2 5. Formal Syntax Six schemas are presented here. The first schema is the base CSV schema. The second schema defines domain name CSV object for RDE. The third schema defines host CSV object for RDE. The fourth schema defines contact CSV object for RDE. The fifth schema defines registrar CSV object for RDE. The sixth schema defines the IDN language CSV object. 5.1. RDE CSV Schema 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: o Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. o Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. o Neither the name of Internet Society, IETF or IETF Trust, nor the names of specific contributors, may be used to endorse or promote products derived from this software without specific prior written permission. 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 Gould & Thippeswamy Expires May 9, 2013 [Page 49] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 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 Registry Data Escrow Comma-Seperated Values (CSV) Gould & Thippeswamy Expires May 9, 2013 [Page 50] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Gould & Thippeswamy Expires May 9, 2013 [Page 53] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Gould & Thippeswamy Expires May 9, 2013 [Page 55] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Gould & Thippeswamy Expires May 9, 2013 [Page 56] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 END Gould & Thippeswamy Expires May 9, 2013 [Page 57] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 5.2. Domain Object 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: o Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. o Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. o Neither the name of Internet Society, IETF or IETF Trust, nor the names of specific contributors, may be used to endorse or promote products derived from this software without specific prior written permission. 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 Gould & Thippeswamy Expires May 9, 2013 [Page 58] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Domain Name Comma-Separated Values (CSV) Object Gould & Thippeswamy Expires May 9, 2013 [Page 61] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 END 5.3. Host Object 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: o Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. o Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. o Neither the name of Internet Society, IETF or IETF Trust, nor the names of specific contributors, may be used to endorse or promote products derived from this software without specific prior written permission. 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 Gould & Thippeswamy Expires May 9, 2013 [Page 62] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Host Comma-Separated Values (CSV) Object Gould & Thippeswamy Expires May 9, 2013 [Page 63] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 END 5.4. Contact Object 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: o Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. o Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. o Neither the name of Internet Society, IETF or IETF Trust, nor the names of specific contributors, may be used to endorse or promote products derived from this software without specific prior written permission. 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 Gould & Thippeswamy Expires May 9, 2013 [Page 64] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. BEGIN Contact Comma-Separated Values (CSV) Object Gould & Thippeswamy Expires May 9, 2013 [Page 65] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Gould & Thippeswamy Expires May 9, 2013 [Page 67] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Gould & Thippeswamy Expires May 9, 2013 [Page 68] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Gould & Thippeswamy Expires May 9, 2013 [Page 69] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 END 5.5. Registrar Object 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: o Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. o Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. o Neither the name of Internet Society, IETF or IETF Trust, nor the names of specific contributors, may be used to endorse or promote products derived from this software without specific prior written permission. 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 Registar Comma-Separated Values (CSV) Object Gould & Thippeswamy Expires May 9, 2013 [Page 71] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Gould & Thippeswamy Expires May 9, 2013 [Page 72] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 END 5.6. IDN Language Object 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: o Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. o Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. o Neither the name of Internet Society, IETF or IETF Trust, nor the names of specific contributors, may be used to endorse or promote products derived from this software without specific prior written permission. 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. Gould & Thippeswamy Expires May 9, 2013 [Page 74] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 BEGIN IDN Language Comma-Separated Values (CSV) Object END 5.7. Extension Guidelines TBD 5.8. Internationalization Considerations Data Escrow deposits are 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 Gould & Thippeswamy Expires May 9, 2013 [Page 75] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 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 declaration, use of UTF-8 is RECOMMENDED. 5.9. IANA Considerations This document uses URNs to describe XML namespaces and XML schemas conforming to a registry mechanism described in [RFC3688]. Fourteen URI assignments have been registered by the IANA. Registration request for the RDE CSV namespace: URI: urn:ietf:params:xml:ns:rdeCsv-1.0 Registrant Contact: See the "Author's Address" section of this document. XML: None. Namespace URIs do not represent an XML specification. Registration request for the RDE CSV XML schema: URI: urn:ietf:params:xml:schema:rdeCsv-1.0 Registrant Contact: See the "Author's Address" section of this document. See the "Formal Syntax" section of this document. Registration request for the RDE CSV domain namespace: URI: urn:ietf:params:xml:ns:csvDomain-1.0 Registrant Contact: See the "Author's Address" section of this document. XML: None. Namespace URIs do not represent an XML specification. Registration request for the RDE CSV domain XML schema: URI: urn:ietf:params:xml:schema:csvDomain-1.0 Registrant Contact: See the "Author's Address" section of this document. See the "Formal Syntax" section of this document. Registration request for the RDE CSV host namespace: Gould & Thippeswamy Expires May 9, 2013 [Page 76] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 URI: urn:ietf:params:xml:ns:csvHost-1.0 Registrant Contact: See the "Author's Address" section of this document. XML: None. Namespace URIs do not represent an XML specification. Registration request for the RDE CSV host XML schema: URI: urn:ietf:params:xml:schema:csvHost-1.0 Registrant Contact: See the "Author's Address" section of this document. See the "Formal Syntax" section of this document. Registration request for the RDE CSV contact namespace: URI: urn:ietf:params:xml:ns:csvContact-1.0 Registrant Contact: See the "Author's Address" section of this document. XML: None. Namespace URIs do not represent an XML specification. Registration request for the RDE CSV contact XML schema: URI: urn:ietf:params:xml:schema:csvContact-1.0 Registrant Contact: See the "Author's Address" section of this document. See the "Formal Syntax" section of this document. Registration request for the RDE CSV registrar namespace: URI: urn:ietf:params:xml:ns:csvRegistrar-1.0 Registrant Contact: See the "Author's Address" section of this document. XML: None. Namespace URIs do not represent an XML specification. Registration request for the RDE CSV registrar XML schema: URI: urn:ietf:params:xml:schema:csvRegistrar-1.0 Gould & Thippeswamy Expires May 9, 2013 [Page 77] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Registrant Contact: See the "Author's Address" section of this document. See the "Formal Syntax" section of this document. Registration request for the RDE CSV IDN namespace: URI: urn:ietf:params:xml:ns:csvIDN-1.0 Registrant Contact: See the "Author's Address" section of this document. XML: None. Namespace URIs do not represent an XML specification. Registration request for the RDE CSV IDN XML schema: URI: urn:ietf:params:xml:schema:csvIDN-1.0 Registrant Contact: See the "Author's Address" section of this document. See the "Formal Syntax" section of this document. 5.10. Security Considerations This specification does not define the security mechanisms to be used in the transmission of the data escrow deposits, since it only specifies the minimum necessary to enable the rebuilding of a Registry from deposits without intervention from the original Registry. Depending on local policies, some elements or most likely, the whole deposit will be considered confidential. As such the Registry transmitting the data to the Escrow Agent SHOULD take all the necessary precautions like encrypting the data itself and/or the transport channel to avoid inadvertent disclosure of private data. It is also of the utmost importance the authentication of the parties passing data escrow deposit files. The Escrow Agent SHOULD properly authenticate the identity of the Registry before accepting data escrow deposits. In a similar manner, the Registry SHOULD authenticate the identity of the Escrow Agent before submitting any data. Additionally, the Registry and the Escrow Agent SHOULD use integrity checking mechanisms to ensure the data transmitted is what the source intended. Validation of the contents by the Escrow Agent is RECOMMENDED to ensure not only the file was transmitted correctly Gould & Thippeswamy Expires May 9, 2013 [Page 78] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 from the Registry, but also the contents are also "meaningful". 5.11. Acknowledgments Parts of this document are based on EPP [RFC5730] and related RFCs by Scott Hollenbeck. The structure and some of the sample data and content of this document is based on the Domain Name Registration Data (DNRD) Objects Mapping [2] by Francisco Arias and Shoji Noguchi. TBD 5.12. Change History [[RFC Editor: Please remove this section.]] 6. References 6.1. Normative References [ISO-3166-1] International Organization for Standardization, "Codes for the representation of names of countries and their subdivisions - Part 1: Country codes", ISO Standard 3166, November 2006. [ITU-E164] International Telecommunication Union, "The international public telecommunication numbering plan", ITU-T Recommendation E.164, February 2005. [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. [RFC3339] Klyne, G., Ed. and C. Newman, "Date and Time on the Internet: Timestamps", RFC 3339, July 2002. [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. [RFC5732] Hollenbeck, S., "Extensible Provisioning Protocol (EPP) Gould & Thippeswamy Expires May 9, 2013 [Page 79] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Host Mapping", STD 69, RFC 5732, August 2009. [RFC5733] Hollenbeck, S., "Extensible Provisioning Protocol (EPP) Contact Mapping", STD 69, RFC 5733, August 2009. [RFC5910] Gould, J. and S. Hollenbeck, "Domain Name System (DNS) Security Extensions Mapping for the Extensible Provisioning Protocol (EPP)", RFC 5910, May 2010. 6.2. Informative References [RFC0791] Postel, J., "Internet Protocol", STD 5, RFC 791, September 1981. [RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, January 2004. [RFC4291] Hinden, R. and S. Deering, "IP Version 6 Addressing Architecture", RFC 4291, February 2006. URIs [1] [2] Authors' Addresses James Gould Verisign 12061 Bluemont Way Reston, VA 20190 US Email: jgould@verisign.com URI: http://www.verisigninc.com Gould & Thippeswamy Expires May 9, 2013 [Page 80] Internet-Draft Domain Name Registration Data CSV Mapping November 2012 Chethan Thippeswamy Verisign 12061 Bluemont Way Reston, VA 20190 US Email: cthippeswamy@verisign.com URI: http://www.verisigninc.com Gould & Thippeswamy Expires May 9, 2013 [Page 81]