TOC 
ENUM -- Telephone Number MappingB. Hoeneisen
Working GroupUcom.ch
Internet-DraftA. Mayrhofer
Obsoletes: 3761 (if approved)enum.at
Intended status: BCPJ. Livingood
Expires: October 28, 2010Comcast
 April 26, 2010


IANA Registration of Enumservices: Guide, Template and IANA Considerations
draft-ietf-enum-enumservices-guide-20

Abstract

This document specifies a revision of the IANA Registration Guidelines for Enumservices, describes corresponding registration procedures, and provides a guideline for creating Enumservice Specifications.

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 October 28, 2010.

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 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

2.  Terminology

3.  Registration Requirements
    3.1.  Functionality Requirements
    3.2.  Naming Requirements
    3.3.  Security Requirements
    3.4.  Publication Requirements

4.  Enumservice Creation Cookbook
    4.1.  General Enumservice Considerations
    4.2.  Classification, Type and Subtype
        4.2.1.  General Type / Subtype Considerations
        4.2.2.  Protocol-Based Enumservices Class
        4.2.3.  Application-Based Enumservice Classes
        4.2.4.  Data Type-Based Enumservice Class
        4.2.5.  Other Enumservice

5.  Required Sections and Information
    5.1.  Introduction (MANDATORY)
    5.2.  IANA Registration (MANDATORY)
        5.2.1.  Enumservice Class (<class>)
        5.2.2.  Enumservice Type (<type>)
        5.2.3.  Enumservice Subtype (<subtype>)
        5.2.4.  URI Scheme(s) (<urischeme>)
        5.2.5.  Functional Specification (<functionalspec>)
        5.2.6.  Security Considerations (<security>)
        5.2.7.  Intended Usage (<usage>)
        5.2.8.  Enumservice Specification (<registrationdocs>)
        5.2.9.  Requesters (<requesters>)
        5.2.10.  Further Information (<additionalinfo>)
    5.3.  Examples (MANDATORY)
    5.4.  Implementation Recommendations / Notes (OPTIONAL)
    5.5.  Security Considerations (MANDATORY)
    5.6.  IANA Considerations (MANDATORY)
    5.7.  DNS Considerations (MANDATORY)
    5.8.  Other Sections (OPTIONAL)

6.  The Process of Registering New Enumservices
    6.1.  Step 1: Read this Document in Detail
    6.2.  Step 2: Write and Submit Registration Document
    6.3.  Step 3: Request Comments from the IETF Community
        6.3.1.  Outcome 1: No Changes Needed
        6.3.2.  Outcome 2: Changes, but no further Comments Requested
        6.3.3.  Outcome 3: Changes and further Comments Requested
    6.4.  Step 4: Submit Registration Document to IANA
    6.5.  Step 5: Expert Review
        6.5.1.  Outcome 1: Experts Approve the Registration Document
        6.5.2.  Outcome 2: Changes Required
        6.5.3.  Outcome 3: Experts Reject the Registration Document
    6.6.  Step 6: Publication of the Registration Document
    6.7.  Step 7: Adding Enumservice to IANA Registry

7.  Expert Review
    7.1.  Expert Selection Process
    7.2.  Review Guidelines
    7.3.  Appeals

8.  Revision of Pre-Existing Enumservice Specifications

9.  Extension of Existing Enumservice Specifications

10.  Security Considerations
    10.1.  Considerations Regarding This Document
    10.2.  Enumservice Security Considerations Guideline

11.  IANA Considerations
    11.1.  Registry Update
    11.2.  Registration Template (XML chunk)
    11.3.  Location
    11.4.  Structure
    11.5.  Expert Review Procedure
    11.6.  Registration Procedure
        11.6.1.  Published as RFC
        11.6.2.  Published as generic Specification
    11.7.  Change Control
    11.8.  Restrictions

12.  Acknowledgements

13.  References
    13.1.  Normative References
    13.2.  Informative References

Appendix A.  IANA XML Template Examples

Appendix B.  Changes Overview

Appendix C.  Document Changelog

Appendix D.  Open Issues

§  Authors' Addresses




 TOC 

1.  Introduction

E.164 Number Mapping (ENUM) [I‑D.ietf‑enum‑3761bis] (Bradner, S., Conroy, L., and K. Fujiwara, “The E.164 to Uniform Resource Identifiers (URI) Dynamic Delegation Discovery System (DDDS) Application (ENUM),” November 2009.) provides an identifier mapping mechanism to map E.164 numbers (International Telecommunications Union, “The International Public Telecommunication Numbering Plan,” Feb 2005.) [ITU.E164.2005] to Uniform Resource Identifiers (URIs) (Berners-Lee, T., Fielding, R., and L. Masinter, “Uniform Resource Identifier (URI): Generic Syntax,” January 2005.) [RFC3986] using the Domain Name System (DNS) (Mockapetris, P., “Domain names - implementation and specification,” November 1987.) [RFC1035]. One of the primary concepts of ENUM is the definition of "Enumservices", which allows for providing different URIs for different applications of said mapping mechanism.

This document specifies a revision of the IANA Registry for Enumservices, which was originally described in [RFC3761] (Faltstrom, P. and M. Mealling, “The E.164 to Uniform Resource Identifiers (URI) Dynamic Delegation Discovery System (DDDS) Application (ENUM),” April 2004.). This document obsoletes Section 3 of RFC 3761.

The new registration processes have been specifically designed to be decoupled from the existence of the ENUM working group. Compared to RFC 3761, the main changes are:



The IETF's ENUM Working Group has encountered an unnecessary amount of variation in the format of Enumservice Specifications. The ENUM Working Group's view of what particular information is required and/or recommended has also evolved, and capturing these best current practices is helpful in both the creation of new Enumservice Specifications, as well as the revision or refinement of existing Enumservice Specifications.



 TOC 

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 RFC 2119 (Bradner, S., “Key words for use in RFCs to Indicate Requirement Levels,” March 1997.) [RFC2119].

For the purpose of this document:



 TOC 

3.  Registration Requirements

As specified in the Augmented Backus-Naur Form (ABNF, [RFC5234] (Crocker, D. and P. Overell, “Augmented BNF for Syntax Specifications: ABNF,” January 2008.)) found in Section 2.4.3 of [I‑D.ietf‑enum‑3761bis] (Bradner, S., Conroy, L., and K. Fujiwara, “The E.164 to Uniform Resource Identifiers (URI) Dynamic Delegation Discovery System (DDDS) Application (ENUM),” November 2009.), an Enumservice is made up of Types and Subtypes. For any given Type, the allowable Subtypes (if any) must be defined in the Enumservice Specification. There is currently no concept of a registered Subtype outside the scope of a given Type.

While the combination of each Type and all of its Subtypes constitutes the allowed values for the "Enumservice" field, it is not sufficient to just list their allowed values. To allow for interoperability, a complete Enumservice Specification MUST document the semantics of the Type and Subtype values to be registered, and MUST contain all sections listed in Section 5 (Required Sections and Information) of this document.

Furthermore, in order for an Enumservice to be registered, the entire Registration Document requires approval by the experts according to "Specification Required", which implies the use of a Designated Expert, as set out in "Guidelines for Writing an IANA Considerations Section in RFCs" (Narten, T. and H. Alvestrand, “Guidelines for Writing an IANA Considerations Section in RFCs,” May 2008.) [RFC5226] and Section 7.2 (Review Guidelines) of this document.

All Enumservice Specifications are expected to conform also to various requirements laid out in the following sections.



 TOC 

3.1.  Functionality Requirements

A registered Enumservice must be able to function as a selection mechanism for choosing one Naming Authority Pointer (NAPTR) (Mealling, M., “Dynamic Delegation Discovery System (DDDS) Part Three: The Domain Name System (DNS) Database,” October 2002.) [RFC3403] DNS Resource Record (RR) from a set of such RRs. That means the Enumservice Specification MUST define how to use the NAPTR RR and the URI(s) the NAPTR RR resolves to.

Specifically, a registered Enumservice MUST specify the URI Scheme(s) that may be used for the Enumservice, and, when needed, other information that will have to be transferred into the URI resolution process itself.



 TOC 

3.2.  Naming Requirements

An Enumservice MUST be unique in order to be useful as a selection criteria:

Types and Subtypes MUST conform to the ABNF specified in Section 2.4.4 of [I‑D.ietf‑enum‑3761bis] (Bradner, S., Conroy, L., and K. Fujiwara, “The E.164 to Uniform Resource Identifiers (URI) Dynamic Delegation Discovery System (DDDS) Application (ENUM),” November 2009.).

The ABNF specified in Section 2.4.4 of [I‑D.ietf‑enum‑3761bis] (Bradner, S., Conroy, L., and K. Fujiwara, “The E.164 to Uniform Resource Identifiers (URI) Dynamic Delegation Discovery System (DDDS) Application (ENUM),” November 2009.) allows the "-" (dash) character for Types and Subtypes . To avoid confusion with possible future prefixes, a "-" MUST NOT be used as the first nor as the second character of a Type nor a Subtype. Furthermore, a "-" MUST NOT be used as the last character of a Type nor a Subtype. In addition, Types and Subtypes are case insensitive and MUST be specified in small letters.

To avoid confusion with Enumservice fields using an obsolete syntax, Type and Subtype MUST NOT start with the string "e2u".

The Subtype for one Type MAY have the same identifier as a Subtype for another Type but it is not sufficient to simply reference another Type's Subtype. The functionality of each Subtype MUST be fully specified in the context of the Type being registered.

Section 4 (Enumservice Creation Cookbook) contains further naming requirements.



 TOC 

3.3.  Security Requirements

An analysis of security issues is REQUIRED for all registered Enumservices. (This is in accordance with the basic requirements for all IETF protocols.)

All descriptions of security issues MUST be as accurate and extensive as feasible. In particular, a statement that there are "no security issues associated with this Enumservice" must not be confused with "the security issues associated with this Enumservice have not been assessed".

There is no requirement that an Enumservice must be completely free of security risks. Nevertheless, all known security risks MUST be identified in an Enumservice Specification.

The security considerations section of Enumservice Specifications is subject to continuing evaluation and modification, in accordance with Section 11.7 (Change Control).

Some of the issues to be looked at in a security analysis of an Enumservice are:

  1. Complex Enumservices may include provisions for directives that institute actions on a user's resources. In many cases provision can be made to specify arbitrary actions in an unrestricted fashion which may then have devastating results (especially if there is a risk for a new ENUM look-up, and because of that an infinite loop in the overall resolution process of the E.164 number).


  2. Complex Enumservices may include provisions for directives that institute actions which, while not directly harmful, may result in disclosure of information that either facilitates a subsequent attack or else violates the users' privacy in some way.


  3. An Enumservice might be targeted for applications that require some sort of security assurance but do not provide the necessary security mechanisms themselves. For example, an Enumservice could be defined for storage of confidential security services information such as alarm systems or message service passcodes, which in turn require an external confidentiality service.



 TOC 

3.4.  Publication Requirements

Enumservices Specifications MUST be published according to the requirements for "Specification Required" set out in "Guidelines for Writing an IANA Considerations Section in RFCs" (Narten, T. and H. Alvestrand, “Guidelines for Writing an IANA Considerations Section in RFCs,” May 2008.) [RFC5226]. RFCs fulfill these requirements. Therefore, it is strongly RECOMMENDED to publish Enumservice Specifications as RFCs.

In case the Enumservice Specification is not published as an RFC, sufficient information that allows to uniquely identify the Enumservice Specification MUST be provided.



 TOC 

4.  Enumservice Creation Cookbook



 TOC 

4.1.  General Enumservice Considerations

ENUM is an extremely flexible identifier mapping mechanism, using E.164 (phone) numbers as input identifiers, and returning URIs as output identifiers. Because of this flexibility, almost every use case for ENUM could be implemented in several ways.

Section 2 of "Guidelines for Writing an IANA Considerations Section in RFCs" (Narten, T. and H. Alvestrand, “Guidelines for Writing an IANA Considerations Section in RFCs,” May 2008.) [RFC5226] provides motivation why management of a name space might be necessary. Even though the namespace for Enumservices is rather large (up to 32 alphanumeric characters), there are reasons to manage this in accordance with Section 2 of [RFC5226] (Narten, T. and H. Alvestrand, “Guidelines for Writing an IANA Considerations Section in RFCs,” May 2008.). The following is a list of motivations applying to Enumservices:

Generally, before commencing work on a new Enumservice registration, the following should be considered:



 TOC 

4.2.  Classification, Type and Subtype

Because of their flexibility, Enumservices can be and are used in a lot of different ways. This section contains a classification of Enumservices, and provides guidance for choosing suitable Type and Subtype strings for each individual Enumservice Class.

The Classification of each Enumservice MUST be listed in the Registration Document (see Section 5.2 (IANA Registration (MANDATORY))). If the Enumservice cannot be assigned to one of the classes outlined below, the Registration Document MUST contain a section on the difficulties encountered while trying to classify the service to help the experts in their decision.



 TOC 

4.2.1.  General Type / Subtype Considerations

To avoid confusion, the name of a URI Scheme MUST NOT be used as a Type string for an Enumservice which is not specifically about the respective protocol or URI Scheme. For example, the Type string "imap" would be inadequate for use in an Enumservice about "Internet mapping" services, because it corresponds to an existing URI Scheme / protocol for something different.

If Subtypes are defined, the minimum number SHOULD be two (including the empty Subtype, if defined). The choice of just one possible Subtype for a given Type does not add any information when selecting an ENUM record, and hence can be left out completely. However, potential future expansion of a Type towards several Subtypes may justify the use of Subtypes, even in the case just one is currently defined, as noted in Section 9 (Extension of Existing Enumservice Specifications).

It is perfectly legal under a certain Type to mix the Enumservice without a Subtype (empty Subtype) with Enumservices containing a Subtype. In that case, however, the Enumservice with an empty Subtype SHOULD be specified to reflect the base service, while the other Enumservices SHOULD be specified to reflect variants.



 TOC 

4.2.2.  Protocol-Based Enumservices Class

Such an Enumservice indicates that an interaction using the named protocol will result for use of this NAPTR. The expected behavior of a system using this Enumservice MUST be clear from the protocol.

A good indication that an Enumservice belongs to this Class is the fact that a client does not need to understand the actual application to make use of an instance of this Enumservice.

Examples of such Enumservices include "xmpp" (Mayrhofer, A., “IANA Registration for Enumservice 'XMPP',” August 2007.) [RFC4979] and "sip" (Peterson, J., “enumservice registration for Session Initiation Protocol (SIP) Addresses-of-Record,” April 2004.) [RFC3764].



 TOC 

4.2.2.1.  Protocol-Based Enumservice "Type" Strings

A protocol-based Enumservice SHOULD use the lowercase name of the protocol as its Type string.



 TOC 

4.2.2.2.  Protocol-Based Enumservice "Subtype" Strings

Where there is a single URI Scheme associated with this protocol, a Subtype SHOULD NOT be specified for the Enumservice.

Where there are a number of different URI Schemes associated with this protocol, the Enumservice Specification MAY use the empty Subtype for all URI Schemes that it specifies as mandatory to implement. For each URI Scheme that is not mandatory to implement a distinct Subtype string MUST be used.

If Subtypes are defined, it is RECOMMENDED to use the URI Scheme name as the Subtype string.



 TOC 

4.2.3.  Application-Based Enumservice Classes

Application-based Enumservices are used when the kind of service intended is not fully defined by a protocol specification. There are three cases here:



 TOC 

4.2.3.1.  Application-Based Enumservice "Type" Strings

It is RECOMMENDED that Application-class Enumservices use the lowercase well known name of the abstract application as Type string.



 TOC 

4.2.3.2.  Application-Based Enumservice "Subtype" Strings

It is RECOMMENDED to use the URI Scheme(s) which the application uses, as Subtype string(s). Subtype strings MAY be shared between URI Schemes, if all the URI Schemes within the same Subtype are mandatory to implement.

If it is foreseen that there is only one URI Scheme ever to be used with the application, the empty Subtype string MAY be used.



 TOC 

4.2.4.  Data Type-Based Enumservice Class

"Data Type" Enumservices typically refer to a specific data type or format, which may be addressed using one or more URI Schemes and protocols. It is RECOMMENDED to use a well known name of the data type or format as the Enumservice Type string. Examples of such Enumservices include "vpim" (Vaudreuil, G., “Voice Message Routing Service,” October 2005.) [RFC4238] and "vcard" (Mayrhofer, A., “IANA Registration for vCard Enumservice,” August 2007.) [RFC4969].



 TOC 

4.2.4.1.  Data Type-Based Enumservice "Type" Strings

It is RECOMMENDED to use the lowercase well known name of the data type or format as the Type string.



 TOC 

4.2.4.2.  Data Type-Based Enumservice "Subtype" Strings

It is RECOMMENDED to use the URI Schemes used to access the service as Subtype string. Subtype strings MAY be shared between URI Schemes, if all the URI Schemes within the same Subtype are mandatory to implement.

If there is only one URI Scheme foreseen to access the data type or format, the empty Subtype string MAY be used.



 TOC 

4.2.5.  Other Enumservice

In case an Enumservice proposal cannot be assigned to any of the classes mentioned above, the <class> element (Enumservice Class) in the IANA Registration Template (see Section 5.2 (IANA Registration (MANDATORY))) MUST be populated with "Other". In that case, the Enumservice Specification MUST contain a section elaborating on why the Enumservice does not fit into the classification structure.



 TOC 

5.  Required Sections and Information

There are several sections that MUST appear in an Enumservice Specification. These sections are as follows, and SHOULD be in the given order.

The following terms SHOULD begin with a capital letter, whenever they refer to the IANA Registration:



 TOC 

5.1.  Introduction (MANDATORY)

An introductory section MUST be included. This section will explain, in plain English, the purpose and intended use of the proposed Enumservice registration.

The Introduction SHOULD start with a short sentence about ENUM, introduce the protocol used in the Enumservice, and discuss the Enumservice as it refers from the E.164 number to the protocol or service.



 TOC 

5.2.  IANA Registration (MANDATORY)

This section MUST be included in an Enumservice Specification. Where a given Enumservice Type has multiple Subtypes, there MUST be a separate "IANA Registration" section for each Subtype. The following lists the elements that are to be used in the XML template of an "IANA Registration" section.



 TOC 

5.2.1.  Enumservice Class (<class>)

This element contains the Class of the Enumservice as defined in Section 4.2 (Classification, Type and Subtype). Its value MUST be one of (without quotes):

e.g.   <class>Protocol-Based</class>



 TOC 

5.2.2.  Enumservice Type (<type>)

The Type of the Enumservice. All Types SHOULD be listed in lower-case. The choice of Type depends on the Enumservice Class. Please find further instructions in Section 4 (Enumservice Creation Cookbook).

e.g.   <type>foo</type>



 TOC 

5.2.3.  Enumservice Subtype (<subtype>)

The Subtype of the Enumservice. All Subtypes SHOULD be listed in lower-case. The choice of Subtype depends on the Enumservice Class. Should the Enumservice not require a Subtype, then the <subtype> element MUST be omitted in the registration XML chunk. If a given Enumservice Type has multiple Subtypes, then there MUST be a separate "IANA Registration" XML chunk for each Subtype. Please find further instructions in Section 4 (Enumservice Creation Cookbook).

e.g.   <subtype>bar</subtype>



 TOC 

5.2.4.  URI Scheme(s) (<urischeme>)

The URI Schemes that are used with the Enumservice. The selection of URI Schemes often depends on the Enumservice Class, Type, and/or Subtype. A colon MUST NOT be placed after the URI Scheme name. If there is more that one URI Scheme, then one <urischeme> element per URI scheme must be used in the XML chunk. Please find further instructions in Section 4 (Enumservice Creation Cookbook).

e.g.   <urischeme>bar</urischeme>
       <urischeme>sbar</urischeme>

Note: A client cannot choose a specific ENUM record in a record set based on the URI Scheme - the selection is only based on Type and Subtype, in accordance with [RFC3402] (Mealling, M., “Dynamic Delegation Discovery System (DDDS) Part Two: The Algorithm,” October 2002.).



 TOC 

5.2.5.  Functional Specification (<functionalspec>)

The Functional Specification describes how the Enumservice is used in connection with the URI to which it resolves.

e.g.   <functionalspec>
         <paragraph>
           This Enumservice indicates that the resource
           identified can be addressed by the associated
           URI in order to foo the bar.
         </paragraph>
         <paragraph>
           [...]
         </paragraph>
       </functionalspec>

Where the terms used are non-obvious, they should be defined in the Enumservice Specification, or a reference to an external document containing their definition should be provided.



 TOC 

5.2.6.  Security Considerations (<security>)

A reference to the "Security Considerations" section of a given Enumservice Specification.

e.g.   <security>
         See <xref type="rfc" data="rfc4979"/>, Section 6.
       </security>



 TOC 

5.2.7.  Intended Usage (<usage>)

One of the following values (without quotes):

e.g.   <usage>COMMON</usage>



 TOC 

5.2.8.  Enumservice Specification (<registrationdocs>)

Reference(s) to the Document(s) containing the Enumservice Specification.

e.g.   <registrationdocs>
         <xref type="rfc" data="rfc4979"/>
       </registrationdocs>


e.g.   <registrationdocs>
         <xref type="rfc" data="rfc8888"/> (obsoleted by RFC 9999)
         <xref type="rfc" data="rfc9999"/>
       </registrationdocs>


e.g.   <registrationdocs>
         [International Telecommunications Union,
         "Enumservice Specification for Foobar",
         ITU-F Recommendation B.193, Release 73, Mar 2009.]
       </registrationdocs>



 TOC 

5.2.9.  Requesters (<requesters>)

The persons requesting the registration of the Enumservice. Usually these are the authors of the Enumservice specification.

e.g.   <requesters>
         <xref type="person" data="John_Doe"/>
       </requesters>

       [...]

       <people>
         <person id="John_Doe">
           <name>John Doe</name>
           <org>ACME Research and Development Inc.</org>
           <uri>mailto:jd@acme.example.com</uri>
           <updated>2008-11-20</updated>
         </person>
       </people>

Note: If there is more than one requester, there must be one <xref> element per requester in the <requesters> element, and one <person> chunk per requester in the <people> element.



 TOC 

5.2.10.  Further Information (<additionalinfo>)

Any other information the authors deem interesting.

e.g.   <additionalinfo>
         <paragraph>more info goes here</paragraph>
       </additionalinfo>

Note: If there is no such additional information, then the <additionalinfo> element is omitted.



 TOC 

5.3.  Examples (MANDATORY)

This section MUST show at least one example of the Enumservice being registered, for illustrative purposes. The example(s) shall in no way limit the various forms that a given Enumservice may take, and this should be noted at the beginning of this section of the document. The example(s) MUST show the specific formatting of the intended NAPTRs (according to [RFC3403] (Mealling, M., “Dynamic Delegation Discovery System (DDDS) Part Three: The Domain Name System (DNS) Database,” October 2002.) and [I‑D.ietf‑enum‑3761bis] (Bradner, S., Conroy, L., and K. Fujiwara, “The E.164 to Uniform Resource Identifiers (URI) Dynamic Delegation Discovery System (DDDS) Application (ENUM),” November 2009.)), including one or more NAPTR example(s), AND a brief textual description, consisting of one or more sentences written in plain English, explaining the various parts or attributes of the record(s).

The example(s) SHOULD contain a brief description how a client supporting this Enumservice could behave, if that description was not already given in e.g. the Introduction or the Functional Specification.

The example(s) SHOULD follow any relevant IETF guidelines on the use of domain names, phone numbers, and other resource identifier examples, such as [RFC2606] (Eastlake, D. and A. Panitz, “Reserved Top Level DNS Names,” June 1999.).

e.g.
$ORIGIN 9.7.8.0.6.9.2.3.6.1.4.4.e164.arpa.
@ IN NAPTR 100 10 "u" "E2U+foo:bar" "!^.*$!bar://example.com/!" .



 TOC 

5.4.  Implementation Recommendations / Notes (OPTIONAL)

If at all possible, recommendations that pertain to implementation and/or operations SHOULD be included. Such a section is helpful to someone reading an Enumservice Specification and trying to understand how best to use it to support their network or service.



 TOC 

5.5.  Security Considerations (MANDATORY)

A section explaining any potential security threats that are unique to the given registration MUST be included. This MUST also include any information about access to Personally Identifiable Information (PII).

An Enumservice Specification SHOULD NOT include general and obvious security recommendations, such as securing servers with strong password authentication.

[RFC3552] (Rescorla, E. and B. Korver, “Guidelines for Writing RFC Text on Security Considerations,” July 2003.) provides guidance to write a good Security Considerations section, Section 10.2 (Enumservice Security Considerations Guideline) of this document contains guidance specific to Enumservice registration.



 TOC 

5.6.  IANA Considerations (MANDATORY)

Describe the task IANA needs to fulfill processing the Enumservice Registration Document.

e.g.
This document requests the IANA registration of the Enumservice with Type "foo" and Subtype "bar" according to the definitions in this document, RFC XXXX [Note for RFC Editor: Please replace XXXX with the RFC number of this document before publication] and [I‑D.ietf‑enum‑3761bis] (Bradner, S., Conroy, L., and K. Fujiwara, “The E.164 to Uniform Resource Identifiers (URI) Dynamic Delegation Discovery System (DDDS) Application (ENUM),” November 2009.).


e.g.
This document requests an update of the IANA registration of the Enumservice Type "foo" with Subtype "bar", according to the definitions in this document, RFC XXXX [Note for RFC Editor: Please replace XXXX with the RFC number of this document before publication] and [I‑D.ietf‑enum‑3761bis] (Bradner, S., Conroy, L., and K. Fujiwara, “The E.164 to Uniform Resource Identifiers (URI) Dynamic Delegation Discovery System (DDDS) Application (ENUM),” November 2009.). Therefore, in the existing IANA registration for this Enumservice, the <registrationdocs> element (Enumservice Specification) is enhanced by adding a supplementary reference that points to this document.


e.g.
This document requests an update of the IANA registration of the Enumservice Type "foo" with all its Subtypes, in order to declare it obsolete. Therefore, in the existing IANA registration for this Enumservice, the <usage> element (Intended Usage) is changed to "OBSOLETE", and the <registrationdocs> element (Enumservice Specification) is enhanced by adding a supplementary reference that points to this document.



 TOC 

5.7.  DNS Considerations (MANDATORY)

In case the inclusion of protocols and URI Schemes into ENUM specifically introduces new DNS issues, those MUST be described within this section.

Such DNS issues include, but are not limited to:

Rationale: some Enumservices try to exploit side effects of the DNS that need to be explicitly discussed.



 TOC 

5.8.  Other Sections (OPTIONAL)

Other sections beyond those required above MAY be included in an Enumservice Specification. These sections may relate to the specifics of the intended use of the Enumservice registration, as well as to any associated technical, operational, administrative, or other concerns.

A use case SHOULD be included by the authors of the proposal, so that experts can better understand the problem the proposal seeks to solve (intended use of the Enumservice). The inclusion of such a use case will both accelerate the Expert Review process, as well as make any eventual registration easier to understand and implement by other parties.



 TOC 

6.  The Process of Registering New Enumservices

This section is an illustration of the process by which a new Enumservice Registration Document is submitted for review and comment, how such proposed Enumservices are reviewed, and how they are published.

Figure 1 shows what authors of a Registration Document describing an Enumservice MUST carry out before said Registration Document can be formally submitted to IANA for Expert Review. Figure 2 shows the process from Expert Review onwards.



                  +----------------------------+
                  | Step 1: Read this document |
                  +----------------------------+
                               |
                               V
                +-------------------------------+
                | Step 2:  Write R-D and submit |
                +-------------------------------+
                               |
                               V
          +--------------------------------------------+
          | Step 3:  Announce R-D and solicit feedback |<--+
          +--------------------------------------------+   |
                               |                           |
                               V                           |
                              .^.                          |
                            .     .                        |
+------------+            .  Feed-  .               +------------+
| Update R-D |<---------<    back     >------------>| Update R-D |
| and submit |  non-sub-  . results .   substantial | and submit |
+------------+  stantial    . in: .     changes     +------------+
      |         changes       . .       needed
      |         needed         Y
      |                        | no changes needed
      |                        V
      |         +-----------------------------+
      +-------->| Step 4:  Submit R-D to IANA |
                +-----------------------------+
                               :
                               :
                               V

R-D: Registration Document
 Figure 1 



 TOC 

6.1.  Step 1: Read this Document in Detail

This document describes all of the necessary sections required and recommended, and makes suggestions on content.



 TOC 

6.2.  Step 2: Write and Submit Registration Document

An Internet-Draft (or another specification as appropriate) MUST be written and made publicly available (submitted). The Registration Document MUST follow the guidelines according to Sections 4 (Enumservice Creation Cookbook) and 5 (Required Sections and Information) of this document. The Review Guidelines for experts as defined in Section 7.2 (Review Guidelines) MUST be regarded.



 TOC 

6.3.  Step 3: Request Comments from the IETF Community

The authors MUST send an email to <enum@ietf.org>, in which comments on the Registration Document are requested. A proper public reference (a URL is RECOMMENDED) to the Registration Document MUST be included in this email.

Note: The ENUM WG mailing list <enum@ietf.org> will be kept open after conclusion of the ENUM WG.

The authors SHOULD allow a reasonable period of time to elapse, such as two to four weeks, in order to collect any feedback. The authors then consider whether or not to take any of those comments into account, by making changes to the Registration Document and submitting a revision, or otherwise proceeding. The following outcomes are open to the authors. The choice of path is left to the authors' judgement.

Note: Whatever the outcome is, the experts performing the Expert Review later in the processs are not bound to any decision during this phase.



 TOC 

6.3.1.  Outcome 1: No Changes Needed

No changes to the Registration Document are made, and the authors proceed to Step 4 below.

This outcome is recommended when the feedback received does not lead to a new revision of the Registration Document.



 TOC 

6.3.2.  Outcome 2: Changes, but no further Comments Requested

The authors update the Registration Document and is/are confident that all issues are resolved and do not require further discussion. The authors proceed to Step 4 below.

This outcome is recommended when minor objections have been raised, or minor changes have been suggested.



 TOC 

6.3.3.  Outcome 3: Changes and further Comments Requested

The authors update and submit the Registration Document, and proceed to Step 3 above, which involves sending another email to <enum@ietf.org> to request additional comments for the updated version.

This outcome is recommended when substantial objections have been raised, or substantial changes have been suggested.



 TOC 

6.4.  Step 4: Submit Registration Document to IANA

The authors submit the Registration Document to IANA (using the <http://www.iana.org/> website) for Expert Review.



                               :
                               :
                               V
                    +-----------------------+
                    | Step 5: Expert Review |<-------------+
                    +-----------------------+              |
                               |                           |
                               V                           |
                              .^.                          |
                            .     .                        |
  .---------.             .  Expert .               +------------+
 ( Bad luck! )<-------- <    Review   >------------>| Update R-D |
  `---------'   experts   . results .   changes     | and submit |
                reject      . in: .     required    +------------+
                              . .
                               Y
                               | experts approve
                               V
             +-----------------------------------+
             | Step 6: Publication of R-D        |
             +-----------------------------------+
                               |
                               V
        +---------------------------------------------+
        | Step 7: Adding Enumservice to IANA Registry |
        +---------------------------------------------+

R-D: Registration Document
 Figure 2 



 TOC 

6.5.  Step 5: Expert Review

IANA will conduct an "Expert Review" according to [RFC5226] (Narten, T. and H. Alvestrand, “Guidelines for Writing an IANA Considerations Section in RFCs,” May 2008.). The Expert Review guidelines are outlined in Section 7.2 (Review Guidelines) of this document. The authors MUST be prepared for further interaction with IANA and the experts.



 TOC 

6.5.1.  Outcome 1: Experts Approve the Registration Document

No (more) changes to the Registration Document are made. IANA will inform the authors, who then will proceed to Step 6 below.



 TOC 

6.5.2.  Outcome 2: Changes Required

The experts might require changes before they can approve the Registration Document. The authors update and submit the Registration Document. The authors inform the experts about the available update, who then continue the Expert Review Process.



 TOC 

6.5.3.  Outcome 3: Experts Reject the Registration Document

The expert might reject the Registration, which means the Expert Review process is discontinued.



 TOC 

6.6.  Step 6: Publication of the Registration Document

The authors are responsible that the Registration Document is published according to "Specification Required" as defined in [RFC5226] (Narten, T. and H. Alvestrand, “Guidelines for Writing an IANA Considerations Section in RFCs,” May 2008.).

As set out in Section 3.4 (Publication Requirements) it is strongly RECOMMENDED to publish Enumservice Specifications as RFCs. As to every RFC the normal IETF publication process applies (see [Instructions2authors] (Reynolds, J. and R. Braden, “Instructions to Request for Comments (RFC) Authors,” August 2004.)); i.e. the Registration Document is submitted in the form of an Internet Draft (e.g. via an IETF Working Group or a sponsoring Area Director). [Instructions2authors] (Reynolds, J. and R. Braden, “Instructions to Request for Comments (RFC) Authors,” August 2004.) also contains an option to publish an RFC as 'Independent Submission', which is further described in "Independent Submissions to the RFC Editor" (Klensin, J. and D. Thaler, “Independent Submissions to the RFC Editor,” July 2007.) [RFC4846].



 TOC 

6.7.  Step 7: Adding Enumservice to IANA Registry

In case the Registration Document is to be published as an RFC, the RFC publication process ensures that IANA will add the Enumservice to the Registry.

In case the Registration Document is to be published in a specification other than RFC, the authors MUST inform IANA, as soon as the Enumservice Specification has been published according to "Specification Required" as defined in [RFC5226] (Narten, T. and H. Alvestrand, “Guidelines for Writing an IANA Considerations Section in RFCs,” May 2008.). The <registrationdocs> element in the IANA Template MUST contain an unambiguous reference to the Enumservice Specification (see also Section 5.2 (IANA Registration (MANDATORY))). In addition, the authors MUST provide IANA with a stable URL to the Enumservice Specification, in order that IANA may obtain the information included in the Enumservice Specification. IANA will then add the Enumservice to the Registry.



 TOC 

7.  Expert Review



 TOC 

7.1.  Expert Selection Process

According to Section 3.2 of [RFC5226] (Narten, T. and H. Alvestrand, “Guidelines for Writing an IANA Considerations Section in RFCs,” May 2008.), experts are appointed by the IESG upon recommendation by the RAI Area Directors. The RAI area directors are responsible for ensuring that there is always a sufficient pool of experts available.



 TOC 

7.2.  Review Guidelines

Generally, the "Expert Review" process of an Enumservice MUST follow the guidelines documented in Section 3.3 of "Guidelines for Writing an IANA Considerations Section in RFCs" (Narten, T. and H. Alvestrand, “Guidelines for Writing an IANA Considerations Section in RFCs,” May 2008.) [RFC5226].

The experts MUST evaluate the criterion as set out in [RFC5226] (Narten, T. and H. Alvestrand, “Guidelines for Writing an IANA Considerations Section in RFCs,” May 2008.), as well as consider the following:

In case of conflicts between [RFC5226] (Narten, T. and H. Alvestrand, “Guidelines for Writing an IANA Considerations Section in RFCs,” May 2008.) and the guidelines in this section, the former remains authoritative.



 TOC 

7.3.  Appeals

Appeals of Expert Review decisions follow the process described in section 7 of [RFC5226] (Narten, T. and H. Alvestrand, “Guidelines for Writing an IANA Considerations Section in RFCs,” May 2008.) and section 6.5 of [RFC2026] (Bradner, S., “The Internet Standards Process -- Revision 3,” October 1996.).



 TOC 

8.  Revision of Pre-Existing Enumservice Specifications

Many Enumservice Registrations, published via IETF RFCs, already exist at the time of the development of this document. These existing Enumservice Specifications MAY be revised to comply with the specifications contained herein. All revisions of Enumservice Specifications MUST be compliant with the specifications contained herein.

Note: Enumservice Specifications updated only by [I‑D.ietf‑enum‑enumservices‑transition] (Hoeneisen, B. and A. Mayrhofer, “Update of legacy IANA Registrations of Enumservices,” April 2010.) are not compliant with the specifications contained herein!



 TOC 

9.  Extension of Existing Enumservice Specifications

There are cases where it is more sensible to extend an existing Enumservice registration rather than proposing a new one. Such cases include adding a new Subtype to an existing Type. Depending on the nature of the extension, the original Enumservice Specification needs to be extended (Updates) or replaced (Obsoletes) [RFC2223] (Postel, J. and J. Reynolds, “Instructions to RFC Authors,” October 1997.). Specifically, an update is appropriate when a new Subtype is being added without changes to the existing repertoire. A replacement is needed if there is a change to the default, or changes to the assumptions of URI support in clients.

Any Enumservice Specifications for existing Enumservices that are extended MUST comply with the specifications contained herein. As a consequence, revisions of existing Enumservice Specifications according to Section 8 (Revision of Pre-Existing Enumservice Specifications) may be required.



 TOC 

10.  Security Considerations



 TOC 

10.1.  Considerations Regarding This Document

Since this document does not introduce any new technology, protocol, or Enumservice Specification, there are no specific security issues to be considered for this document. However, as this is a guide to authors of new Enumservice Specifications, the next section should be considered closely by authors and experts.



 TOC 

10.2.  Enumservice Security Considerations Guideline

[I‑D.ietf‑enum‑3761bis] (Bradner, S., Conroy, L., and K. Fujiwara, “The E.164 to Uniform Resource Identifiers (URI) Dynamic Delegation Discovery System (DDDS) Application (ENUM),” November 2009.) already outlines security considerations affecting ENUM as a whole. Enumservice Specifications do not need to and SHOULD NOT repeat considerations already listed in that document. However, Enumservice Specifications SHOULD include a reference to that section.

ENUM refers to resources using existing URI Schemes and protocols. Enumservice Specifications do not need to and SHOULD NOT repeat security considerations affecting those protocols and URI Schemes themselves.

However, in some cases, the inclusion of those protocols and URI Schemes into ENUM specifically could introduce new security issues. In these cases, those issues or risks MUST be covered in the "Security Considerations" section of the Enumservice Specification. Authors should pay particular attention to any indirect risks that are associated with a proposed Enumservice, including cases where the proposed Enumservice could lead to the discovery or disclosure of Personally Identifiable Information (PII).



 TOC 

11.  IANA Considerations



 TOC 

11.1.  Registry Update

IANA will update the Registry "Enumservice Registrations" as defined in (this) Section 11 (IANA Considerations), which will replace the old mechanism as defined in RFC 3761 (Faltstrom, P. and M. Mealling, “The E.164 to Uniform Resource Identifiers (URI) Dynamic Delegation Discovery System (DDDS) Application (ENUM),” April 2004.) [RFC3761].

It is noted that the process described herein applies only to ordinary Enumservice registrations (i.e. the registration process of "X-" Enumservices is beyond the scope of this document).



 TOC 

11.2.  Registration Template (XML chunk)

The XML chunk listed below should be used as a template to create the IANA Registration Template. Examples for the use of this template are contained in Appendix A (IANA XML Template Examples).

        <record>
          <class> <!-- Enumservice Class --> </class>
          <type> <!-- Type --> </type>
          <subtype> <!-- Subtype --> </subtype>
          <urischeme> <!-- URI Schema Name --> </urischeme>
          <urischeme> <!-- another URI Schema Name --> </urischeme>
          <functionalspec>
            <paragraph>
              <!-- Text that explains the functionality of
                   the Enumservice to be registered -->
            </paragraph>
          </functionalspec>
          <security>
            <!-- Change accordingly -->
            See <xref type="rfc" data="rfc9999"/>, Section 7.
          </security>
          <usage> <!-- COMMON, LIMITED USE or OBSOLETE --> </usage>
          <registrationdocs>
            <!-- Change accordingly -->
            <xref type="rfc" data="rfc9999"/>
          </registrationdocs>
          <requesters>
            <!-- Change accordingly -->
            <xref type="person" data="John_Doe"/>
            <xref type="person" data="Jane_Dale"/>
          </requesters>
          <additionalinfo>
            <paragraph>
              <!-- Text with additional information about
                   the Enumservice to be registered -->
            </paragraph>
            <artwork>
              <!-- There can be artwork sections, too -->
              :-)
            </artwork>
          </additionalinfo>
        </record>

       <people>
         <person id="John_Doe">
           <name> <!-- Firstname Lastname --> </name>
           <org> <!-- Organisation Name --> </org>
           <uri> <!-- mailto: or http: URI --> </uri>
           <updated> <!-- date format YYYY-MM-DD --> </updated>
         </person>
         <!-- repeat person section for each person -->
       </people>



 TOC 

11.3.  Location

Approved Enumservice registrations are published in the IANA Registry named "Enumservice Registrations", which is available at the following URI:
< http://www.iana.org/assignments/enum-services >.

This Registry publishes representations derived from the IANA Registration Template as described in Section 11.2 (Registration Template (XML chunk)) and specified in Section 5.2 (IANA Registration (MANDATORY)).

Where the Enumservice Specification is NOT an RFC, IANA MUST hold an escrow copy of that Enumservice Specification. Said escrow copy will act as the master reference for that Enumservice Registration.



 TOC 

11.4.  Structure

IANA maintains the Enumservice Registry sorted in alphabetical order. The first sort field is Type, the second is Subtype.

Each Enumservice starts with a caption, which is composed of Type and Subtype, separated by a colon; e.g. if the Type is "foo" and the Subtype "bar", the resulting caption is "foo:bar".

[I‑D.ietf‑enum‑enumservices‑transition] (Hoeneisen, B. and A. Mayrhofer, “Update of legacy IANA Registrations of Enumservices,” April 2010.) updates the existing Enumservices by transforming them into the new XML chunk based IANA Registration Template (see also Section 8 (Revision of Pre-Existing Enumservice Specifications)).



 TOC 

11.5.  Expert Review Procedure

Whenever a Registration Document is submitted via the IANA website, IANA will take care of the "Expert Review" process according to "Guidelines for Writing an IANA Considerations Section in RFCs" (Narten, T. and H. Alvestrand, “Guidelines for Writing an IANA Considerations Section in RFCs,” May 2008.) [RFC5226].

To prevent clashes IANA will check whether a request with identical "type:subtype" (or "type" without Subtype) was submitted for Expert Review earlier and will inform the experts accordingly. It is up to the experts to resolve possible clashes.

Once the experts have approved the Enumservice, IANA will inform the authors. This information SHOULD also include a reminder that (i) the authors are now responsible for publication of the Registration Document (see also Section 6.6 (Step 6: Publication of the Registration Document)) and (ii) the Enumservice will be added to the IANA Registry only after its Enumservice Specification is published according to the "Specification Required" policy as defined in [RFC5226] (Narten, T. and H. Alvestrand, “Guidelines for Writing an IANA Considerations Section in RFCs,” May 2008.) (see also Section 6.7 (Step 7: Adding Enumservice to IANA Registry)).

Note: After sending the approval note to the authors, IANA has no further responsibilities besides keeping internal records of approved Registration Documents. IANA will be involved again at registration of the Enumservice (see Section 11.6 (Registration Procedure)).



 TOC 

11.6.  Registration Procedure

There is a slight difference in process depending on whether or not the Enumservice Specification will be published as an RFC. The reason for this difference lies in the current RFC publication process that foresees IANA interaction shortly before publication of an RFC.



 TOC 

11.6.1.  Published as RFC

As per the RFC publication process IANA will receive the Enumservice Specification to carry out IANA actions shortly before publication of the RFC. The IANA action will be to register the Enumservice, i.e. add the Enumservice to the IANA "Enumservice Registrations" Registry (see also Section 11.3 (Location)).

IANA MUST only add Enumservices to the Registry, if the experts have approved the corresponding Enumservice Specification as to be published. IANA SHOULD attempt to resolve possible conflicts arising from this together with the experts. In case changes between the approved and the to be published version are substantial, IANA MAY reject the request after consulting the experts.

IANA MUST ensure that any further changes the Enumservice Specification might undergo before final RFC publication are approved by the experts.



 TOC 

11.6.2.  Published as generic Specification

Once the authors have informed IANA about the publication, IANA MUST ensure that the requirements to "Specification Required" as defined in [RFC5226] (Narten, T. and H. Alvestrand, “Guidelines for Writing an IANA Considerations Section in RFCs,” May 2008.) are met, the reference to the specification is unambiguous, and the content of the Enumservice Specification is identical to the Registration Document as approved by the experts. IANA will then register the Enumservice, i.e. add the Enumservice to the IANA "Enumservice Registrations" Registry, and make an escrow copy (see also Section 11.3 (Location)).

IANA MUST only add Enumservices to the Registry, if the experts have approved the corresponding Enumservice Specification as published. IANA SHOULD attempt to resolve possible conflicts arising from this together with the experts. In case changes between the approved and the published version are substantial, IANA MAY reject the request after consulting the experts.



 TOC 

11.7.  Change Control

Change control of any Enumservice Registrations is done by "Specification Required", which implies the use of a Designated Expert, according to [RFC5226] (Narten, T. and H. Alvestrand, “Guidelines for Writing an IANA Considerations Section in RFCs,” May 2008.). Updates of Enumservice Specifications MUST comply with the guidelines described in this document. Updates are handled the same way as initial Enumservice Registrations.

Authorized Change Controllers are the experts and the IESG.

Enumservice registrations MUST NOT be deleted. An Enumservice that is believed no longer appropriate for use can be declared obsolete by publication of a new Enumservice Specification changing its <usage> element (Intended Usage) to "OBSOLETE"; such Enumservices will be clearly marked in the lists published by IANA. As obsoletions are updates, they are also handled the same way as initial Enumservice Registrations.



 TOC 

11.8.  Restrictions

As stated in Section 3.2 (Naming Requirements), a "-" (dash) MUST NOT be used as the first nor as the second nor as the last character of a Type nor a Subtype. Furthermore, Type nor Subtype of any Enumservice MUST NOT be set to nor start with "E2U". Any Enumservice registration requests not following these restrictions MUST be rejected by IANA, and the Expert Review process SHOULD NOT be initiated.

Section 5.2 (IANA Registration (MANDATORY)) contains examples for Enumservice registrations. Therefore, IANA MUST NOT register an Enumservice with Type or Subtype set to "foo", "bar", or "sbar", unless the experts explicitly confirm an exception.



 TOC 

12.  Acknowledgements

The authors would like to thank the following people who have provided feedback or significant contributions to the development of this document: Gonzalo Camarillo, Lawrence Conroy, Michelle Cotton, Alfred Hoenes, Peter Koch, Edward Lewis, Jon Peterson, and Pekka Savola

Lawrence Conroy has provided extensive text for the Enumservice Classification section.

Section 3 of RFC 3761 (Faltstrom, P. and M. Mealling, “The E.164 to Uniform Resource Identifiers (URI) Dynamic Delegation Discovery System (DDDS) Application (ENUM),” April 2004.) [RFC3761], which was edited by Patrik Faltstrom and Michael Mealling, has been incorporated into this document. Please see the Acknowledgments section in RFC 3761 for additional acknowledgments.



 TOC 

13.  References



 TOC 

13.1. Normative References

[RFC2119] Bradner, S., “Key words for use in RFCs to Indicate Requirement Levels,” BCP 14, RFC 2119, March 1997 (TXT, HTML, XML).
[RFC2026] Bradner, S., “The Internet Standards Process -- Revision 3,” BCP 9, RFC 2026, October 1996 (TXT).
[RFC3761] Faltstrom, P. and M. Mealling, “The E.164 to Uniform Resource Identifiers (URI) Dynamic Delegation Discovery System (DDDS) Application (ENUM),” RFC 3761, April 2004 (TXT).
[I-D.ietf-enum-3761bis] Bradner, S., Conroy, L., and K. Fujiwara, “The E.164 to Uniform Resource Identifiers (URI) Dynamic Delegation Discovery System (DDDS) Application (ENUM),” draft-ietf-enum-3761bis-06 (work in progress), November 2009 (TXT).
[RFC3402] Mealling, M., “Dynamic Delegation Discovery System (DDDS) Part Two: The Algorithm,” RFC 3402, October 2002 (TXT).
[RFC3403] Mealling, M., “Dynamic Delegation Discovery System (DDDS) Part Three: The Domain Name System (DNS) Database,” RFC 3403, October 2002 (TXT).
[RFC5226] Narten, T. and H. Alvestrand, “Guidelines for Writing an IANA Considerations Section in RFCs,” BCP 26, RFC 5226, May 2008 (TXT).


 TOC 

13.2. Informative References

[I-D.ietf-enum-enumservices-transition] Hoeneisen, B. and A. Mayrhofer, “Update of legacy IANA Registrations of Enumservices,” draft-ietf-enum-enumservices-transition-05 (work in progress), April 2010 (TXT).
[RFC1035] Mockapetris, P., “Domain names - implementation and specification,” STD 13, RFC 1035, November 1987 (TXT).
[RFC2223] Postel, J. and J. Reynolds, “Instructions to RFC Authors,” RFC 2223, October 1997 (TXT, HTML, XML).
[Instructions2authors] Reynolds, J. and R. Braden, “Instructions to Request for Comments (RFC) Authors,” RFC Editor http://www.rfc-editor.org/rfc-editor/instructions2authors.txt, August 2004.
[RFC2606] Eastlake, D. and A. Panitz, “Reserved Top Level DNS Names,” BCP 32, RFC 2606, June 1999 (TXT).
[RFC3552] Rescorla, E. and B. Korver, “Guidelines for Writing RFC Text on Security Considerations,” BCP 72, RFC 3552, July 2003 (TXT).
[RFC3764] Peterson, J., “enumservice registration for Session Initiation Protocol (SIP) Addresses-of-Record,” RFC 3764, April 2004 (TXT).
[RFC3966] Schulzrinne, H., “The tel URI for Telephone Numbers,” RFC 3966, December 2004 (TXT).
[RFC3986] Berners-Lee, T., Fielding, R., and L. Masinter, “Uniform Resource Identifier (URI): Generic Syntax,” STD 66, RFC 3986, January 2005 (TXT, HTML, XML).
[RFC4238] Vaudreuil, G., “Voice Message Routing Service,” RFC 4238, October 2005 (TXT).
[RFC4759] Stastny, R., Shockey, R., and L. Conroy, “The ENUM Dip Indicator Parameter for the "tel" URI,” RFC 4759, December 2006 (TXT).
[RFC4846] Klensin, J. and D. Thaler, “Independent Submissions to the RFC Editor,” RFC 4846, July 2007 (TXT).
[RFC4969] Mayrhofer, A., “IANA Registration for vCard Enumservice,” RFC 4969, August 2007 (TXT).
[RFC4979] Mayrhofer, A., “IANA Registration for Enumservice 'XMPP',” RFC 4979, August 2007 (TXT).
[RFC5234] Crocker, D. and P. Overell, “Augmented BNF for Syntax Specifications: ABNF,” STD 68, RFC 5234, January 2008 (TXT).
[ITU.E164.2005] International Telecommunications Union, “The International Public Telecommunication Numbering Plan,” ITU-T Recommendation E.164, Feb 2005.


 TOC 

Appendix A.  IANA XML Template Examples

This section contains non-normative examples of the IANA Registration Template XML chunk.



This is the first example:



        <record>
          <class>Protocol-Based</class>
          <type>email</type>
          <subtype>mailto</subtype>
          <urischeme>mailto</urischeme>
          <functionalspec>
            <paragraph>
              This Enumservice indicates that the resource
              can be addressed by the associated URI in
              order to send an email.
            </paragraph>
          </functionalspec>
          <security>
            See <xref type="rfc" data="rfc4355"/>, Section 6.
          </security>
          <usage>COMMON</usage>
          <registrationdocs>
            <xref type="rfc" data="rfc4355"/>
          </registrationdocs>
          <requesters>
            <xref type="person" data="Lawrence_Conroy"/>
          </requesters>
        </record>

        <people>
          <person id="Lawrence_Conroy">
            <name>Lawrence Conroy</name>
            <org>Siemens Roke Manor Research</org>
            <uri>mailto:lwc@roke.co.uk</uri>
            <updated>2008-11-20</updated>
          </person>
        </people>



This is the second example.



        <record>
          <class>Protocol-Based</class>
          <type>xmpp</type>
          <urischeme>xmpp</urischeme>
          <functionalspec>
            <paragraph>
              This Enumservice indicates that the
              resource identified is an XMPP entity.
            </paragraph>
          </functionalspec>
          <security>
            See <xref type="rfc" data="rfc4979"/>, Section 6.
          </security>
          <usage>COMMON</usage>
          <registrationdocs>
            <xref type="rfc" data="rfc4979"/>
          </registrationdocs>
          <requesters>
            <xref type="person" data="Alexander_Mayrhofer"/>
          </requesters>
        </record>

        <people>
          <person id="Alexander_Mayrhofer">
            <name>Alexander Mayrhofer</name>
            <org>enum.at GmbH</org>
            <uri>mailto:alexander.mayrhofer@enum.at</uri>
            <updated>2008-10-10</updated>
          </person>
        </people>



This is the third example:



        <record>
          <class>Application-Based</class>
          <type>voicemsg</type>
          <subtype>sip</subtype>
          <urischeme>sip</urischeme>
          <functionalspec>
            <paragraph>
              This Enumservice indicates that the resource
              identified can be addressed by the associated
              URI scheme in order to initiate a voice
              communication session to a voice messaging system.
            </paragraph>
          </functionalspec>
          <security>
            See <xref type="rfc" data="rfc4279"/>, Section 3.
          </security>
          <usage>COMMON</usage>
          <registrationdocs>
            <xref type="rfc" data="rfc4279"/>
          </registrationdocs>
          <requesters>
            <xref type="person" data="Jason_Livingood"/>
            <xref type="person" data="Donald_Troshynski">
          </requesters>
          <additionalinfo>
            <paragraph>
              Implementers should review a non-exclusive list of
              examples in <xref type="rfc" data="rfc4279"/>,
              Section 7.
            </paragraph>
          </additionalinfo>
        </record>

        <people>
          <person id="Jason_Livingood">
            <name>Jason Livingood</name>
            <org>Comcast Cable Communications</org>
            <uri>mailto:jason_livingood@cable.comcast.com</uri>
            <updated>2008-11-20</updated>
          </person>
          <person id="Donald_Troshynski">
            <name>Donald Troshynski</name>
            <org>Acme Packet</org>
            <uri>mailto:dtroshynski@acmepacket.com</uri>
            <updated>2008-11-20</updated>
          </person>
        </people>

Note: The "voicemsg" Enumservice has several Subtypes. For each Subtype, an individual XML chunk must be submitted to IANA, with only the first one shown above. This is to avoid any ambiguity of the relation between <subtype> and <urischeme> elements.



 TOC 

Appendix B.  Changes Overview

This section lists the changes applied to the Enumservice registration process and the IANA Registry definition, compared to RFC 3761.





 TOC 

Appendix C.  Document Changelog

[RFC Editor: This section is to be removed before publication]

draft-ietf-enum-enumservices-guide-20:

draft-ietf-enum-enumservices-guide-19:

draft-ietf-enum-enumservices-guide-18:

draft-ietf-enum-enumservices-guide-17:

draft-ietf-enum-enumservices-guide-16:

draft-ietf-enum-enumservices-guide-15:

draft-ietf-enum-enumservices-guide-14:

draft-ietf-enum-enumservices-guide-13:

draft-ietf-enum-enumservices-guide-12:

draft-ietf-enum-enumservices-guide-11:

draft-ietf-enum-enumservices-guide-10:

draft-ietf-enum-enumservices-guide-09:

draft-ietf-enum-enumservices-guide-08:

draft-ietf-enum-enumservices-guide-07:

draft-ietf-enum-enumservices-guide-06:

draft-ietf-enum-enumservices-guide-05:

draft-ietf-enum-enumservices-guide-04:

draft-ietf-enum-enumservices-guide-03:

draft-ietf-enum-enumservices-guide-02:

draft-ietf-enum-enumservices-guide-01:



 TOC 

Appendix D.  Open Issues

[RFC Editor: This section should be empty and is to be removed before publication]



 TOC 

Authors' Addresses

  Bernie Hoeneisen
  Ucom Standards Track Solutions Company
  CH-8049 Zuerich
  Switzerland
Phone:  +41 44 500 52 44
Email:  bernie@ietf.hoeneisen.ch (bernhard.hoeneisen AT ucom.ch)
URI:  http://www.ucom.ch/
  
  Alexander Mayrhofer
  enum.at GmbH
  Karlsplatz 1/9
  Wien A-1010
  Austria
Phone:  +43 1 5056416 34
Email:  alexander.mayrhofer@enum.at
URI:  http://www.enum.at/
  
  Jason Livingood
  Comcast Cable Communications
  One Comcast Center
  1701 John F. Kennedy Boulevard
  Philadelphia, PA 19103
  USA
Phone:  +1-215-286-7813
Email:  jason_livingood@cable.comcast.com
URI:  http://www.comcast.com/