Network Working Group                                        Tim Howes
INTERNET DRAFT                                              Mark Smith
draft-ietf-asid-mime-person-00.txt              University of Michigan


 An Application/Directory MIME Content-Type White Pages Person Profile



1.  Status of this Memo

This document is an Internet-Draft.  Internet-Drafts are  working  docu-
ments  of the Internet Engineering Task Force (IETF), its areas, and its
working groups.  Note that other  groups  may  also  distribute  working
documents as Internet-Drafts.

Internet-Drafts are draft documents valid for a maximum  of  six  months
and  may  be  updated,  replaced, or obsoleted by other documents at any
time.  It is inappropriate to use Internet- Drafts as reference material
or to cite them other than as ``work in progress.''

To learn the current status of  any  Internet-Draft,  please  check  the
``1id-abstracts.txt''  listing  contained in the Internet- Drafts Shadow
Directories   on   ftp.is.co.za   (Africa),   nic.nordu.net    (Europe),
munnari.oz.au   (Pacific  Rim),  ds.internic.net  (US  East  Coast),  or
ftp.isi.edu (US West Coast).

2.  Abstract

This memo defines a directory information profile for a white pages per-
son,  to  be  carried in an application/directory MIME Content-Type. The
profile consists of type definitions (e.g., for name and email  address)
and the corresponding format of values that each type is allowed to con-
tain.

3.  Overview

The application/directory MIME Content-Type  defined  in  [MIME-DIR]  is
used for representing directory information in MIME format. It defines a
general framework for carrying "type: value" style  information  in  the
body  of  a  MIME message, but does not define specific types or values.
This document defines a profile containing the types  and  corresponding
value formats for representing information about an Internet white pages
person. The profile reflects the Internet  white  pages  service  schema
defined in [DIR-WPP].






Howes & Smith                                                   [Page 1]


Expires July 1996                                         INTERNET DRAFT


4.  The White Pages Person Profile

The profile is defined as follows, using the profile  registration  tem-
plate from Section 8 of [MIME-DIR].

4.1.  Person profile definition

   To: ietf-mime-direct@umich.edu
   Subject: Registration of application/directory MIME profile wpperson

   Profile name: wpperson

   Profile purpose: to hold white pages information about a person

   Profile types: address, cn, sn, email, o, phone,  misc,  lastmoddate,
   lastmodby, lastmodtype, dataowner, datasource

The associated type definitions follow, using the type registration tem-
plate from Section 9 of [MIME-DIR].

4.2.  Address Type Definition

   To: ietf-mime-direct@umich.edu
   Subject: Registration of application/directory MIME type address

   Type name: address

   Type purpose: to hold postal address information

   Type encoding: a sequence of text lines separated by <CRLF> SPACE

   Type special notes: The usual  line-folding  technique  described  in
   [MIME-DIR]  can  be  used  to  represent  multi-line addresses (i.e.,
   applications should interpret folded address lines as separate  lines
   in a single address, not a continuation of one address line).

4.3.  Cn Type Definition

   To: ietf-mime-direct@umich.edu
   Subject: Registration of application/directory MIME type cn

   Type name: cn

   Type purpose: to hold a name

   Type encoding: text





Howes & Smith                                                   [Page 2]


Expires July 1996                                         INTERNET DRAFT


4.4.  Sn Type Definition

   To: ietf-mime-direct@umich.edu
   Subject: Registration of application/directory MIME type sn

   Type name: sn

   Type purpose: to hold a last name, family name, or surname

   Type encoding: text

4.5.  Email Type Definition

   To: ietf-mime-direct@umich.edu
   Subject: Registration of application/directory MIME type email

   Type name: email

   Type purpose: to hold an Internet email address

   Type encoding: text representing an email address as defined in  sec-
   tion 6.1 of [RFC-822]

4.6.  O Type Definition

   To: ietf-mime-direct@umich.edu
   Subject: Registration of application/directory MIME type o

   Type name: o

   Type purpose: to hold an organization name

   Type encoding: text

4.7.  Phone Type Definition

   To: ietf-mime-direct@umich.edu
   Subject: Registration of application/directory MIME type phone

   Type name: phone

   Type purpose: to hold a voice, fax, cellular, mobile, or  other  type
   of telephone phone number

   Type encoding: text

   Type special notes:




Howes & Smith                                                   [Page 3]


Expires July 1996                                         INTERNET DRAFT


      If this type is to be used to hold  multiple  kinds  of  telephone
      numbers (e.g., fax and voice), it is advisable to distinguish them
      with some kind of descriptive comment in the value. For example:

         phone: +1 313 747-4454 (voice)
         phone: +1 313 764-5140 (fax)

4.8.  Misc Type Definition

   To: ietf-mime-direct@umich.edu
   Subject: Registration of application/directory MIME type misc

   Type name: misc

   Type purpose: to hold miscellaneous information

   Type encoding: text

   Type special notes:

      This type is intended to hold miscellaneous  descriptive  informa-
      tion  about  a  person that does not fit in one of the other types
      defined above.  It should not be  used  to  hold  information  for
      which other types have been defined.

4.9.  Lastmodby Type Definition

   To: ietf-mime-direct@umich.edu
   Subject: Registration of application/directory MIME type lastmodby

   Type name: lastmodby

   Type purpose: to hold the directory name of  the  entity  which  last
   modified a directory entity

   Type encoding: text

   Type special notes:

      Note that the text encoding of the directory name may be directory
      service specific.

4.10.  Lastmoddate Type Definition

   To: ietf-mime-direct@umich.edu
   Subject: Registration of application/directory MIME type lastmoddate

   Type name: lastmoddate



Howes & Smith                                                   [Page 4]


Expires July 1996                                         INTERNET DRAFT


   Type purpose: to hold the time when a directory entity was last modi-
   fied

   Type encoding: a string containing a time as defined in  section  5.1
   of [RFC-822] for "date-time".

4.11.  Lastmodtype Type Definition

   To: ietf-mime-direct@umich.edu
   Subject: Registration of application/directory MIME type lastmodtype

   Type name: lastmodtype

   Type purpose: to hold the type of  information  last  modified  in  a
   directory entity

   Type encoding: text containing a type name as defined in section 5 of
   [MIME-DIR] for "type".

4.12.  Dataowner Type Definition

   To: ietf-mime-direct@umich.edu
   Subject: Registration of application/directory MIME type dataowner

   Type name: dataowner

   Type purpose: to identify the owner of directory information pertain-
   ing to an entity

   Type encoding: text

4.13.  Datasource Type Definition

   To: ietf-mime-direct@umich.edu
   Subject: Registration of application/directory MIME type datasource

   Type name: datasource

   Type purpose: to identify the source of  directory  information  per-
   taining to an entity

   Type encoding: text

5.  Examples

The    following    example    illustrates    simple    use    of    the
"application/directory" Content-Type with the "person" profile.




Howes & Smith                                                   [Page 5]


Expires July 1996                                         INTERNET DRAFT


   From: Whomever
   To: Someone
   Subject: whatever
   MIME-Version: 1.0
   Message-ID: <id1@host.net>
   Content-Type: application/directory; profile="person"
   Content-ID: <id2@host.com>

   cn: Babs Jensen
   cn: Barbara J Jensen
   sn: Jensen
   email: babs@umich.edu
   phone: +1 313 747-4454 (voice)
   phone: +1 313 764-5140 (fax)

The next example illustrates the use of RFC  1522  encoding  to  include
non-ascii characters in some of the "person" profile types.

   Content-Type: application/directory;
           profile="person";
           charset="iso-8859-1"
   Content-ID: <id3@host.com>
   Content-Transfer-Encoding: Quoted-Printable

   cn: Bj=F8rn Jensen
   sn: Jensen
   address: 535 W. William St.
           Ann Arbor, MI 48103
   email: bjorn@umich.edu
   phone: +1 313 747-4454

6.  Security Considerations

Internet mail is subject to many well known security attacks,  including
monitoring,  replay,  and forgery. Applications should also take care to
display directory data in a "safe" environment (e.g.,  PostScript-valued
types).

7.  Acknowledgements

This material is based upon work supported by the National Science Foun-
dation under Grant No. NCR-9416667.

8.  Bibliography

[RFC-1777]Yeong, W., Howes, T., Kille, S., "Lightweight Directory Access
          Protocol", Request for Comment (RFC) 1777, March 1995.




Howes & Smith                                                   [Page 6]


Expires July 1996                                         INTERNET DRAFT


[RFC-1778]Howes, T., Kille, S., Yeong, W., Robbins,  C.J.,  "The  String
          Representation  of  Standard  Attribute Syntaxes", Request for
          Comment (RFC) 1778, March 1995.

[RFC-822] Crocker, D., "Standard for the Format of  ARPA  Internet  Text
          Messages", STD 11, RFC 822, August 1982.

[RFC-1521]Borenstein, N., Freed, N., "MIME (Multipurpose  Internet  Mail
          Extensions) Part One: Mechanisms for Specifying and Describing
          the Format of Internet Message Bodies",  RFC  1521,  September
          1993.

[RFC-1522]Moore, K., "MIME (Multipurpose Internet Mail Extensions)  Part
          Two:  Message Header Extensions for Non-ASCII Text", RFC 1522,
          September 1993.

[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., Weider, C.,  "Archi-
          tecture of the WHOIS++ service", August 1995.

[MIME-DIR]Howes, T., Smith,  M.,  "A  MIME  Content-Type  for  Directory
          Information,"    Internet-Draft   draft-ietf-asid-mime-direct-
          01.txt, January, 1996.

[DIR-WPP] Genovese, T., "A Common Schema for the  Internet  White  Pages
          Service,"    Internet-Draft   draft-ietf-ids-iwps-schema-spec-
          00.txt, November 1995.

9.  Author's Address

   Tim Howes
   University of Michigan
   535 W William St.
   Ann Arbor, MI 48103-4943
   USA
   +1 313 747-4454
   tim@umich.edu

   Mark Smith
   University of Michigan
   535 W William St.
   Ann Arbor, MI 48103-4943
   USA
   +1 313 764-2277
   mcs@umich.edu



Howes & Smith                                                   [Page 7]


Expires July 1996                                         INTERNET DRAFT


10.  Appendix A - Correspondence With Various Directory Services

The scheme defined here is intended to be general enough  to  work  with
any  number  of  directory  services, including, but not limited to LDAP
[RFC-1777], WHOIS++ [RFC-1835], SOLO, and X.500 [x500].   This  appendix
provides  a mapping between attribute types or fields in these directory
services and the scheme defined here.

                name in                   name in              name in
      type      LDAP/X.500                SOLO                 WHOIS++
      --------------------------------------------------------------------
      address   postalAddress             Work-address         Work-Postal
                homePostalAddress                              Home-Postal

      cn        commonName                Name                 Name
                cn                        CommonName

      sn        surname                   Surname
                sn

      email     rfc822Mailbox             Email-address        Email
                mail                      rfc822Mailbox
                mhsORAddresses            X400

      o         organizationName          Organization         Organization-Name
                o

      phone     telephoneNumber           Work-telephone       Work-Phone
                homeTelephoneNumber       Fax-telephone        Home-Phone
                facsimileTelephoneNumber                       Work-Fax
                                                               Home-Fax




















Howes & Smith                                                   [Page 8]