home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_ietf_a_c / draft-ietf-acap-abook-00.txt < prev    next >
Text File  |  1997-07-29  |  29KB  |  786 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                          C. Newman
  8. Internet Draft: ACAP Addressbook Dataset Class                  Innosoft
  9. Document: draft-ietf-acap-abook-00.txt                         S. Hubert
  10.                                                 University of Washington
  11.                                                                July 1997
  12.                                                    Expires in six months
  13.  
  14.  
  15.                 ACAP Personal Addressbook Dataset Class
  16.  
  17.  
  18. Status of this memo
  19.  
  20.      This document is an Internet-Draft.  Internet-Drafts are working
  21.      documents of the Internet Engineering Task Force (IETF), its areas,
  22.      and its working groups.  Note that other groups may also distribute
  23.      working documents as Internet-Drafts.
  24.  
  25.      Internet-Drafts are draft documents valid for a maximum of six
  26.      months and may be updated, replaced, or obsoleted by other
  27.      documents at any time.  It is inappropriate to use Internet-Drafts
  28.      as reference material or to cite them other than as "work in
  29.      progress."
  30.  
  31.      To view the entire list of current Internet-Drafts, please check
  32.      the "1id-abstracts.txt" listing contained in the Internet-Drafts
  33.      Shadow Directories on ftp.is.co.za (Africa), ftp.nordu.net
  34.      (Europe), munnari.oz.au (Pacific Rim), ds.internic.net (US East
  35.      Coast), or ftp.isi.edu (US West Coast).
  36.  
  37. Abstract
  38.  
  39.      IMAP [IMAP4] allows nomadic users to access their mailstore from
  40.      any client, but it does not support storage of personal
  41.      addressbooks.  Application Configuration Access Protocol [ACAP]
  42.      provides an ideal mechanism for storage of personal addressbooks.
  43.      While ACAP permits the definition of vendor specific solutions to
  44.      this problem, having a standard addressbook dataset class permits
  45.      clients from different vendors to interoperably share the same
  46.      personal addressbooks.  This specification defines a standard
  47.      dataset class for personal addressbooks.
  48.  
  49.      Personal addressbooks differ from white pages services because all
  50.      the attributes and entries are controlled by the user who owns the
  51.      addressbook rather than a directory administrator.  The user or the
  52.      clients he uses may add new attributes at any time and some of
  53.      these attributes are not suitable for a white pages service.
  54.  
  55.  
  56.  
  57.  
  58. Newman                                                          [Page i]
  59.  
  60. Internet Draft       ACAP Addressbook Dataset Class            July 1997
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                            Table of Contents
  67.  
  68.  
  69.  
  70. Status of this memo ...............................................    i
  71. Abstract ..........................................................    i
  72. 0.5. Open Issues ..................................................    1
  73. 1.   Conventions Used in this Document ............................    1
  74. 2.   ACAP Personal Addressbooks ...................................    1
  75. 2.1. ACAP Addressbook Dataset Class ...............................    1
  76. 2.2. ACAP Addressbook Capability ..................................    1
  77. 2.3. ACAP Addressbook Hierarchy ...................................    1
  78. 3.   Recommended ACAP Attributes ..................................    1
  79. 3.1. Basic Attributes .............................................    2
  80. 3.2. Naming Attributes ............................................    3
  81. 3.3. Reference Attribute ..........................................    4
  82. 3.4. Computer Communication Attributes ............................    4
  83. 3.5. Telephone Number Attributes ..................................    6
  84. 3.6. Postal Address Attributes ....................................    7
  85. 3.7. Commentary Attributes ........................................    7
  86. 3.8. Locational Attributes ........................................    8
  87. 4.   Examples .....................................................    9
  88. 5.   References ...................................................   10
  89. 6.   Security Considerations ......................................   11
  90. 7.   Authors' Addresses ...........................................   11
  91. Appendix ..........................................................   12
  92. A.   Attribute Index ..............................................   12
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Newman                                                         [Page ii]
  115.  
  116. 0.5. Open Issues
  117.  
  118.      1) add addressbook.Source to refer to a directory (or other source)
  119.      from which the entry was imported?
  120.  
  121.      2) Certificates?
  122.  
  123.      3) Interaction with vCard?
  124.  
  125. 1.   Conventions Used in this Document
  126.  
  127.      The key words "MUST", "MUST NOT", "SHOULD", "SHOULD NOT", and "MAY"
  128.      in this document are to be interpreted as defined in "Key words for
  129.      use in RFCs to Indicate Requirement Levels" [KEYWORDS].
  130.  
  131.      The attribute syntax specifications use the Augmented Backus-Naur
  132.      Form (ABNF) notation as specified in [IMAIL].
  133.  
  134.      When UTF-8 [UTF8] is referred to in this document, it refers to
  135.      Unicode version 2.0, and not Unicode version 1.1.
  136.  
  137. 2.   ACAP Personal Addressbooks
  138.  
  139. 2.1. ACAP Addressbook Dataset Class
  140.  
  141.      Datasets whose names begin with "/addressbook" are assumed to
  142.      contain addressbook entries as defined in this specification.
  143.  
  144. 2.2. ACAP Addressbook Capability
  145.  
  146.      The "addressbook.Expand.Address" and "addressbook.Expand.Complete"
  147.      attributes require active client or server support.  The attribute
  148.      "capability.addressbook.expand" in the "/capability/~/addressbook"
  149.      entry is non-NIL if they are supported.
  150.  
  151. 2.3. ACAP Addressbook Hierarchy
  152.  
  153.      Hierarchical addressbooks SHOULD be represented using ACAP
  154.      hierarchy.  Any entry in an addressbook can also be a hierarchy
  155.      node by setting the "subdataset" attribute.  This structure is used
  156.      to represent both sub-addressbooks and mailing lists.
  157.  
  158. 3.   Recommended ACAP Attributes
  159.  
  160.      The following attributes MAY be used in an ACAP addressbook entry.
  161.      An addressbook entry MUST have an "entry" attribute, and one or
  162.      more of "addressbook.Alias", "addressbook.CommonName" and
  163.      "addressbook.Email" attributes.  The purpose of this rule is to
  164.  
  165.  
  166.  
  167. Newman                                                          [Page 1]
  168.  
  169. Internet Draft       ACAP Addressbook Dataset Class            July 1997
  170.  
  171.  
  172.      make it possible to easily select an attribute which can be
  173.      displayed to a user.
  174.  
  175.      An addressbook entry MUST have at most one of the attributes
  176.      "addressbook.List", "addressbook.Reference", and
  177.      "addressbook.Email".  The purpose of this rule is to force each
  178.      entry to be either a regular addressbook entry with an Email
  179.      address, a pointer to another addressbook entry, or a distribution
  180.      list.  In order to resolve ambiguities, if there is an
  181.      "addressbook.List" attribute, both "addressbook.Email" and
  182.      "addressbook.Reference" attributes MUST be ignored. If there is no
  183.      "addressbook.List" attribute but there is an "addressbook.Email"
  184.      attribute, then the "addressbook.Reference" attribute MUST be
  185.      ignored. Beyond these rule, clients MAY choose any subset of these
  186.      attributes as well as using registered private attributes.  Clients
  187.      are encouraged to provide a way to view all textual attributes in
  188.      an entry regardless of whether the client knows the special
  189.      semantics associated with them.
  190.  
  191.      The ABNF defines the content of the attribute values prior to their
  192.      encoding as an ACAP string.  Clients MUST conform to the syntax
  193.      when generating these attributes, but MUST NOT assume that the
  194.      attribute values will conform to this syntax on access.  Servers
  195.      MUST NOT enforce the syntax.
  196.  
  197.      Unless otherwise stated, all attributes in this specification are
  198.      single-valued and textual.
  199.  
  200. 3.1. Basic Attributes
  201.  
  202.      These attributes are defined in ACAP [ACAP] and have meaning in all
  203.      dataset classes.  This section describes how they are used in an
  204.      addressbook dataset.
  205.  
  206.      entry
  207.           The "entry" attribute is a unique string used to refer to an
  208.           addressbook entry within an addressbook dataset.  It is client
  209.           defined and may not be suitable for display to users.
  210.  
  211.      subdataset
  212.           The "subdataset" attribute is used both for addressbook
  213.           hierarchy and for addressbook distribution lists.  It
  214.           indicates there is another addressbook dataset underneath this
  215.           entry.  If there is also an "addressbook.List" attribute, then
  216.           this entry is an email distribution list and the subdataset
  217.           contains the members of that list.  If "subdataset" exists,
  218.           then any "addressbook.Email" or "addressbook.Reference"
  219.           attributes SHOULD be ignored.
  220.  
  221.  
  222.  
  223. Newman                                                          [Page 2]
  224.  
  225. Internet Draft       ACAP Addressbook Dataset Class            July 1997
  226.  
  227.  
  228. 3.2. Naming Attributes
  229.  
  230.      These attributes contain information about the name of the person
  231.      or entity to which the entry refers.
  232.  
  233.      addressbook.CommonName
  234.           The "addressbook.CommonName" attribute holds the full common
  235.           name of the person or entity to which the addressbook entry
  236.           refers.  If a person has multiple names, they may be stored in
  237.           the "addressbook.AlternateNames" attribute.
  238.  
  239.           abook-common-name    = 1*TEXT-UTF8-CHAR
  240.  
  241.      addressbook.GivenName
  242.           The "addressbook.GivenName" attribute holds the given name of
  243.           the person to which the addressbook entry refers.
  244.  
  245.           abook-given-name     = 1*TEXT-UTF8-CHAR
  246.  
  247.      addressbook.Surname
  248.           The "addressbook.Surname" attribute holds the surname (or
  249.           family name) of the person to which the addressbook entry
  250.           refers.
  251.  
  252.           abook-surname        = 1*TEXT-UTF8-CHAR
  253.  
  254.      addressbook.AlternateNames
  255.           This is a multi-value attribute containing a list of alternate
  256.           names for the entry.
  257.  
  258.           abook-alt-name       = 1*TEXT-UTF8-CHAR
  259.                                  ;; multi-valued
  260.  
  261.      addressbook.Alias
  262.           A shorthand way to refer to this entry (e.g. a nickname).
  263.           Clients MUST NOT store characters which fall into the class of
  264.           "white-space" or "specials" as defined in Internet Message
  265.           Format [IMAIL] with the exception of period (".").  The alias
  266.           is typically used by clients as as a way for users to quickly
  267.           refer to a particular addressbook entry via a type-in field.
  268.           For this to work best, clients are encouraged to avoid using
  269.           the same alias in multiple entries within a dataset.
  270.  
  271.           abook-alias          = 1*<"." or any TEXT-UTF8-CHAR except
  272.                                white-space or specials as defined in [IMAIL]>
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279. Newman                                                          [Page 3]
  280.  
  281. Internet Draft       ACAP Addressbook Dataset Class            July 1997
  282.  
  283.  
  284.      addressbook.CommonName.MIME
  285.           This contains the CommonName encoded as a US-ASCII string
  286.           according to the rules in MIME Headers [MIME-HDRS].  This is
  287.           set when a personal addressbook entry is created from an
  288.           Internet Mail Address [IMAIL] which uses MIME Header encoding
  289.           for the common name portion of the address.  This is the
  290.           preferred attribute to use for the phrase portion of the
  291.           Internet Mail Address as it preserves the sender's preferred
  292.           character set.  Otherwise, the phrase is constructed from the
  293.           "addressbook.CommonName" field with all non US-ASCII
  294.           characters encoded according to MIME headers using UTF-8.
  295.           This attribute SHOULD be NIL if the CommonName is made up of
  296.           only US-ASCII characters or the sender's preferred character
  297.           set is UTF-8.
  298.  
  299.           abook-mime-hdr       = phrase
  300.                                  ;; as defined in [IMAIL]
  301.  
  302.  
  303. 3.3. Reference Attribute
  304.  
  305.  
  306.      addressbook.Reference
  307.           This addressbook entry is a reference to another ACAP
  308.           addressbook entry, or an LDAP white pages entry.  The
  309.           reference is in the form of a relative URL.  Clients SHOULD
  310.           support this attribute for the local ACAP server and MAY
  311.           support it for other ACAP or LDAP servers.
  312.  
  313.           abook-reference      = relativeURL
  314.                                  ;; as defined in [REL-URL]
  315.                                  ;; ACAP relative URL is defined in [ACAP]
  316.  
  317.  
  318. 3.4. Computer Communication Attributes
  319.  
  320.      These attributes are related to computer communication.  The format
  321.      for email addresses MUST be canonicalized so it is suitable for use
  322.      in both [IMAIL] and [SMTP].  This restricts the format for an
  323.      addr-spec as follows.  This uses terminals from [IMAIL], except
  324.      that free insertion of linear-white-space is not permitted.
  325.  
  326.      canon-addr-spec      = canon-local-part "@" domain
  327.  
  328.      canon-local-part     = quoted-string / (atom *("." atom))
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335. Newman                                                          [Page 4]
  336.  
  337. Internet Draft       ACAP Addressbook Dataset Class            July 1997
  338.  
  339.  
  340.      addressbook.Email
  341.           The primary email address for contacting this entry.
  342.           Alternate email addresses may be indicated by appending an
  343.           appropriate qualifer to the end of the attribute name, such as
  344.           ".work" for a work-related email address, ".personal" for a
  345.           personal email address, or ".alt" for a multi-valued list of
  346.           alternate email addresses of equal weight.
  347.  
  348.           abook-email          = canon-addr-spec
  349.  
  350.      addressbook.List
  351.           If both this attribute and the "subdataset" attribute exist
  352.           then this entry is an email distribution list.  The entries in
  353.           the subdataset are the members of the list.  When this
  354.           attribute exists, then any "addressbook.Email" or
  355.           "addressbook.Reference" attributes should be ignored. If this
  356.           attribute exists but no "subdataset" attribute exists, then
  357.           this attribute should be ignored.
  358.  
  359.           abook-list           = "1"
  360.  
  361.      addressbook.Expand.Address
  362.           This is an operational attribute which is present if the ACAP
  363.           server announces the ADDRESSBOOK capability.  It's value is
  364.           computed by the ACAP server.  The result is a CRLF-separated
  365.           list of all the addr-spec from the addressbook.Email
  366.           attributes of this entry, any entry referred to by
  367.           "addressbook.Reference" on the local server, and any entries
  368.           contained in the "subdataset" on this server.  This expansion
  369.           is recursive.
  370.  
  371.           abook-expand-addr    = canon-addr-spec *(CRLF canon-addr-spec)
  372.  
  373.      addressbook.Expand.Complete
  374.           This is an operational attribute which is present if the ACAP
  375.           server announces the ADDRESSBOOK capability.  It's value is
  376.           computed by the ACAP server.  The result is a CRLF-separated
  377.           list of all the Internet Mail Addresses as computed from the
  378.           addressbook.Email, addressbook.CommonName, and
  379.           addressbook.CommonName.MIME attributes.  The entry itself, any
  380.           entry referred to by "addressbook.Reference" on the local
  381.           server, and any entries contained in the "subdataset" on the
  382.           local server are expanded.  This expansion is recursive.
  383.  
  384.           abook-expand-compl   = mailbox *(CRLF mailbox)
  385.                                  ;; mailbox defined in [IMAIL] without folding
  386.  
  387.  
  388.  
  389.  
  390.  
  391. Newman                                                          [Page 5]
  392.  
  393. Internet Draft       ACAP Addressbook Dataset Class            July 1997
  394.  
  395.  
  396.      addressbook.RequestAddress
  397.           If the entry refers to a mailing list address rather than a
  398.           person, then this attribute may be used to store the address
  399.           used to subscribe or unsubscribe from the mailing list.  If
  400.           not present, clients should default the value to the standard
  401.           request address defined in [MBOX-NAMES].
  402.  
  403.           abook-request        = canon-addr-spec
  404.  
  405.      addressbook.Subscribed
  406.           If this attribute is non-NIL, then the entry refers to a
  407.           mailing list address to which the addressbook's owner is
  408.           currently subscribed.
  409.  
  410.           abook-subscribed     = "1"
  411.  
  412.      addressbook.PreferredTextFormat
  413.           This attribute contains the media type and parameters for the
  414.           preferred text format of for the mailbox referred to by the
  415.           "addressbook.Email" attribute.  The syntax does not permit
  416.           free insertion of linear white space as defined in [IMAIL].
  417.           Values can include "text/enriched", "text/html", "text/plain",
  418.           "multipart/alternative".  There is no defined default value,
  419.           although clients should be aware that the only format all
  420.           recipients support is "text/plain; charset=us-ascii".
  421.  
  422.           abook-text-format    = type "/" subtype *(";" SPACE parameter)
  423.                                  ;; as defined in [MIME-TYPES]
  424.  
  425.      addressbook.HomePage
  426.           This contains the URL [BASIC-URL] to the home page describing
  427.           the person or entity to which the addressbook entry refers.
  428.  
  429.           abook-home-page      = url
  430.                                  ;; as defined in [BASIC-URL]
  431.  
  432.  
  433. 3.5. Telephone Number Attributes
  434.  
  435.  
  436.      Telephone numbers all have the syntax "1*TEXT-UTF8-CHAR".    Fully
  437.      qualified international form is preferred:
  438.         +1 555 555 1234 ext 54
  439.      but as these are likely to be human-entered any form is permitted.
  440.  
  441.      addressbook.TelephoneNumber
  442.           This is the preferred telephone number for the person referred
  443.           to by the entry.  A suffix such as ".work" or ".home" can be
  444.  
  445.  
  446.  
  447. Newman                                                          [Page 6]
  448.  
  449. Internet Draft       ACAP Addressbook Dataset Class            July 1997
  450.  
  451.  
  452.           added to indicate alternate numbers.
  453.  
  454.      addressbook.Fax
  455.           This is the preferred fax number for the person or entity
  456.           referred to by the entry.  A suffix such as ".work" or ".home"
  457.           can be added to indicate alternate numbers.
  458.  
  459.      addressbook.MobilePhone
  460.           This is the preferred mobile phone number for the person
  461.           referred to by the entry.  A suffix such as ".work" or ".home"
  462.           can be added to indicate alternate numbers.
  463.  
  464.      addressbook.PagerNumber
  465.           This is the preferred pager number for the person or entity
  466.           referred to by the entry.  A suffix such as ".work" or ".home"
  467.           can be added to indicate alternate numbers.
  468.  
  469.  
  470. 3.6. Postal Address Attributes
  471.  
  472.      Postal addresses should be in the same format that they appear on
  473.      an envelope, preferably fully qualified.  The multiple lines are
  474.      CRLF separated within the attribute.
  475.  
  476.      addressbook.PostalAddress
  477.           This contains the preferred postal address for the person or
  478.           entity referred to by the entry.  A suffix such as ".work" or
  479.           ".home" can be added to indicate alternate addresses.
  480.  
  481.           abook-postal        = 1*TEXT-UTF8-CHAR *(CRLF *TEXT-UTF8-CHAR)
  482.  
  483.  
  484. 3.7. Commentary Attributes
  485.  
  486.      These are free-form text attributes used to store commentary about
  487.      the entry.
  488.  
  489.      addressbook.Comment
  490.           This is a freeform comment field where the owner of the
  491.           addressbook may put comments about the person or entity
  492.           referred to by the entry.
  493.  
  494.           abook-comment        = 1*UTF8-CHAR
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503. Newman                                                          [Page 7]
  504.  
  505. Internet Draft       ACAP Addressbook Dataset Class            July 1997
  506.  
  507.  
  508.      addressbook.Description
  509.           This is a freeform comment field for a self-description of the
  510.           person or entity referred to by the entry.  It is primarily
  511.           used when an entry is imported from a remote directory.
  512.  
  513.           abook-description    = 1*UTF8-CHAR
  514.  
  515. 3.8. Locational Attributes
  516.  
  517.      These contain information about the location of the person or
  518.      entity referred to by this entry.
  519.  
  520.      addressbook.Organization
  521.           This is the name of the organization with which the person or
  522.           entity is associated.
  523.  
  524.           abook-organization   = 1*TEXT-UTF8-CHAR
  525.  
  526.      addressbook.Title
  527.           This is the title of the person referred to by the entry.
  528.  
  529.           abook-title          = 1*TEXT-UTF8-CHAR
  530.  
  531.      addressbook.Locality
  532.           This is the name of the locality where the person or entity is
  533.           normally located.
  534.  
  535.           abook-locality       = 1*TEXT-UTF8-CHAR
  536.  
  537.      addressbook.Country
  538.           This is the ISO 3166 country code where the person or entity
  539.           is normally located.
  540.  
  541.           abook-country        = 2*3ALPHA
  542.  
  543.      addressbook.LanguageSpoken
  544.           This is the RFC 1766 language code for the language which the
  545.           person or entity prefers to speak.
  546.  
  547.           abook-language       = Language-Tag
  548.                                 ;; as defined in RFC 1766
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559. Newman                                                          [Page 8]
  560.  
  561. Internet Draft       ACAP Addressbook Dataset Class            July 1997
  562.  
  563.  
  564. 4.   Examples
  565.  
  566.      Some sample entries:
  567.  
  568.      In addressbook /addressbook/user/hubert
  569.  
  570.      attribute name                value
  571.      --------------                -----
  572.      entry                         ABC123
  573.      addressbook.CommonName        Patrik Faltstrom
  574.      addressbook.GivenName         Patrik
  575.      addressbook.Surname           Faltstrom
  576.      addressbook.Email             paf@swip.net
  577.      addressbook.CommonName.MIME   =?ISO-8859-1?Q?Patrik_F=E4ltstr=F6m?=
  578.      addressbook.Expand.Address    paf@swip.net
  579.      addressbook.Expand.Complete
  580.                        =?ISO-8859-1?Q?Patrik_F=E4ltstr=F6m?= <paf@swip.net>
  581.  
  582.      entry                         ABC567
  583.      addressbook.CommonName        Terry Gray
  584.      addressbook.GivenName         Terry
  585.      addressbook.Surname           Gray
  586.      addressbook.Alias             teg
  587.      addressbook.Email             gray@cac.washington.edu
  588.      addressbook.Expand.Address    gray@cac.washington.edu
  589.      addressbook.Expand.Complete   Terry Gray <gray@cac.washington.edu>
  590.  
  591.      entry                         defghi
  592.      subdataset                    .
  593.      addressbook.List              "1"
  594.      addressbook.CommonName        List of Two
  595.      addressbook.CommonName.MIME   List of Two
  596.      addressbook.Expand.Address    paf@swip.net
  597.                                    gray@cac.washington.edu
  598.                                    fred@bedrock.com
  599.      addressbook.Expand.Complete
  600.                        =?ISO-8859-1?Q?Patrik_F=E4ltstr=F6m?= <paf@swip.net>
  601.                                    Terry Gray <gray@cac.washington.edu>
  602.                                    Fred Flintstone <fred@bedrock.com>
  603.  
  604.      In dataset /addressbook/user/hubert/defghi
  605.  
  606.      entry                         xyz1
  607.      addressbook.Reference         ../ABC123
  608.      addressbook.Expand.Address    paf@swip.net
  609.      addressbook.Expand.Complete
  610.                         =?ISO-8859-1?Q?Patrik_F=E4ltstr=F6m?= <paf@swip.net>
  611.  
  612.  
  613.  
  614.  
  615. Newman                                                          [Page 9]
  616.  
  617. Internet Draft       ACAP Addressbook Dataset Class            July 1997
  618.  
  619.  
  620.      entry                         xyz2
  621.      addressbook.Reference         ../ABC567
  622.      addressbook.Expand.Address    gray@cac.washington.edu
  623.      addressbook.Expand.Complete   Terry Gray <gray@cac.washington.edu>
  624.  
  625.      entry                         z2t
  626.      addressbook.CommonName        Fred Flintstone
  627.      addressbook.GivenName         Fred
  628.      addressbook.Surname           Flintstone
  629.      addressbook.Email             fred@bedrock.com
  630.      addressbook.CommonName.MIME   Fred Flintstone
  631.      addressbook.Expand.Address    fred@bedrock.com
  632.      addressbook.Expand.Complete   Fred Flintstone <fred@bedrock.com>
  633.  
  634. 5.   References
  635.  
  636.      [ACAP] Newman, Myers, "ACAP -- Application Configuration Access
  637.      Protocol", work in progress, June 1997.
  638.  
  639.      [BASIC-URL] Berners-Lee, Masinter, McCahill, "Uniform Resource
  640.      Locators (URL)", RFC 1738, CERN, Xerox Coproration, University of
  641.      Minnesota, December 1994.
  642.  
  643.          <ftp://ds.internic.net/rfc/rfc1738.txt>
  644.  
  645.      [IMAIL] Crocker, "Standard for the Format of ARPA Internet Text
  646.      Messages", STD 11, RFC 822, University of Delaware, August 1982.
  647.  
  648.          <ftp://ds.internic.net/rfc/rfc822.txt>
  649.  
  650.      [IMAP4] Crispin, "Internet Message Access Protocol - Version
  651.      4rev1", RFC 2060, University of Washington, December 1996.
  652.  
  653.          <ftp://ds.internic.net/rfc/rfc2060.txt>
  654.  
  655.      [KEYWORDS] Bradner, "Key words for use in RFCs to Indicate
  656.      Requirement Levels", RFC 2119, Harvard University, March 1997.
  657.  
  658.          <ftp://ds.internic.net/rfc/rfc2119.txt>
  659.  
  660.      [MBOX-NAMES] Crocker, D., "Mailbox Names for Common Services, Roles
  661.      and Functions", RFC 2142, Internet Mail Consortium, May 1997.
  662.  
  663.              <ftp://ds.internic.net/rfc/rfc2142.txt>
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671. Newman                                                         [Page 10]
  672.  
  673. Internet Draft       ACAP Addressbook Dataset Class            July 1997
  674.  
  675.  
  676.      [REL-URL] Fielding, "Relative Uniform Resource Locators", RFC 1808,
  677.      UC Irvine, June 1995.
  678.  
  679.          <ftp://ds.internic.net/rfc/rfc1808.txt>
  680.  
  681.      [SMTP] Postel, "Simple Mail Transfer Protocol", RFC 821,
  682.      Information Sciences Institute, August 1982.
  683.  
  684.          <ftp://ds.internic.net/rfc/rfc821.txt>
  685.  
  686.      [UTF8] Yergeau, "UTF-8, a transformation format of Unicode and ISO
  687.      10646", RFC 2044, Alis Technologies, October 1996.
  688.  
  689.          <ftp://ds.internic.net/rfc/rfc2044.txt>
  690.  
  691. 6.   Security Considerations
  692.  
  693.      It is important to make sure that access controls are set correctly
  694.      on personal addressbooks.  One should be careful of sharing
  695.      information which might contain personal comments.
  696.  
  697.      This specification does not address storing certificates for
  698.      entries in the addressbook.  This may be added to a future version
  699.      of this specification when more experimentation has been done.
  700.  
  701. 7.   Authors' Addresses
  702.  
  703.      Chris Newman
  704.      Innosoft International, Inc.
  705.      1050 Lakes Drive
  706.      West Covina, CA 91790 USA
  707.  
  708.      Email: chris.newman@innosoft.com
  709.  
  710.      Steve Hubert
  711.      Networks and Distributed Computing
  712.      University of Washington
  713.      4545 15th Ave. NorthEast
  714.      Seattle, WA 98105-4527 USA
  715.  
  716.      Email: hubert@cac.washington.edu
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727. Newman                                                         [Page 11]
  728.  
  729. Internet Draft       ACAP Addressbook Dataset Class            July 1997
  730.  
  731.  
  732. Appendix
  733.  
  734. A.   Attribute Index
  735.  
  736.  
  737.        addressbook.Alias ..........................................    3
  738.        addressbook.AlternateNames .................................    3
  739.        addressbook.Comment ........................................    7
  740.        addressbook.CommonName .....................................    3
  741.        addressbook.CommonName.MIME ................................    4
  742.        addressbook.Country ........................................    8
  743.        addressbook.Description ....................................    8
  744.        addressbook.Email ..........................................    5
  745.        addressbook.Expand.Address .................................    5
  746.        addressbook.Expand.Complete ................................    5
  747.        addressbook.Fax ............................................    7
  748.        addressbook.GivenName ......................................    3
  749.        addressbook.HomePage .......................................    6
  750.        addressbook.LanguageSpoken .................................    8
  751.        addressbook.List ...........................................    5
  752.        addressbook.Locality .......................................    8
  753.        addressbook.MobilePhone ....................................    7
  754.        addressbook.Organization ...................................    8
  755.        addressbook.PagerNumber ....................................    7
  756.        addressbook.PostalAddress ..................................    7
  757.        addressbook.PreferredTextFormat ............................    6
  758.        addressbook.Reference ......................................    4
  759.        addressbook.RequestAddress .................................    6
  760.        addressbook.Subscribed .....................................    6
  761.        addressbook.Surname ........................................    3
  762.        addressbook.TelephoneNumber ................................    6
  763.        addressbook.Title ..........................................    8
  764.        entry ......................................................    2
  765.        subdataset .................................................    2
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784. Newman                                                         [Page 12]
  785.  
  786.