Internet Core Protocols

home *** CD-ROM | disk | FTP | other *** search

/ Internet Core Protocols / Oreilly-InternetCoreProtocols.iso / RFCs / rfc2425.txt < prev next >

Wrap

Text File | 1999-10-14 | 64.7 KB | 1,852 lines

Network Working Group T. Howes Request for Comments: 2425 M. Smith Category: Standards Track Netscape Communications Corp. F. Dawson Lotus Development Corporation September 1998 A MIME Content-Type for Directory Information Status of this Memo This document specifies an Internet standards track protocol for the Internet community, and requests discussion and suggestions for improvements. Please refer to the current edition of the "Internet Official Protocol Standards" (STD 1) for the standardization state and status of this protocol. Distribution of this memo is unlimited. Copyright Notice Copyright (C) The Internet Society (1998). All Rights Reserved. 1. Abstract This document defines a MIME Content-Type for holding directory information. The definition is independent of any particular directory service or protocol. The text/directory Content-Type is defined for holding a variety of directory information, for example, name, or email address, or logo. The text/directory Content-Type can also be used as the root body part in a multipart/related Content- Type for handling more complicated situations, especially those in which non-textual information that already has a natural MIME representation, for example, a photograph or sound, is to be represented. The text/directory Content-Type defines a general framework and format for holding directory information in a simple "type:value" form. We refer to "type" in this context meaning a property or attribute with which the value is associated. Mechanisms are defined to specify alternate languages, encodings and other meta-information. This document also defines the procedure by which particular formats, called profiles, for carrying application-specific information within a text/directory Content-Type can be defined and registered, and the conventions such formats must follow. It is expected that other documents will be produced that define such formats for various applications (e.g., white pages). Howes, et. al. Standards Track [Page 1] RFC 2425 MIME Content-Type for Directory Information September 1998 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]. 2. Table of Contents Status of the Memo................................................ 1 Copyright Notice.................................................. 1 1. Abstract...................................................... 1 2. Table of Contents............................................. 2 3. Need for a MIME Directory Type................................ 3 4. Overview...................................................... 4 5. The text/directory Content-Type............................... 4 5.1. MIME media type name........................................ 4 5.2. MIME subtype name........................................... 5 5.3. Required parameters......................................... 5 5.4. Optional parameters......................................... 5 5.5. Encoding considerations..................................... 5 5.6. Security considerations..................................... 6 5.7. Interoperability considerations............................. 6 5.8. Published specification..................................... 6 5.8.1. Line delimiting and folding............................... 6 5.8.2. ABNF content-type definition.............................. 7 5.8.3. Pre-defined Parameters.................................... 9 5.8.4. Pre-defined Value Types...................................11 5.9. Applications which use this media type......................14 5.10. Additional information.....................................14 5.11. Person & email address to contact for further information..14 5.12. Intended usage.............................................14 5.13. Author/Change controller...................................15 6. Predefined Types..............................................15 6.1. SOURCE Type Definition......................................15 6.2. NAME Type Definition........................................16 6.3. PROFILE Type Definition.....................................16 6.4. BEGIN Type Definition.......................................17 6.5. END Type Definition.........................................17 7. Use of the multipart/related Content-Type.....................18 8. Examples.......................................................18 8.1. Example 1...................................................19 8.2. Example 2...................................................19 8.3. Example 3...................................................20 8.4. Example 4...................................................21 9. Registration of new profiles..................................22 9.1. Define the profile..........................................22 9.2. Post the profile definition.................................23 9.3. Allow a comment period......................................23 9.4. Submit the profile for approval.............................23 10. Profile Change Control.......................................23 Howes, et. al. Standards Track [Page 2] RFC 2425 MIME Content-Type for Directory Information September 1998 11. Registration of new types....................................24 11.1. Define the type............................................24 11.2. Post the type definition...................................25 11.3. Allow a comment period.....................................25 11.4. Submit the type for approval...............................25 12. Type Change Control..........................................25 13. Registration of new parameters...............................26 13.1. Define the parameter.......................................26 13.2. Post the parameter definition..............................27 13.3. Allow a comment period.....................................27 13.4. Submit the parameter for approval..........................27 14. Parameter Change Control.....................................28 15. Registration of new value types..............................28 15.1. Define the value type......................................28 15.2. Post the value type definition.............................29 15.3. Allow a comment period.....................................29 15.4. Submit the value type for approval.........................29 16. Security Considerations......................................30 17. Acknowledgements..............................................30 18. References....................................................30 19. Authors' Addresses...........................................32 20. Full Copyright Statement......................................33 3. Need for a MIME Directory Type For purposes of this document, a directory is a special-purpose database that contains typed information. A directory usually supports both read and search of the information it contains, and can support creation and modification of the information as well. Directory information is usually accessed far more often than it is updated. Directories can be local or global in scope. They can be distributed or centralized. The information they contain can be replicated, with weak or strong consistency requirements. There are several situations in which users of Internet mail might wish to exchange directory information: the email analogy of a "business card" exchange; the conveyance of directory information to a user having only email access to the Internet; the provision of machine-parseable address information when purchasing goods or services over the Internet; etc. As MIME [RFC-2045, RFC-2046] is used increasingly by other protocols, most notably HTTP, it can also be useful for these protocols to carry directory information in MIME format. Such a format, for example, could be used to represent URC (uniform resource characteristics) information about resources on the World Wide Web, or to provide a rudimentary directory service over HTTP. Howes, et. al. Standards Track [Page 3] RFC 2425 MIME Content-Type for Directory Information September 1998 4. Overview The scheme defined here for representing directory information in a MIME Content-Type has two parts. First, the text/directory Content- Type is defined for use in holding directory information within a single body part, for example name, title, or email address. In its simplest form, the format uses a "type:value" approach, which should be easily parseable by existing MIME implementations and understandable by users. More complicated situations can be represented also. This document defines the general form the information in the Content-Type should have, and the procedure by which specific types and values (properties) for particular applications can be defined. The framework is general enough to handle information from any number of end directory services, including LDAP [RFC-1777, RFC-1778], WHOIS++ [RFC-1835], and X.500 [X500]. Directory entries can include far more than just textual information. Some such information (e.g., an image or sound) overlaps with predefined MIME Content-Types. In these cases it can be desirable to include the information in its well-known MIME format. This situation is handled by using a multipart/related Content-Type as defined in [RFC-2112]. The root component of this type is a text/directory body part specifying any in-line information, and for information contained in other Content-Types, the Content-IDs (in URI form) of those parts. In some applications, it can be useful to include a pointer (e.g, a URI) to some directory information rather than the information itself. This document defines a general mechanism for accomplishing this. 5. The text/directory Content-Type The text/directory Content-Type is used to hold basic directory information and URIs referencing other information, including other MIME body parts holding supplementary or non-textual directory information, such as an image or sound. It is defined as follows, using the MIME media type registration template from [RFC-2048]. To: ietf-types@uninett.no Subject: Registration of MIME media type text/directory 5.1. MIME media type name MIME media type name: text Howes, et. al. Standards Track [Page 4] RFC 2425 MIME Content-Type for Directory Information September 1998 5.2. MIME subtype name MIME subtype name: directory 5.3. Required parameters Required parameters: charset The "charset" parameter is as defined in [RFC-2046] for other body parts. It is used to identify the default character set used within the body part. 5.4. Optional parameters Optional parameters: profile The "profile" parameter is used to convey the type(s) of entity(ies) to which the directory information pertains and the likely set of information associated with the entity(ies). It is intended only as a guide to applications interpreting the information contained within the body part. It SHOULD NOT be used to exclude or require particular pieces of information unless a profile definition specifically calls for this behavior. Unless specifically forbidden by a particular profile definition, a text/directory content type can contain arbitrary attribute/value pairs. The value of the "profile" parameter is defined as follows. Profile names are case insensitive (i.e., the profile name "vCard" is the same as "VCARD" and "vcard" and "vcArD"). profile = x-name / iana-token x-name = "x-" 1*(ALPHA / DIGIT / "-") ; Names beginning with "x-" or "X-" are ; reserved for experimental use not intended for released ; products, or for use in bilateral agreements. iana-token = <a publicly-defined extension token, registered with IANA, as specified in Section 9 of this document> 5.5. Encoding considerations The default encoding is 8bit. Otherwise, as specified by the Content-Transfer-Encoding header field. Howes, et. al. Standards Track [Page 5] RFC 2425 MIME Content-Type for Directory Information September 1998 5.6. Security considerations Directory information can be public or it can be protected from unauthorized access by the directory service in which it resides. Once the information leaves its native service, there can be no guarantee that the same care will be taken by all services handling the information. Furthermore, this specification defines no access control mechanism by which information can be protected, or by which access control information can be conveyed. Note that the integrity and privacy of a text/directory body part can be protected by enclosing it within an appropriate MIME-based security mechanism. 5.7. Interoperability considerations In order to make sense of directory information, applications must share a common understanding of the types of information contained within the Content-Type (the directory schema). This schema information is not defined in this document, but rather in companion documents (e.g., [MIME-VCARD]) that follow the requirements specified in this document, or in bilateral agreements between communicating parties. 5.8. Published specification The text/directory Content-Type contains directory information, typically pertaining to a single directory entity or group of entities. The content consists of one or more lines in the format given below. 5.8.1. Line delimiting and folding Individual lines within the MIME text/directory Content Type body are delimited by the [RFC-822] line break, which is a CRLF sequence (ASCII decimal 13, followed by ASCII decimal 10). Long logical lines of text can be split into a multiple-physical-line representation using the following folding technique. A logical line MAY be continued on the next physical line anywhere between two characters by inserting a CRLF immediately followed by a single white space character (space, ASCII decimal 32, or horizontal tab, ASCII decimal 9). At least one character must be present on the folded line. Any sequence of CRLF followed immediately by a single white space character is ignored (removed) when processing the content type. For example the line: DESCRIPTION:This is a long description that exists on a long line. Can be represented as: Howes, et. al. Standards Track [Page 6] RFC 2425 MIME Content-Type for Directory Information September 1998 DESCRIPTION:This is a long description that exists on a long line. It could also be represented as: DESCRIPTION:This is a long descrip tion that exists o n a long line. The process of moving from this folded multiple-line representation of a type definition to its single line representation is called unfolding. Unfolding is accomplished by regarding CRLF immediately followed by a white space character (namely HTAB ASCII decimal 9 or SPACE ASCII decimal 32) as equivalent to no characters at all (i.e., the CRLF and single white space character are removed). 5.8.2. ABNF content-type definition The following ABNF uses the notation of RFC 2234, which also defines CRLF, WSP, DQUOTE, VCHAR, ALPHA, and DIGIT. After the unfolding of any folded lines as described above, the syntax for a line of this content type is as follows: contentline = [group "."] name *(";" param) ":" value CRLF ; When parsing a content line, folded lines MUST first ; be unfolded according to the unfolding procedure ; described above. ; When generating a content line, lines longer than 75 ; characters SHOULD be folded according to the folding ; procedure described above. group = 1*(ALPHA / DIGIT / "-") name = x-name / iana-token iana-token = 1*(ALPHA / DIGIT / "-") ; identifier registered with IANA x-name = "x-" 1*(ALPHA / DIGIT / "-") ; Names that begin with "x-" or "X-" are ; reserved for experimental use, not intended for released ; products, or for use in bilateral agreements. param = param-name "=" param-value *("," param-value) param-name = x-name / iana-token param-value = ptext / quoted-string Howes, et. al. Standards Track [Page 7] RFC 2425 MIME Content-Type for Directory Information September 1998 ptext = *SAFE-CHAR value = *VALUE-CHAR / valuespec ; valuespec defined in section 5.8.4 quoted-string = DQUOTE *QSAFE-CHAR DQUOTE NON-ASCII = %x80-FF ; use restricted by charset parameter ; on outer MIME object (UTF-8 preferred) QSAFE-CHAR = WSP / %x21 / %x23-7E / NON-ASCII ; Any character except CTLs, DQUOTE SAFE-CHAR = WSP / %x21 / %x23-2B / %x2D-39 / %x3C-7E / NON-ASCII ; Any character except CTLs, DQUOTE, ";", ":", "," VALUE-CHAR = WSP / VCHAR / NON-ASCII ; any textual character A line that begins with a white space character is a continuation of the previous line, as described above. The white space character and immediately preceeding CRLF should be discarded when reconstructing the original line. Note that this line-folding convention differs from that found in RFC 822, in that the sequence <CRLF><WSP> found anywhere in the content indicates a continued line and should be removed. Various type names and the format of the corresponding values are defined as specified in Section 11. Specifications MAY impose ordering on the type constructs within a body part, though none is required by default. The various x-name constructs are used for bilaterally-agreed upon type names, parameter names and parameter values, or for use in experimental settings. Type names and parameter names are case insensitive (e.g., the type name "fn" is the same as "FN" and "Fn"). Parameter values MAY be case sensitive or case insensitive, depending on their definition. The group construct is used to group related attributes together. The group name is a syntactic convention used to indicate that all type names prefaced with the same group name SHOULD be grouped together when displayed by an application. It has no other significance. Implementations that do not understand or support grouping MAY simply strip off any text before a "." to the left of the type name and present the types and values as normal. Howes, et. al. Standards Track [Page 8] RFC 2425 MIME Content-Type for Directory Information September 1998 Each attribute defined in the text/directory body MAY have multiple values, if allowed in the definition of the profile in which the attribute is used. The general rule for encoding multi-valued items is to simply create a new content line for each value (including the type name). However, it should be noted that some value types support encoding multiple values in a single content line by separating the values with a comma ",". This approach has been taken for several of the content types defined below (date, time, integer, float), for space-saving reasons. 5.8.3. Pre-defined Parameters The following parameters and value types are defined for general use. predefined-param = encodingparm / valuetypeparm / languageparm / contextparm encodingparm = "encoding" "=" encodingtype encodingtype = "b" ; from RFC 2047 / iana-token ; registered as described in ; section 15 of this document valuetypeparm = "value" "=" valuetype valuetype = "uri" ; genericurl from secion 5 of RFC 1738 / "text" / "date" / "time" / "date-time" ; date time / "integer" / "boolean" / "float" / x-name / iana-token ; registered as described in ; section 15 of this document languageparm = "language" "=" Language-Tag ; Language-Tag is defined in section 2 of RFC 1766 contextparm = "context" "=" context context = x-name / iana-token Howes, et. al. Standards Track [Page 9] RFC 2425 MIME Content-Type for Directory Information September 1998 The "language" type parameter is used to identify data in multiple languages. There is no concept of "default" language, except as specified by any "Content-Language" MIME header parameter that is present. The value of the "language" type parameter is a language tag as defined in Section 2 of [RFC-1766]. The "context" type parameter is used to identify a context (e.g., a protocol) used in interpreting the value. This is used, for example, in the "source" type, defined below. The "encoding" type parameter is used to specify an alternate encoding for a value. If the value contains a CRLF, it must be encoded, since CRLF is used to separate lines in the content-type itself. Currently, only the "b" encoding is supported. The "b" encoding can also be useful for binary values that are mixed with other text information in the body part (e.g., a certificate). Using a per-value "b" encoding in this case leaves the other information in a more readable form. The encoded base 64 value can be split across multiple physical lines in the content type by using the line folding technique described above. The Content-Transfer-Encoding header field is used to specify the encoding used for the body part as a whole. The "encoding" type parameter is used to specify an encoding for a particular value (e.g., a certificate). In this case, the Content-Transfer-Encoding header might specify "8bit", while the one certificate value might specify an encoding of "b" via an "encoding=b" type parameter. The Content-Transfer-Encoding and the encodings of individual types given by the "encoding" type parameter are independent of one another. When encoding a text/directory body part for transmission, individual type encodings are performed first, then the entire body part is encoded according to the Content-Transfer-Encoding. When decoding a text/directory body part, the Content-Transfer-Encoding is decoded first, and then any individual types with an "encoding" type parameter are decoded. The "value" parameter is optional, and is used to identify the value type (data type) and format of the value. The use of these predefined formats is encouraged even if the value parameter is not explicity used. By defining a standard set of value types and their formats, existing parsing and processing code can be leveraged. Including the value type explicitly as part of each property provides an extra hint to keep parsing simple and support more generalized applications. For example a search engine would not have to know the particular value types for all of the items for which it is Howes, et. al. Standards Track [Page 10] RFC 2425 MIME Content-Type for Directory Information September 1998 searching. Because the value type is explicit in the definition, the search engine could look for dates in any item type and provide results that can still be interpreted. 5.8.4. Pre-defined Value Types The format for values corresponding to the predefined valuetype specifications given above are defined. valuespec = text-list / genericurl ; from section 5 of RFC 1738 / date-list / time-list / date-time-list / boolean / integer-list / float-list / iana-valuespec text-list = *TEXT-LIST-CHAR *("," *TEXT-LIST-CHAR) TEXT-LIST-CHAR = "\\" / "\," / "\n" / <any VALUE-CHAR except , or \ or newline> ; Backslashes, newlines, and commas must be encoded. ; \n or \N can be used to encode a newline. date-list = date *("," date) time-list = time *("," time) date-time-list = date "T" time *("," date "T" time) boolean = "TRUE" / "FALSE" integer-list = integer *("," integer) integer = [sign] 1*DIGIT float-list = float *("," float) float = [sign] 1*DIGIT ["." 1*DIGIT] sign = "+" / "-" date = date-fullyear ["-"] date-month ["-"] date-mday date-fullyear = 4 DIGIT Howes, et. al. Standards Track [Page 11] RFC 2425 MIME Content-Type for Directory Information September 1998 date-month = 2 DIGIT ;01-12 date-mday = 2 DIGIT ;01-28, 01-29, 01-30, 01-31 ;based on month/year time = time-hour [":"] time-minute [":"] time-second [time-secfrac] [time-zone] time-hour = 2 DIGIT ;00-23 time-minute = 2 DIGIT ;00-59 time-second = 2 DIGIT ;00-60 (leap second) time-secfrac = "," 1*DIGIT time-zone = "Z" / time-numzone time-numzome = sign time-hour [":"] time-minute iana-valuespec = <a publicly-defined valuetype format, registered with IANA, as defined in section 15 of this document> Some specific notes on the value types and formats: "text": The "text" value type should be used to identify values that contain human-readable text. The character set and language in which the text is represented is controlled by the charset content-header and the language type parameter and content-header. Examples for "text": this is a text value this is one value,this is another this is a single value\, with a comma encoded A formatted text line break in a text value type MUST be represented as the character sequence backslash (ASCII decimal 92) followed by a Latin small letter n (ASCII decimal 110) or a Latin capital letter N (ASCII decimal 78), that is "\n" or "\N". For example a multiple line DESCRIPTION value of: Mythical Manager Hyjinx Software Division BabsCo, Inc. could be represented as: Howes, et. al. Standards Track [Page 12] RFC 2425 MIME Content-Type for Directory Information September 1998 DESCRIPTION:Mythical Manager\nHyjinx Software Division\n BabsCo\, Inc.\n demonstrating the \n literal formatted line break technique, the CRLF-followed-by-space line folding technique, and the backslash escape technique. "uri": The "uri" value type should be used to identify values that are referenced by a URI (including a Content-ID URI), instead of encoded in-line. These value references might be used if the value is too large, or otherwise undesirable to include directly. The format for the URI is as defined in RFC 1738. Examples for "uri": http://www.foobar.com/my/picture.jpg ldap://ldap.foobar.com/cn=babs%20jensen "date", "time", and "date-time": Each of these value types is based on a subset of the definitions in ISO 8601 standard. Profiles MAY place further restrictions on "date" and "time" values. Multiple "date" and "time" values can be specified using the comma-separated notation, unless restricted by a profile. Examples for "date": 1985-04-12 1996-08-05,1996-11-11 19850412 Examples for "time": 10:22:00 102200 10:22:00.33 10:22:00.33Z 10:22:33,11:22:00 10:22:00-08:00 Examples for "date-time": 1996-10-22T14:00:00Z 1996-08-11T12:34:56Z 19960811T123456Z 1996-10-22T14:00:00Z,1996-08-11T12:34:56Z "boolean": The "boolean" value type is used to express boolen values. These values are case insensitive. Examples: TRUE false True Howes, et. al. Standards Track [Page 13] RFC 2425 MIME Content-Type for Directory Information September 1998 "integer": The "integer" value type is used to express signed integers in decimal format. If sign is not specified, the value is assumed positive "+". Multiple "integer" values can be specified using the comma-separated notation, unless restricted by a profile. Examples: 1234567890 -1234556790 +1234556790,432109876 "float": The "float" value type is used to express real numbers. If sign is not specified, the value is assumed positive "+". Multiple "float" values can be specified using the comma-separated notation, unless restricted by a profile. Examples: 20.30 1000000.0000001 1.333,3.14 5.9. Applications which use this media type Applications which use this media type: Various 5.10. Additional information Additional information: None 5.11. Person & email address to contact for further information Tim Howes Netscape Communications Corp. 501 East Middlefield Rd. Mountain View, CA 94041 USA howes@netscape.com +1 415 937 3419 5.12. Intended usage Intended usage: COMMON Howes, et. al. Standards Track [Page 14] RFC 2425 MIME Content-Type for Directory Information September 1998 5.13. Author/Change controller Tim Howes Netscape Communications Corp. 501 East Middlefield Rd. Mountain View, CA 94041 USA howes@netscape.com +1 415 937 3419 Mark Smith Netscape Communications Corp. 501 East Middlefield Rd. Mountain View, CA 94041 USA mcs@netscape.com +1 415 937 3477 Frank Dawson Lotus Development Corporation 6544 Battleford Drive Raleigh, NC 27613-3502 USA frank_dawson@lotus.com +1-919-676-9515 6. Predefined Types The following types are generally useful regardless of the profile being carried and are defined below using the text/directory MIME type registration template defined in Section 11.1 of this document. These types MAY be included in any profile, unless explicitly forbidden in the profile definition. 6.1. SOURCE Type Definition To: ietf-mime-direct@imc.org Subject: Registration of text/directory MIME type SOURCE Type name: SOURCE Type purpose: To identify the source of directory information contained in the content type. Type encoding: 8bit Type valuetype: uri Howes, et. al. Standards Track [Page 15] RFC 2425 MIME Content-Type for Directory Information September 1998 Type special notes: The SOURCE type is used to provide the means by which applications knowledgable in the given directory service protocol can obtain additional or more up-to-date information from the directory service. It contains a URI as defined in [RFC-1738] and/or other information referencing the directory entity or entities to which the information pertains. When directory information is available from more than one source, the sending entity can pick what it considers to be the best source, or multiple SOURCE types can be included. The interpretation of the value for a SOURCE type can depend on the setting of the CONTEXT type parameter. The value of the CONTEXT type parameter MUST be compatible with the value of the uri prefix. Type example: SOURCE;CONTEXT=LDAP:ldap://ldap.host/cn=Babs%20Jensen, %20o=Babsco,%20c=US 6.2. NAME Type Definition To: ietf-mime-direct@imc.org Subject: Registration of text/directory MIME type NAME Type name: NAME Type purpose: To identify the displayable name of the directory entity to which information in the content type pertains. Type encoding: 8bit Type valuetype: text Type special notes: The NAME type is used to convey the display name of the entity to which the directory information pertains. Type example: NAME:Babs Jensen's Contact Information 6.3. PROFILE Type Definition To: ietf-mime-direct@imc.org Subject: Registration of text/directory MIME type PROFILE Type name: PROFILE Type purpose: To identify the type of directory entity to which information in the content type pertains. Type encoding: 8bit Howes, et. al. Standards Track [Page 16] RFC 2425 MIME Content-Type for Directory Information September 1998 Type valuetype: A profile name, registered as described in Section 9 of this document or bilaterally agreed upon as described in Section 5. Type special notes: The PROFILE type is used to convey the type of the entity to which the directory information in the rest of the body part pertains. It should be the same as the "profile" header parameter, if present. Type example: PROFILE:vCard 6.4. BEGIN Type Definition To: ietf-mime-direct@imc.org Subject: Registration of text/directory MIME type BEGIN Type name: BEGIN Type purpose: To denote the beginning of a syntactic entity within a text/directory content-type. Type encoding: 8bit Type valuetype: text, containing a profile name, registered as described in Section 9 of this document or bilaterally-agreed upon as described in Section 5. Type special notes: The BEGIN type is used in conjunction with the END type to delimit a profile containing a related set of properties within an text/directory content-type. This construct can be used instead of or in addition to wrapping separate sets of information inside additional MIME headers. It is provided for applications that wish to define content that can contain multiple entities within the same text/directory content-type or to define content that can be identifiable outside of a MIME environment. Type example: BEGIN:VCARD 6.5. END Type Definition To: ietf-mime-direct@imc.org Subject: Registration of text/directory MIME type END Type name: END Howes, et. al. Standards Track [Page 17] RFC 2425 MIME Content-Type for Directory Information September 1998 Type purpose: To denote the end of a syntactic entity within a text/directory content-type. Type encoding: 8bit Type valuetype: text, containing a profile name, registered as described in Section 9 of this document or bilaterally-agreed upon as described in Section 5. Type special notes: The END type is used in conjunction with the BEGIN type to delimit a profile containing a related set of properties within an text/directory content-type. This construct can be used instead of or in addition to wrapping separate sets of information inside additional MIME headers. It is provided for applications that wish to define content that can contain multiple entities within the same text/directory content-type or to define content that can be identifiable outside of a MIME environment. Type example: END: VCARD 7. Use of the multipart/related Content-Type The multipart/related Content-Type can be used to hold directory information comprised of both text and non-text information or directory information that already has a natural MIME representation. The root body part within the multipart/related body part is specified as defined in [RFC-2112] by a "start" parameter, or it is the first body part in the absence of such a parameter. The root body part must have a Content-Type of "text/directory". This part holds inline information and makes reference to subsequent body parts holding additional text or non-text directory information via their Content-ID URIs as explained in Section 5. The body parts referred to do not have to be in any particular order, except as noted above for the root body part. 8. Examples The following examples are for illustrative purposes only and are not part of the definition. Howes, et. al. Standards Track [Page 18] RFC 2425 MIME Content-Type for Directory Information September 1998 8.1. Example 1 The first example illustrates simple use of the text/directory Content-Type. Note that no "profile" parameter is given, so an application may not know what kind of directory entity the information applies to. Note also the use of both hypothetical official and bilaterally agreed upon types. From: Whomever@wherever.com To: Someone@somewhere.com Subject: whatever MIME-Version: 1.0 Message-ID: <id1@host.net> Content-Type: text/directory Content-ID: <id2@host.com> cn:Babs Jensen cn:Barbara J Jensen sn:Jensen email:babs@umich.edu phone:+1 313 747-4454 x-id:1234567890 8.2. Example 2 The next example illustrates the use of the Quoted-Printable transfer encoding defined in [RFC 2045] to include non-ASCII character in some of the information returned, and the use of the optional "name" and "source" types. It also illustrates the use of an "encoding" type parameter to encode a certificate value in "b". A "vCard" profile [MIME- VCARD] is used for the example. Content-Type: text/directory; charset="iso-8859-1"; profile="vCard" Content-ID: <id3@host.com> Content-Transfer-Encoding: Quoted-Printable begin:VCARD source:ldap://cn=bjorn%20Jensen, o=university%20of%20Michigan, c=US name:Bjorn Jensen fn:Bj=F8rn Jensen n:Jensen;Bj=F8rn email;type=internet:bjorn@umich.edu tel;type=work,voice,msg:+1 313 747-4454 key;type=x509;encoding=B:dGhpcyBjb3VsZCBiZSAKbXkgY2VydGlmaWNhdGUK end:VCARD Howes, et. al. Standards Track [Page 19] RFC 2425 MIME Content-Type for Directory Information September 1998 8.3. Example 3 The next example illustrates the use of multi-valued type parameters, the "language" type parameter, the "value" type parameter, folding of long lines, the \n encoding for formatted lines, attribute grouping, and the inline "b" encoding. A "vCard" profile [MIME-VCARD] is used for the example. Content-Type: text/directory; profile="vcard"; charset=iso-8859-1 Content-ID: <id3@host.com> Content-Transfer-Encoding: Quoted-Printable begin:vcard source:ldap://cn=Meister%20Berger,o=Universitaet%20Goerlitz,c=DE name:Meister Berger fn:Meister Berger n:Berger;Meister bday;value=date:1963-09-21 o:Universit=E6t G=F6rlitz title:Mayor title;language=de;value=text:Burgermeister note:The Mayor of the great city of Goerlitz in the great country of Germany. email;internet:mb@goerlitz.de home.tel;type=fax,voice,msg:+49 3581 123456 home.label:Hufenshlagel 1234\n 02828 Goerlitz\n Deutschland key;type=X509;encoding=b:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcNAQEEBQ AwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bmljYXRpb25zI ENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0ZW1zMRwwGgYDVQQD ExNyb290Y2EubmV0c2NhcGUuY29tMB4XDTk3MDYwNjE5NDc1OVoXDTk3MTIwMzE5NDc 1OVowgYkxCzAJBgNVBAYTAlVTMSYwJAYDVQQKEx1OZXRzY2FwZSBDb21tdW5pY2F0aW 9ucyBDb3JwLjEYMBYGA1UEAxMPVGltb3RoeSBBIEhvd2VzMSEwHwYJKoZIhvcNAQkBF hJob3dlc0BuZXRzY2FwZS5jb20xFTATBgoJkiaJk/IsZAEBEwVob3dlczBcMA0GCSqG SIb3DQEBAQUAA0sAMEgCQQC0JZf6wkg8pLMXHHCUvMfL5H6zjSk4vTTXZpYyrdN2dXc oX49LKiOmgeJSzoiFKHtLOIboyludF90CgqcxtwKnAgMBAAGjNjA0MBEGCWCGSAGG+E IBAQQEAwIAoDAfBgNVHSMEGDAWgBT84FToB/GV3jr3mcau+hUMbsQukjANBgkqhkiG9 w0BAQQFAAOBgQBexv7o7mi3PLXadkmNP9LcIPmx93HGp0Kgyx1jIVMyNgsemeAwBM+M SlhMfcpbTrONwNjZYW8vJDSoi//yrZlVt9bJbs7MNYZVsyF1unsqaln4/vy6Uawfg8V UMk1U7jt8LYpo4YULU7UZHPYVUaSgVttImOHZIKi4hlPXBOhcUQ== end:vcard Howes, et. al. Standards Track [Page 20] RFC 2425 MIME Content-Type for Directory Information September 1998 8.4. Example 4 The final example illustrates the use of the multipart/related Content-Type to include non-textual directory data via the "uri" encoding to refer to other body parts within the same message, or to external values. Note that no "profile" parameter is given, so an application may not know what kind of directory entity the information applies to. Note also the use of both hypothetical official and bilaterally agreed upon types. Content-Type: multipart/related; boundary=woof; type="text/directory"; start="<id5@host.com>" Content-ID: <id4@host.com> --woof Content-Type: text/directory; charset="iso-8859-1" Content-ID: <id5@host.com> Content-Transfer-Encoding: Quoted-Printable source:ldap://cn=Bjorn%20Jensen,o=University%20of%20Michigan,c=US cn:Bj=F8rn Jensen sn:Jensen email:bjorn@umich.edu image;value=uri:cid:id6@host.com image;value=uri;format=jpeg:ftp://some.host/some/path.jpg sound;value=uri:cid:id7@host.com phone:+1 313 747-4454 --woof Content-Type: image/jpeg Content-ID: <id6@host.com> <...image data...> --woof Content-Type: message/external-body; name="myvoice.au"; site="myhost.com"; access-type=ANON-FTP; directory="pub/myname"; mode="image" Content-Type: audio/basic Content-ID: <id7@host.com> --woof-- Howes, et. al. Standards Track [Page 21] RFC 2425 MIME Content-Type for Directory Information September 1998 9. Registration of new profiles This section defines procedures by which new profiles are registered with the IANA and made available to the Internet community. Note that non-IANA profiles can be used by bilateral agreement, provided the associated profile names follow the "X-" convention defined above. The procedures defined here are designed to allow public comment and review of new profiles, while posing only a small impediment to the definition of new profiles. Registration of a new profile is accomplished by the following steps. 9.1. Define the profile A profile is defined by completing the following template. To: ietf-mime-direct@imc.org Subject: Registration of text/directory MIME profile XXX Profile name: Profile purpose: Profile types: Profile special notes (optional): Intended usage: (one of COMMON, LIMITED USE or OBSOLETE) The explanation of what goes in each field in the template follows. Profile name: The name of the profile as it will appear in the text/directory MIME Content-Type "profile" header parameter, or the predefined "profile" type name. Profile purpose: The purpose of the profile (e.g., to represent information about people, printers, documents, etc.). Give a short but clear description. Profile types: The list of types associated with the profile. This list of types is to be expected but not required in the profile, unless otherwise noted in the profile definition. Other types not mentioned in the profile definition MAY also be present. Note that any new types referenced by the profile MUST be defined separately as described in Section 10. Howes, et. al. Standards Track [Page 22] RFC 2425 MIME Content-Type for Directory Information September 1998 Profile special notes: Any special notes about the profile, how it is to be used, etc. This section of the template can also be used to define an ordering on the types that appear in the Content-Type, if such an ordering is required. 9.2. Post the profile definition The profile description must be posted to the new profile discussion list, ietf-mime-direct@imc.org 9.3. Allow a comment period Discussion on the new profile must be allowed to take place on the list for a minimum of two weeks. Consensus must be reached on the profile before proceeding to step 4. 9.4. Submit the profile for approval Once the two-week comment period has elapsed, and the proposer is convinced consensus has been reached on the profile, the registration application should be submitted to the Profile Reviewer for approval. The Profile Reviewer is appointed by the Application Area Directors and can either accept or reject the profile registration. An accepted registration is passed on by the Profile Reviewer to the IANA for inclusion in the official IANA profile registry. The registration may be rejected for any of the following reasons. 1) Insufficient comment period; 2) Consensus not reached; 3) Technical deficiencies raised on the list or elsewhere have not been addressed. The Profile Reviewer's decision to reject a profile can be appealed by the proposer to the IESG, or the objections raised can be addressed by the proposer and the profile resubmitted. 10. Profile Change Control Existing profiles can be changed using the same process by which they were registered. Define the change Post the change Allow a comment period Submit the changed profile for approval Howes, et. al. Standards Track [Page 23] RFC 2425 MIME Content-Type for Directory Information September 1998 Note that the original author or any other interested party can propose a change to an existing profile, but that such changes should only be proposed when there are serious omissions or errors in the published specification. The Profile Reviewer can object to a change if it is not backwards compatible, but is not required to do so. Profile definitions can never be deleted from the IANA registry, but profiles which are no longer believed to be useful can be declared OBSOLETE by a change to their "intended use" field. 11. Registration of new types This section defines procedures by which new types are registered with the IANA. Note that non-IANA types can be used by bilateral agreement, provided the associated types names follow the "X-" convention defined above. The procedures defined here are designed to allow public comment and review of new types, while posing only a small impediment to the definition of new types. Registration of a new type is accomplished by the following steps. 11.1. Define the type A type is defined by completing the following template. To: ietf-mime-direct@imc.org Subject: Registration of text/directory MIME type XXX Type name: Type purpose: Type encoding: Type valuetype: Type special notes (optional): Intended usage: (one of COMMON, LIMITED USE or OBSOLETE) The meaning of each field in the template is as follows. Type name: The name of the type, as it will appear in the body of an text/directory MIME Content-Type "type: value" line to the left of the colon ":". Howes, et. al. Standards Track [Page 24] RFC 2425 MIME Content-Type for Directory Information September 1998 Type purpose: The purpose of the type (e.g., to represent a name, postal address, IP address, etc.). Give a short but clear description. Type encoding: The default encoding a value of the type must have in the body of a text/directory MIME Content-Type. Type valuetype: The format a value of the type must have in the body of a text/directory MIME Content-Type. This description must be precise and must not violate the general encoding rules defined in section 5 of this document. Type special notes: Any special notes about the type, how it is to be used, etc. 11.2. Post the type definition The type description must be posted to the new type discussion list, ietf-mime-direct@imc.org 11.3. Allow a comment period Discussion on the new type must be allowed to take place on the list for a minimum of two weeks. Consensus must be reached on the type before proceeding to step 4. 11.4. Submit the type for approval Once the two-week comment period has elapsed, and the proposer is convinced consensus has been reached on the type, the registration application should be submitted to the Profile Reviewer for approval. The Profile Reviewer is appointed by the Application Area Directors and can either accept or reject the type registration. An accepted registration is passed on by the Profile Reviewer to the IANA for inclusion in the official IANA profile registry. The registration can be rejected for any of the following reasons. 1) Insufficient comment period; 2) Consensus not reached; 3) Technical deficiencies raised on the list or elsewhere have not been addressed. The Profile Reviewer's decision to reject a type can be appealed by the proposer to the IESG, or the objections raised can be addressed by the proposer and the type resubmitted. Howes, et. al. Standards Track [Page 25] RFC 2425 MIME Content-Type for Directory Information September 1998 12. Type Change Control Existing types can be changed using the same process by which they were registered. Define the change Post the change Allow a comment period Submit the type for approval Note that the original author or any other interested party can propose a change to an existing type, but that such changes should only be proposed when there are serious omissions or errors in the published specification. The Profile Reviewer can object to a change if it is not backwards compatible, but is not required to do so. Type definitions can never be deleted from the IANA registry, but types which are nolonger believed to be useful can be declared OBSOLETE by a change to their "intended use" field. 13. Registration of new parameters This section defines procedures by which new parameters are registered with the IANA and made available to the Internet community. Note that non-IANA parameters can be used by bilateral agreement, provided the associated parameters names follow the "X-" convention defined above. The procedures defined here are designed to allow public comment and review of new parameters, while posing only a small impediment to the definition of new parameters. Registration of a new parameter is accomplished by the following steps. 13.1. Define the parameter A parameter is defined by completing the following template. To: ietf-mime-direct@imc.org Subject: Registration of text/directory MIME type parameter XXX Parameter name: Parameter purpose: Howes, et. al. Standards Track [Page 26] RFC 2425 MIME Content-Type for Directory Information September 1998 Parameter values: Parameter special notes (optional): Intended usage: (one of COMMON, LIMITED USE or OBSOLETE) The explanation of what goes in each field in the template follows. Parameter name: The name of the parameter as it will appear in the text/directory MIME Content-Type. Parameter purpose: The purpose of the parameter (e.g., to represent the format of an image, type of a phone number, etc.). Give a short but clear description. If defining a general paramemter like "format" or "type" keep in mind that other applications might wish to extend its use. Parameter values: The list or description of values associated with the parameter. Parameter special notes: Any special notes about the parameter, how it is to be used, etc. 13.2. Post the parameter definition The parameter description must be posted to the new parameter discussion list, ietf-mime-direct@imc.org 13.3. Allow a comment period Discussion on the new parameter must be allowed to take place on the list for a minimum of two weeks. Consensus must be reached on the parameter before proceeding to step 4. 13.4. Submit the parameter for approval Once the two-week comment period has elapsed, and the proposer is convinced consensus has been reached on the parameter, the registration application should be submitted to the Profile Reviewer for approval. The Profile Reviewer is appointed by the Application Area Directors and can either accept or reject the parameter registration. An accepted registration is passed on by the Profile Reviewer to the IANA for inclusion in the official IANA parameter registry. The registration can be rejected for any of the following reasons. 1) Insufficient comment period; 2) Consensus not reached; 3) Technical deficiencies raised on the list or elsewhere have not been addressed. The Profile Reviewer's decision to reject a profile can be appealed by the proposer to the IESG, or the objections raised can be Howes, et. al. Standards Track [Page 27] RFC 2425 MIME Content-Type for Directory Information September 1998 addressed by the proposer and the parameter registration resubmitted. 14. Parameter Change Control Existing parameters can be changed using the same process by which they were registered. Define the change Post the change Allow a comment period Submit the parameter for approval Note that the original author or any other interested party can propose a change to an existing parameter, but that such changes should only be proposed when there are serious omissions or errors in the published specification. The Profile Reviewer can object to a change if it is not backwards compatible, but is not required to do so. Parameter definitions can never be deleted from the IANA registry, but parameters which are nolonger believed to be useful can be declared OBSOLETE by a change to their "intended use" field. 15. Registration of new value types This section defines procedures by which new value types are registered with the IANA and made available to the Internet community. Note that non-IANA value types can be used by bilateral agreement, provided the associated value types names follow the "X-" convention defined above. The procedures defined here are designed to allow public comment and review of new value types, while posing only a small impediment to the definition of new value types. Registration of a new value types is accomplished by the following steps. 15.1. Define the value type A value type is defined by completing the following template. To: ietf-mime-direct@imc.org Subject: Registration of text/directory MIME value type XXX Howes, et. al. Standards Track [Page 28] RFC 2425 MIME Content-Type for Directory Information September 1998 value type name: value type purpose: value type format: value type special notes (optional): Intended usage: (one of COMMON, LIMITED USE or OBSOLETE) The explanation of what goes in each field in the template follows. value type name: The name of the value type as it will appear in the text/directory MIME Content-Type. value type purpose: The purpose of the value type. Give a short but clear description. value type format: The definition of the format for the value, usually using ABNF grammar. value type special notes: Any special notes about the value type, how it is to be used, etc. 15.2. Post the value type definition The value type description must be posted to the new value type discussion list, ietf-mime-direct@imc.org 15.3. Allow a comment period Discussion on the new value type must be allowed to take place on the list for a minimum of two weeks. Consensus must be reached before proceeding to step 4. 15.4. Submit the value type for approval Once the two-week comment period has elapsed, and the proposer is convinced consensus has been reached on the value type, the registration application should be submitted to the Profile Reviewer for approval. The Profile Reviewer is appointed by the Application Area Directors and can either accept or reject the value type registration. An accepted registration should be passed on by the Profile Reviewer to the IANA for inclusion in the official IANA value type registry. The registration can be rejected for any of the following reasons. 1) Insufficient comment period; 2) Consensus not reached; 3) Technical deficiencies raised on the list or elsewhere have not been addressed. The Profile Reviewer's decision to reject a Howes, et. al. Standards Track [Page 29] RFC 2425 MIME Content-Type for Directory Information September 1998 profile can be appealed by the proposer to the IESG, or the objections raised can be addressed by the proposer and the value type registration resubmitted. 16. Security Considerations Internet mail is subject to many well known security attacks, including monitoring, replay, and forgery. Care should be taken by any directory service in allowing information to leave the scope of the service itself, where any access controls can no longer be guaranteed. Applications should also take care to display directory data in a "safe" environment (e.g., PostScript-valued types). 17. Acknowledgements The registration procedures defined here were shamelessly lifted from the MIME registration RFC. The many valuable comments contributed by members of the IETF ASID working group are gratefully acknowledged, as are the contributions of the Versit Consortium. Chris Newman was especially helpful in navigating the intricacies of ABNF lore. 18. References [RFC-1777] Yeong, W., Howes, T., and S. Kille, "Lightweight Directory Access Protocol", RFC 1777, March 1995. [RFC-1778] Howes, T., Kille, S., Yeong, W., and C. Robbins, "The String Representation of Standard Attribute Syntaxes", RFC 1778, March 1995. [RFC-822] Crocker, D., "Standard for the Format of ARPA Internet Text Messages", STD 11, RFC 822, August 1982. [RFC-2045] Borenstein, N., and N. Freed, "Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies", RFC 2045, November 1996. [RFC-2046] Moore, K., "Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types", RFC 2046, November 1996. [RFC-2048] Freed, N., Klensin, J., and J. Postel, "Multipurpose Internet Mail Extensions (MIME) Part Four: Registration Procedures", RFC 2048, November 1996. [RFC-1766] Alvestrand, H., "Tags for the Identification of Languages", RFC 1766, March 1995. Howes, et. al. Standards Track [Page 30] RFC 2425 MIME Content-Type for Directory Information September 1998 [RFC-2112] Levinson, E., "The MIME Multipart/Related Content-type", RFC 2112, March 1997. [X500] "Information Processing Systems - Open Systems Interconnection - The Directory: Overview of Concepts, Models and Services", ISO/IEC JTC 1/SC21, International Standard 9594-1, 1988. [RFC-1835] Deutsch, P., Schoultz, R., Faltstrom, P., and C. Weider, "Architecture of the WHOIS++ service", RFC 1835, August 1995. [RFC-1738] Berners-Lee, T., Masinter, L., and M. McCahill, "Uniform Resource Locators (URL)", RFC 1738, December 1994. [MIME-VCARD] Dawson, F., and T. Howes, "VCard MIME Directory Profile", RFC 2426, September 1998. [VCARD] Internet Mail Consortium, "vCard - The Electronic Business Card", Version 2.1, http://www.imc.com/pdi/vcard-21.txt, September, 1996. [RFC-2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. [RFC-2234] Crocker, D., and P. Overell, "Augmented BNF for Syntax Specifications: ABNF", RFC 2234, November 1997. Howes, et. al. Standards Track [Page 31] RFC 2425 MIME Content-Type for Directory Information September 1998 19. Authors' Addresses Tim Howes Netscape Communications Corp. 501 East Middlefield Rd. Mountain View, CA 94041 USA Phone: +1.415.937.3419 EMail: howes@netscape.com Mark Smith Netscape Communications Corp. 501 East Middlefield Rd. Mountain View, CA 94041 USA Phone: +1.415.937.3477 EMail: mcs@netscape.com Frank Dawson Lotus Development Corporation 6544 Battleford Drive Raleigh, NC 27613 USA Phone: +1-919-676-9515 EMail: frank_dawson@lotus.com Howes, et. al. Standards Track [Page 32] RFC 2425 MIME Content-Type for Directory Information September 1998 20. Full Copyright Statement Copyright (C) The Internet Society (1998). 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. Howes, et. al. Standards Track [Page 33]