Network Working Group A.L. Newton Internet-Draft VeriSign, Inc. Expires: August 23, 2001 February 22, 2001 XDAP Domain Directory Schema draft-newton-xdap-domdir-00 Status of this Memo This document is an Internet-Draft and is in full conformance with all provisions of Section 10 of RFC2026. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet-Drafts. 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." The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/1id-abstracts.txt. The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. This Internet-Draft will expire on August 23, 2001. Copyright Notice Copyright (C) The Internet Society (2001). All Rights Reserved. Abstract This document describes an XDAP directory namespace and schema for registered DNS information. The schema extends the necessary query and result operations of XDAP to provide a functional equivalent of the whois command syntaxes and results often used by domain registries and registrars. Newton Expires August 23, 2001 [Page 1] Internet-Draft XDAP Domain Directory Schema February 2001 Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 2. Document Terminology . . . . . . . . . . . . . . . . . . . . 4 3. Schema Description . . . . . . . . . . . . . . . . . . . . . 5 3.1 Query Derivatives . . . . . . . . . . . . . . . . . . . . . 5 3.1.1 Query . . . . . . . . . . . . . . . . . . . . 5 3.1.2 Query . . . . . . . . . . . . . . . . . . . . 5 3.1.3 Query . . . . . . . . . . . . . . . . . 5 3.1.4 Query . . . . . . . . . . . . . . . . . . 5 3.1.5 Query . . . . . . . . . . . . . . . . . . . 5 3.1.6 Query . . . . . . . . . . . . . . . . . . . . 6 3.1.7 Query . . . . . . . . . . . . . . . . . . . . . 6 3.1.8 Query . . . . . . . . . . . . . . . . . 6 3.2 Result Derivatives . . . . . . . . . . . . . . . . . . . . . 6 3.2.1 Result . . . . . . . . . . . . . . . . . . . . . . 6 3.2.2 Result . . . . . . . . . . . . . . . . . . . . . . 7 3.2.3 Result . . . . . . . . . . . . . . . . . . . . . 7 3.2.4 Result . . . . . . . . . . . . . . . . . . . . . 7 3.2.5 Result . . . . . . . . . . . . . . . . . . . . . . . 7 3.2.6 Result . . . . . . . . . . . . . . . . . . . . 7 3.2.7 Result . . . . . . . . . . . . . . . . . . . . . 8 3.3 Global Types . . . . . . . . . . . . . . . . . . . . . . . . 8 3.4 Support for . . . . . . . . . . . . . . 8 4. Formal XML Syntax . . . . . . . . . . . . . . . . . . . . . 9 5. Internationalization Considerations . . . . . . . . . . . . 19 6. IANA Considerations . . . . . . . . . . . . . . . . . . . . 20 7. Security Considerations . . . . . . . . . . . . . . . . . . 21 References . . . . . . . . . . . . . . . . . . . . . . . . . 22 Author's Address . . . . . . . . . . . . . . . . . . . . . . 22 A. An Example Request and Response . . . . . . . . . . . . . . 23 Full Copyright Statement . . . . . . . . . . . . . . . . . . 25 Newton Expires August 23, 2001 [Page 2] Internet-Draft XDAP Domain Directory Schema February 2001 1. Introduction This document describes an Internet address directory using an XML Schema[4] derived from and using the XDAP[5] schema. The query and result types are similar in function to the whois commands and results often used by domain registries/registrars today. The schema given is this document is specified using the Extensible Markup Language (XML) 1.0 as described in [1], XML Schema notation as described in [3] and [4], and XML Namespaces as described in [2]. It is important to note that XML is case sensitive. XML specifications and examples provided in this document MUST be interpreted in the exact character case presented to develop a conforming implementation. Newton Expires August 23, 2001 [Page 3] Internet-Draft XDAP Domain Directory Schema February 2001 2. Document 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[9]. The terms "holder" and sponsor" are taken from the meaning described in [6]. Newton Expires August 23, 2001 [Page 4] Internet-Draft XDAP Domain Directory Schema February 2001 3. Schema Description The schema for this directory namespace defines no derivative. Applications of this namespace should rely on either the XDAP transport or for client authentication. XDAP requires the derivation of both query and result elements by a directory namespace. These descriptions follow. 3.1 Query Derivatives 3.1.1 Query This query does a domain lookup. This lookup is specified either with a handle for the domain or the name of the domain as it would be used in DNS. 3.1.2 Query This query returns continuation searches in the directory services of the "down-stream" sponsors of a directory. A search constraint of MAY restrict the list to sponsors only of a particular domain. 3.1.3 Query finds a domain entity by the common name of the domain's holder. A search constraint of MAY restrict the results to domains only underneath the domain specified by its content. The element MUST be present and specifies the beginning of the common name of the holder. The element is OPTIONAL and MUST contain the end of the common name of the holder. 3.1.4 Query Similar to , finds a domain entity by the name of the domain as it is known it DNS. A search constraint of MAY restrict the results to domains only underneath the domain specified by its content. The element MUST be present and specifies the beginning of the domain name. The element is OPTIONAL and MUST contain the end of the domain name. 3.1.5 Query This query does a contact lookup. The lookup is specified with the handle of the contact. Newton Expires August 23, 2001 [Page 5] Internet-Draft XDAP Domain Directory Schema February 2001 3.1.6 Query searches for contacts given search constraints. The element MUST be present and specifies the beginning of the common name of the contact. The element is OPTIONAL and MUST contain the end of the common name of the contact. The element is OPTIONAL and SHOULD contain a recognized type of contact. Typically the values for this element denote multiplicity of the contact, such as "organization" or "person". 3.1.7 Query This is a simple named look up of a name server host. The host MUST be specified by one of the following elements: o - a registry assigned unique identifier. o - the fully-qualified name of the host. o - the IP version 4 address of the host. o - the IP version 6 address of the host. 3.1.8 Query This query does a simple search for the name servers hosting a domain. The search constraint MUST be present. 3.2 Result Derivatives 3.2.1 Result This is the expected result of a query. The children of the element are as follows: o - the full name of the domain as it is in DNS. This element MUST be present. o - an entity reference to a domain entry in another directory service representing this same domain entity. This reference SHOULD be to the domain entry in a sponsor's directory service. The element is OPTIONAL. o - an entity reference to an authoritative name server for this domain. This element is OPTIONAL and MAY repeat as many times as necessary. o - an element representing the holder of the domain. The Newton Expires August 23, 2001 [Page 6] Internet-Draft XDAP Domain Directory Schema February 2001 children of this element contain the contact information of the holder and MUST be identical in specification as the children of . This element is OPTIONAL. o - specifies a reference to a contact of the domain. The first child of this element MUST be and contain a reference to the contact. The second element, , specifies the relationship between the contact and the domain. Usually, the contents of this element are "technical", "billing", or "administrative". This element is OPTIONAL and MAY repeat as many times as necessary. 3.2.2 Result This is the expected result of a or query. It MAY be empty, but if it has children, they MUST be elements. 3.2.3 Result This element is the expected result of a query. The children of this element are as specified by XDAP. 3.2.4 Result The element is the expected result of a query. It contains elements for the fully qualified host name of the host, the IP address of the host, and a reference to the host contact. The address elements contain the IP address of the name server, either IP v4 or IP v6, and an OPTIONAL reference to the network which contains the given address. 3.2.5 Result This is the expected result of query. It MAY be empty, but if it has children, they MUST be elements. 3.2.6 Result The element is the expected result of a query. The children that MUST be present are , containing a registry assigned unique identifier, and , which holds the common name of the contact. The other children of this element are OPTIONAL and contain Internet, phone, and postal address information. Newton Expires August 23, 2001 [Page 7] Internet-Draft XDAP Domain Directory Schema February 2001 3.2.7 Result The element is the expected result of a query. This element MAY have no children; if it is not empty the children MUST be elements. 3.3 Global Types Some of the global types defined by the schema specified in this document are expressed using regular expressions. The regular expressions used for these definitions do not fully represent every allowable syntax for the intended type, but meet a standard of reasonableness for the expression of the types. 3.4 Support for The following types of named entities are recognized by the query of XDAP: o handles - unique identifiers assigned the domain registry/registrar. These handles are defined to have their type as the first part of the handle. A query with a type "host" will yield a result. A query with a type "domain" will yield a result. The other types, "org", "person", and "role" will yield a result. o host names and domain names - the fully qualified host name of a name server or the fully qualified name of a domain. Queries with a host name will yield a result, and queries with a domain name will yield a result. In the unlikely and rare case where a name server and a host name may be the same, a query will result in a element. This element contains entity references to both the name server host entry and the domain entry known by that name. o IP addresses - the address, either IP v4 or IP v6, of a name server. A query with an IP address will yield a result of . Newton Expires August 23, 2001 [Page 8] Internet-Draft XDAP Domain Directory Schema February 2001 4. Formal XML Syntax This domain directory is specified in the XML Schema notation. The formal syntax presented here is a complete schema representation suitable for automated validation of an XML instance when combined with the formal schema syntax of XDAP. Due to document formatting restrictions, readers should note that the regular expressions expressed in this schema DO NOT contain whitespace within the quotes containing the regular expression. Domain directory schema derived from XDAP schema Newton Expires August 23, 2001 [Page 9] Internet-Draft XDAP Domain Directory Schema February 2001 Newton Expires August 23, 2001 [Page 10] Internet-Draft XDAP Domain Directory Schema February 2001 Newton Expires August 23, 2001 [Page 11] Internet-Draft XDAP Domain Directory Schema February 2001 Newton Expires August 23, 2001 [Page 13] Internet-Draft XDAP Domain Directory Schema February 2001 Newton Expires August 23, 2001 [Page 14] Internet-Draft XDAP Domain Directory Schema February 2001 Newton Expires August 23, 2001 [Page 16] Internet-Draft XDAP Domain Directory Schema February 2001 Newton Expires August 23, 2001 [Page 17] Internet-Draft XDAP Domain Directory Schema February 2001 Newton Expires August 23, 2001 [Page 18] Internet-Draft XDAP Domain Directory Schema February 2001 5. Internationalization Considerations The defining schema for this directory namespace is represented in XML, which provides native support for encoding information using the double-byte Unicode character set and its more compact representations including UTF-8. Compliant XML processors are required to understand both UTF-8 and raw Unicode character sets; XML also includes a provision for identifying other character sets through use of an "encoding" attribute in an processing instruction. The complete list of character set encoding identifiers is maintained by IANA and is described in [10] and [7]. Newton Expires August 23, 2001 [Page 19] Internet-Draft XDAP Domain Directory Schema February 2001 6. IANA Considerations XML schemas require a URI for unique identification. Schemas MUST be registered to ensure URI uniqueness, but the IETF does not currently have a recommended repository for the registration of XML schemas. This document uses URNs to describe XML namespaces and XML schemas. IANA SHOULD maintain a registry of XML namespace and schema URI assignments. Per policies described in [8], URI assignment requests SHOULD be reviewed by a designated expert, and values SHOULD be assigned only as a result of standards action taken by the IESG. Newton Expires August 23, 2001 [Page 20] Internet-Draft XDAP Domain Directory Schema February 2001 7. Security Considerations The schema given in this document describes no derivatives nor specifies any authentication mechanism beyond that specified by [5]. Newton Expires August 23, 2001 [Page 21] Internet-Draft XDAP Domain Directory Schema February 2001 References [1] World Wide Web Consortium, "Extensible Markup Language (XML) 1.0", W3C XML, February 1998, . [2] World Wide Web Consortium, "Namespaces in XML", W3C XML Namespaces, January 1999, . [3] World Wide Web Consortium, "XML Schema Part 2: Datatypes", W3C XML Schema, October 2000, . [4] World Wide Web Consortium, "XML Schema Part 1: Structures", W3C XML Schema, October 2000, . [5] Newton, A., "eXtensible Directory Access Protocol", Internet Draft, a work in-progress., February 2001. [6] Rader, R., "Domain Name Whois Data Element and Related Definitions", Internet Draft, a work in-progress., January 2001. [7] Reynolds, J. and J. Postel, "ASSIGNED NUMBERS", RFC 1700, STD 2, October 1994. [8] Narten, T. and H.T. Alvestrand, "Guidelines for Writing an IANA Considerations Section in RFCs", RFC 2434, BCP 26, October 1998. [9] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", RFC 2119, BCP 14, March 1997. [10] Author's Address Andrew L. Newton VeriSign, Inc. 505 Huntmar Park Drive Herndon, VA 20170 USA Phone: +1 703 948 3382 EMail: anewton@research.netsol.com URI: http://www.research.netsol.com/ Newton Expires August 23, 2001 [Page 22] Internet-Draft XDAP Domain Directory Schema February 2001 Appendix A. An Example Request and Response The following is an example of an XDAP request and response using this directory namespace. This XML instance is a request to search for domains by the holder's name. com The Cobbler Shoppe This XML instance is a response from Figure 2. thecobblershoppe.com xdap://a.host/urn:iana:xmlns:domdir1/host:research7-hst Newton Expires August 23, 2001 [Page 23] Internet-Draft XDAP Domain Directory Schema February 2001 xdap://a.host/urn:iana:xmlns:domdir1/host:nso1184-hst person:beb140 Bill Eckels The Cobbler Shoppe bille@bjmk.com
21 North Main Street
Britt IA 50423 US 515-843-3521
Newton Expires August 23, 2001 [Page 24] Internet-Draft XDAP Domain Directory Schema February 2001 Full Copyright Statement Copyright (C) The Internet Society (2001). All Rights Reserved. This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations, except as needed for the purpose of developing Internet standards in which case the procedures for copyrights defined in the Internet Standards process must be followed, or as required to translate it into languages other than English. The limited permissions granted above are perpetual and will not be revoked by the Internet Society or its successors or assigns. This document and the information contained herein is provided on an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Acknowledgement Funding for the RFC editor function is currently provided by the Internet Society. Newton Expires August 23, 2001 [Page 25]