mime-dir-j-vcard4j

Network Working Group F. Dawson Request for Comments: 2426 Lotus Development Corporation Category: Standards Track T. Howes Netscape Communications September 1998 vCard MIME Directory Profile 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. Abstract This memo defines the profile of the MIME Content-Type [MIME-DIR] for directory information for a white-pages person object, based on a vCard electronic business card. The profile definition is independent of any particular directory service or protocol. The profile is defined for representing and exchanging a variety of information about an individual (e.g., formatted and structured name and delivery addresses, email address, multiple telephone numbers, photograph, logo, audio clips, etc.). The directory information used by this profile is based on the attributes for the person object defined in the X.520 and X.521 directory services recommendations. The profile also provides the method for including a [VCARD] representation of a white-pages directory entry within the MIME Content-Type defined by the [MIME-DIR] document. 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]. Dawson & Howes Standards Track [Page 1]  RFC 2426 vCard MIME Directory Profile September 1998 Table of Contents Overview.........................................................3 1. THE VCARD MIME DIRECTORY PROFILE REGISTRATION.................4 2. MIME DIRECTORY FEATURES.......................................5 2.1 PREDEFINED TYPE USAGE ......................................5 2.1.1 BEGIN and END Type ......................................5 2.1.2 NAME Type ...............................................5 2.1.3 PROFILE Type ............................................5 2.1.4 SOURCE Type .............................................5 2.2 PREDEFINED TYPE PARAMETER USAGE ............................6 2.3 PREDEFINED VALUE TYPE USAGE ................................6 2.4 EXTENSIONS TO THE PREDEFINED VALUE TYPES ...................6 2.4.1 BINARY ..................................................6 2.4.2 VCARD ...................................................6 2.4.3 PHONE-NUMBER ............................................7 2.4.4 UTC-OFFSET ..............................................7 2.5 STRUCTURED TYPE VALUES .....................................7 2.6 LINE DELIMITING AND FOLDING ................................8 3. VCARD PROFILE FEATURES........................................8 3.1 IDENTIFICATION TYPES .......................................8 3.1.1 FN Type Definition ......................................8 3.1.2 N Type Definition .......................................9 3.1.3 NICKNAME Type Definition ................................9 3.1.4 PHOTO Type Definition ..................................10 3.1.5 BDAY Type Definition ...................................11 3.2 DELIVERY ADDRESSING TYPES .................................11 3.2.1 ADR Type Definition ....................................11 3.2.2 LABEL Type Definition ..................................13 3.3 TELECOMMUNICATIONS ADDRESSING TYPES .......................13 3.3.1 TEL Type Definition ....................................14 3.3.2 EMAIL Type Definition ..................................15 3.3.3 MAILER Type Definition .................................15 3.4 GEOGRAPHICAL TYPES ........................................16 3.4.1 TZ Type Definition .....................................16 3.4.2 GEO Type Definition ....................................16 3.5 ORGANIZATIONAL TYPES ......................................17 3.5.1 TITLE Type Definition ..................................17 3.5.2 ROLE Type Definition ...................................18 3.5.3 LOGO Type Definition ...................................18 3.5.4 AGENT Type Definition ..................................19 3.5.5 ORG Type Definition ....................................20 3.6 EXPLANATORY TYPES .........................................20 3.6.1 CATEGORIES Type Definition .............................20 3.6.2 NOTE Type Definition ...................................21 3.6.3 PRODID Type Definition .................................21 3.6.4 REV Type Definition ....................................22 3.6.5 SORT-STRING Type Definition ............................22 Dawson & Howes Standards Track [Page 2]  RFC 2426 vCard MIME Directory Profile September 1998 3.6.6 SOUND Type Definition ..................................23 3.6.7 UID Type Definition ....................................24 3.6.8 URL Type Definition ....................................25 3.6.9 VERSION Type Definition ................................25 3.7 SECURITY TYPES ............................................25 3.7.1 CLASS Type Definition ..................................26 3.7.2 KEY Type Definition ....................................26 3.8 EXTENDED TYPES ............................................27 4. FORMAL GRAMMAR...............................................27 5. DIFFERENCES FROM VCARD V2.1..................................37 6. ACKNOWLEDGEMENTS.............................................39 7. AUTHORS' ADDRESSES...........................................39 8. SECURITY CONSIDERATIONS......................................39 9. REFERENCES...................................................40 10. FULL COPYRIGHT STATEMENT....................................42 Overview The [MIME-DIR] document defines a MIME Content-Type for holding different kinds of directory information. The directory information can be based on any of a number of directory schemas. This document defines a [MIME-DIR] usage profile for conveying directory information based on one such schema; that of the white-pages type of person object. The schema is based on the attributes for the person object defined in the X.520 and X.521 directory services recommendations. The schema has augmented the basic attributes defined in the X.500 series recommendation in order to provide for an electronic representation of the information commonly found on a paper business card. This schema was first defined in the [VCARD] document. Hence, this [MIME- DIR] profile is referred to as the vCard MIME Directory Profile. A directory entry based on this usage profile can include traditional directory, white-pages information such as the distinguished name used to uniquely identify the entry, a formatted representation of the name used for user-interface or presentation purposes, both the structured and presentation form of the delivery address, various telephone numbers and organizational information associated with the entry. In addition, traditional paper business card information such as an image of an organizational logo or identify photograph can