home *** CD-ROM | disk | FTP | other *** search
/ The Hacker's Encyclopedia 1998 / hackers_encyclopedia.iso / rfc / 3 / rfc2111.txt < prev    next >
Encoding:
Text File  |  2003-06-11  |  8.9 KB  |  284 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                        E. Levinson
  8. Request for Comments: 2111                                   XIson, Inc.
  9. Category: Standards Track                                     March 1997
  10.  
  11.  
  12.           Content-ID and Message-ID Uniform Resource Locators
  13.  
  14. Status of this Memo
  15.  
  16.    This document specifies an Internet standards track protocol for the
  17.    Internet community, and requests discussion and suggestions for
  18.    improvements.  Please refer to the current edition of the "Internet
  19.    Official Protocol Standards" (STD 1) for the standardization state
  20.    and status of this protocol.  Distribution of this memo is unlimited.
  21.  
  22. Abstract
  23.  
  24.    The Uniform Resource Locator (URL) schemes, "cid:" and "mid:" allow
  25.    references to messages and the body parts of messages.  For example,
  26.    within a single multipart message, one HTML body part might include
  27.    embedded references to other parts of the same message.
  28.  
  29. 1. Introduction
  30.  
  31.    The use of [MIME] within email to convey Web pages and their
  32.    associated images requires a URL scheme to permit the HTML to refer
  33.    to the images or other data included in the message.  The Content-ID
  34.    Uniform Resource Locator, "cid:", serves that purpose.
  35.  
  36.    Similarly Net News readers use Message-IDs to link related messages
  37.    together.  The Message-ID URL provides a scheme, "mid:", to refer to
  38.    such messages as a "resource".
  39.  
  40.    The "mid" (Message-ID) and "cid" (Content-ID) URL schemes provide
  41.    identifiers for messages and their body parts.  The "mid" scheme uses
  42.    (a part of) the message-id of an email message to refer to a specific
  43.    message.  The "cid" scheme refers to a specific body part of a
  44.    message; its use is generally limited to references to other body
  45.    parts in the same message as the referring body part.  The "mid"
  46.    scheme may also refer to a specific body part within a designated
  47.    message, by including the content-ID's address.
  48.  
  49.    A note on terminology.  The terms "body part" and "MIME entity" are
  50.    used interchangeably.  They refer to the headers and body of a MIME
  51.    message, either the message itself or one of the body parts contained
  52.    in a Multipart message.
  53.  
  54.  
  55.  
  56.  
  57.  
  58. Levinson                    Standards Track                     [Page 1]
  59.  
  60. RFC 2111                    CID and MID URLs                  March 1997
  61.  
  62.  
  63. 2. The MID and CID URL Schemes
  64.  
  65.    RFC1738 [URL] reserves the "mid" and "cid" schemes for Message-ID and
  66.    Content-ID respectively.  This memorandum defines the syntax for
  67.    those URLs.  Because they use the same syntactic elements they are
  68.    presented together.
  69.  
  70.    The URLs take the form
  71.  
  72.         content-id    = url-addr-spec
  73.  
  74.         message-id    = url-addr-spec
  75.  
  76.         url-addr-spec = addr-spec  ; URL encoding of RFC 822 addr-spec
  77.  
  78.         cid-url       = "cid" ":" content-id
  79.  
  80.         mid-url       = "mid" ":" message-id [ "/" content-id ]
  81.  
  82.       Note: in Internet mail messages, the addr-spec in a Content-ID
  83.       [MIME] or Message-ID [822] header are enclosed in angle brackets
  84.       (<>).  Since addr-spec in a Message-ID or Content-ID might contain
  85.       characters not allowed within a URL; any such character (including
  86.       "/", which is reserved within the "mid" scheme) must be hex-
  87.       encoded using the %hh escape mechanism in [URL].
  88.  
  89.    A "mid" URL with only a "message-id" refers to an entire message.
  90.    With the appended "content-id", it refers to a body part within a
  91.    message, as does a "cid" URL.  The Content-ID of a MIME body part is
  92.    required to be globally unique.  However, in many systems that store
  93.    messages, body parts are not indexed independently their context
  94.    (message).  The "mid" URL long form was designed to supply the
  95.    context needed to support interoperability with such systems.
  96.  
  97.    A implementation conforming to this specification is required to
  98.    support the "mid" URL long form (message-id/content-id).  Conforming
  99.    implementations can choose to, but are not required to, take
  100.    advantage of the content-id's uniqueness and interpret a "cid" URL to
  101.    refer to any body part within the message store.
  102.  
  103.    In limited circumstances (e.g., within multipart/alternate), a single
  104.    message may contain several body parts that have the same Content-ID.
  105.    That occurs, for example, when identical data can be accessed through
  106.    different methods [MIME, sect. 7.2.3].  In those cases, conforming
  107.    implementations are required to use the rules of the containing MIME
  108.    entity (e.g., multi-part/alternate) to select the body part to which
  109.    the Content-ID refers.
  110.  
  111.  
  112.  
  113.  
  114. Levinson                    Standards Track                     [Page 2]
  115.  
  116. RFC 2111                    CID and MID URLs                  March 1997
  117.  
  118.  
  119.    A "cid" URL is converted to the corresponding Content-ID message
  120.    header [MIME] by removing the "cid:" prefix, converting %hh hex-
  121.    escaped characters to their ASCII equivalents and enclosing the
  122.    remaining parts with an angle bracket pair, "<" and ">".  For
  123.    example, "mid:foo4%25foo1@bar.net" corresponds to
  124.  
  125.         Message-ID: <foo4%foo1@bar.net>
  126.  
  127.    A "mid" URL is converted to a Message-ID or Message-ID/Content-ID
  128.    pair in a similar fashion.
  129.  
  130.    Both message-id and content-id are required to be globally unique.
  131.    That is, no two different messages will ever have the same Message-ID
  132.    addr-spec; no different body parts will ever have the same Content-ID
  133.    addr-spec.  A common technique used by many message systems is to use
  134.    a time and date stamp along with the local host's domain name, e.g.,
  135.    950124.162336@XIson.com.
  136.  
  137. Some Examples
  138.  
  139.    The following message contains an HTML body part that refers to an
  140.    image contained in another body part.  Both body parts are contained
  141.    in a Multipart/Related MIME entity.  The HTML IMG tag contains a
  142.    cidurl which points to the image.
  143.  
  144.      From: foo1@bar.net
  145.      To: foo2@bar.net
  146.      Subject: A simple example
  147.      Mime-Version: 1.0
  148.      Content-Type: multipart/related; boundary="boundary-example-1";
  149.                    type=Text/HTML
  150.  
  151.      --boundary-example 1
  152.      Content-Type: Text/HTML; charset=US-ASCII
  153.  
  154.      ... text of the HTML document, which might contain a hyperlink
  155.      to the other body part, for example through a statement such as:
  156.      <IMG SRC="cid:foo4*foo1@bar.net" ALT="IETF logo">
  157.  
  158.      --boundary-example-1
  159.      Content-ID: foo4*foo1@bar.net
  160.      Content-Type: IMAGE/GIF
  161.      Content-Transfer-Encoding: BASE64
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170. Levinson                    Standards Track                     [Page 3]
  171.  
  172. RFC 2111                    CID and MID URLs                  March 1997
  173.  
  174.  
  175.      R0lGODlhGAGgAPEAAP/////ZRaCgoAAAACH+PUNvcHlyaWdodCAoQykgMTk5
  176.      NSBJRVRGLiBVbmF1dGhvcml6ZWQgZHVwbGljYXRpb24gcHJvaGliaXRlZC4A
  177.      etc...
  178.  
  179.      --boundary-example-1--
  180.  
  181.    The following message points to another message (hopefully still in
  182.    the recipient's message store).
  183.  
  184.      From: bar@none.com
  185.      To: phooey@all.com
  186.      Subject: Here's how to do it
  187.      Content-type: text/html; charset=usascii
  188.  
  189.      ...  The items in my
  190.      <A HREF= "mid:960830.1639@XIson.com/partA.960830.1639@XIson.com">
  191.      previous message</A>, shows how the approach you propose can be
  192.      used to accomplish ...
  193.  
  194. 3. Security Considerations
  195.  
  196.    The URLs defined here provide an addressing or referencing mechanism.
  197.    The values of these URLs disclose no more about the originators
  198.    environment than the corresponding Message-ID and Content-ID values.
  199.    Where concern exists about such disclosures the originator of a
  200.    message using mid and cid URLs must take precautions to insure that
  201.    confidential information is not disclosed.  Those precautions should
  202.    already be in place to handle existing mail use of the Message-ID and
  203.    Content-ID.
  204.  
  205. 4. References
  206.  
  207. [822]     Crocker, D., "Standard for the Format of ARPA Internet Text
  208.           Messages," August 1982, University of Delaware, STD 11, RFC
  209.           822.
  210.  
  211. [MIME]    N. Borenstein, N. Freed, "MIME (Multipurpose Internet Mail
  212.           Extensions) Part One:  Mechanisms for Specifying and
  213.           Describing the Format of Internet Message Bodies,"
  214.           September 1993, RFC 1521.
  215.  
  216. [URL]     Berners-Lee, T., Masinter, L., and McCahill, M., "Uniform
  217.           Resource Locators (URL)," December 1994.
  218.  
  219. [MULREL]  E. Levinson, "The MIME Multipart/Related Content-type,"
  220.           December 1995, RFC 1874.
  221.  
  222.  
  223.  
  224.  
  225.  
  226. Levinson                    Standards Track                     [Page 4]
  227.  
  228. RFC 2111                    CID and MID URLs                  March 1997
  229.  
  230.  
  231. 5. Acknowledgments
  232.  
  233.    The original concept of "mid" and "cid" URLs were part of the Tim
  234.    Berners-Lee's original vision of the World Wide Web. The ideas and
  235.    design have benefited greatly by discussions with Harald Alvestrand,
  236.    Dan Connolly, Roy Fielding, Larry Masinter, Jacob Palme, and others
  237.    in the MHTML working group.
  238.  
  239. 6. Author's Address
  240.  
  241.    Edward Levinson
  242.    47 Clive Street
  243.    Metuchen, NJ  08840-1060
  244.    USA
  245.    +1 908 549 3716
  246.    <XIson@cnj.digex.net>
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282. Levinson                    Standards Track                     [Page 5]
  283.  
  284.