The Archived-At Message Header Field
draft-duerst-archived-at-09

Status of this Memo

By submitting this Internet-Draft, each author represents that any applicable patent or other IPR claims of which he or she is aware have been or will be disclosed, and any of which he or she becomes aware will be disclosed, in accordance with Section 6 of BCP 79.

Internet-Drafts are working documents 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.”

The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/1id-abstracts.txt.

The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html.

This Internet-Draft will expire on February 22, 2008.

Abstract

This memo defines a new email header field, Archived-At:, to provide a direct link to the archived form of an individual email message.

Table of Contents

1.  Introduction
2.  Header Field Definition
    2.1.  Syntax
    2.2.  Multiple Archived-At Header Fields
    2.3.  Interaction with Message Fragmentation and Reassembly
    2.4.  Syntax Extension for Internationalized Message Headers
    2.5.  The X-Archived-At Header Field
3.  Implementation and Usage Considerations
    3.1.  Formats of Archived Message
    3.2.  Implementation Considerations
    3.3.  Usage Considerations
4.  Security Considerations
5.  IANA Considerations
    5.1.  Registration of the Archive-At Header Field
    5.2.  Registration of the X-Archived-At Header Field
6.  Change Log
    6.1.  Changes from -08.txt to -09.txt
    6.2.  Changes from -07.txt to -08.txt
    6.3.  Changes from -06.txt to -07.txt
    6.4.  Changes from -05.txt to -06.txt
    6.5.  Changes from -04.txt to -05.txt
    6.6.  Changes from -03.txt to -04.txt
    6.7.  Changes from -02.txt to -03.txt
7.  Acknowledgments
8.  References
    8.1.  Normative References
    8.2.  Informative References
§  Author's Address
§  Intellectual Property and Copyright Statements

1.  Introduction

[RFC2369] (Baer, J. and G. Neufeld, “The Use of URLs as Meta-Syntax for Core Mail List Commands and their Transport through Message Header Fields,” July 1998.) defines a number of header fields that can be added to Internet messages such as those sent by email distribution lists or in netnews [RFCXXXX] (Murchison, K., Lindsey, C., and D. Kohn, “Netnews Article Format (Note to RFC Editor: Please update this reference with the RFC resulting from draft-ietf-usefor-usefor-xx.txt, and remove this Note.),” January 2007.). One of them is the 'List-Archive' header field that describes how to access archives for the list. This allows to access the archives as a whole, but not the individual message.

There is often a need or desire to refer to the archived form of a single message. For more detailed usage scenarios, please see Section 3.3 (Usage Considerations). This memo defines a new header, 'Archived-At', to refer to a single message at an archived location. This provides quick access to the location of a mailing list message in the list archive. It can also be used independently of mailing lists, for example in connection with legal requirements to archive certain messages.

In this document, the key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" are to be interpreted as described in [RFC2119] (Bradner, S., “Key words for use in RFCs to Indicate Requirement Levels,” March 1997.).

2.  Header Field Definition

2.1.  Syntax

For the Archived-At header field, the field name is 'Archived-At'. The field body consist of a URI [STD66] (Berners-Lee, T., Fielding, R., and L. Masinter, “Uniform Resource Identifier (URI): Generic Syntax,” January 2005.) enclosed in angle brackets ('<', '>'). The URI MAY contain folding white space (FWS, [RFC2822] (Resnick, P., “Internet Message Format,” April 2001.)), which is ignored. MTAs MUST NOT insert whitespace within the angle brackets, but client applications SHOULD ignore any whitespace, which might have been inserted by poorly behaved MTAs. The URI points to an archived version of the message. See Section 3.1 (Formats of Archived Message) for some more details.

This header field is subject to the encoding and character restrictions for mail headers as described in [RFC2822] (Resnick, P., “Internet Message Format,” April 2001.).

More formally, the header field is defined as follows in ABNF according to [RFC4234] (Crocker, D. and P. Overell, “Augmented BNF for Syntax Specifications: ABNF,” October 2005.):

   archived-at = "Archived-At:" [FWS] "<" folded-URI ">" CRLF
   folded-URI  = <URI, but free insertion of FWS permitted>

where URI is defined in [STD66] (Berners-Lee, T., Fielding, R., and L. Masinter, “Uniform Resource Identifier (URI): Generic Syntax,” January 2005.) and CRLF and FWS are defined in [RFC2822] (Resnick, P., “Internet Message Format,” April 2001.).

To convert folded-URI to a URI, first apply standard [RFC2822] (Resnick, P., “Internet Message Format,” April 2001.) unfolding rules (replacing FWS with a single SP), and then delete any remaining un-encoded SP characters.

This syntax is kept simple in that only one URI per header field is allowed. In this point, the syntax is different from [RFC2369] (Baer, J. and G. Neufeld, “The Use of URLs as Meta-Syntax for Core Mail List Commands and their Transport through Message Header Fields,” July 1998.). Also, comments are not allowed.

2.2.  Multiple Archived-At Header Fields

Each Archived-At header field only contains a single URI. If it is desired to list multiple URIs where an archived copy of the message can be found, a separate Archived-At field per URI is required. Multiple Archived-At header fields with the same URI SHOULD be avoided. An Archived-At header field SHOULD only be created if the message is actually being made available at the URI given in the header field.

If a message is forwarded from a list to a sublist, and both lists support adding the Archived-At header field, then the sublist SHOULD add a new Archived-At header field without removing the already existing one(s), unless the header field is exactly the same as an already existing one, in which case the new header field SHOULD NOT be added.

2.3.  Interaction with Message Fragmentation and Reassembly

[RFC2046] (Freed, N. and N. Borenstein, “Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types,” November 1996.) allows for the fragmentation and reassembly of messages. Archived-At header fields are to be treated in the same way as Comment header fields, i.e. copied to the first fragment message header on fragmentation and back from there to the header of the reassembled message.

This treatment has been chosen for compatibility with existing infrastructure. It means that Archived-At header fields in the first fragment message MAY refer to an archived version of the whole, unfragmented, message. To avoid confusion, Archived-At headers SHOULD NOT be added to fragment messages.

2.4.  Syntax Extension for Internationalized Message Headers

There are some efforts to allow non-ASCII text directly in message header field bodies. In such contexts, the URI non-terminal in the syntax defined in Section 2.1 (Syntax) is to be replaced by IRI as defined in [RFC3987] (Duerst, M. and M. Suignard, “Internationalized Resource Identifiers (IRIs),” January 2005.). The specifics of the actual octet encoding of the IRI will follow the rules for general direct encoding of non-ASCII text. For conversion between IRIs and URIs, the procedures defined in [RFC3987] (Duerst, M. and M. Suignard, “Internationalized Resource Identifiers (IRIs),” January 2005.) are to be applied.

2.5.  The X-Archived-At Header Field

For backwards compatibility, this document also describes the X-Archived-At header field, a precursor of the Archived-At header field. The X-Archived-At header field MAY also be parsed, but SHOULD not be generated.

The following is the syntax of the X-Archived-At header field, in ABNF according to [RFC4234] (Crocker, D. and P. Overell, “Augmented BNF for Syntax Specifications: ABNF,” October 2005.) (which also defines SP):

   obs-archived-at = "X-Archived-At:"  SP URI CRLF

The X-Archived-At header field does not allow white space inside URI.

3.  Implementation and Usage Considerations

3.1.  Formats of Archived Message

There is no restriction on the format used to serve the archived message from the URI in a 'Archived-At' header field. It is expected that in many cases, the archived message will be served as (X)HTML, as plain text, or in its original form as message/rfc822 [RFC2046] (Freed, N. and N. Borenstein, “Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types,” November 1996.). Some forms of URIs may imply the format in which the archived message is served, although this should not be relied upon.

If the protocol used to retrieve the message allows for content negotiation, then it is also possible to serve the archived message in several different formats. As an example, a HTTP URI in an 'Archived-At' header may make it possible to serve the archived message both as text/html for human consumption in a browser and as message/rfc822 for use by a mail user agent without loss of information.

3.2.  Implementation Considerations

Mailing list expanders and email archives are often separate pieces of software. It may therefore be difficult to create an 'Archived-At' header field in the mailing list expander software.

One way to address this difficulty is to have the mailing list expander software generate an unambiguous URI, e.g. an URI based on the message identifier of the incoming email, and to set up the archiving system so that it redirects requests for such URIs to the actual messages. If the email does not contain a message identifier, a unique identifier can be generated.

Such a system has been implemented and is in productive use at W3C. As an example, the URI
"http://www.w3.org/mid/0I5U00G08DFGCR@mailsj-v1.corp.adobe.com", containing the significant part of the message identifier "<0I5U00G08DFGCR@mailsj-v1.corp.adobe.com>", is redirected to the URI of this message in the W3C mailing-list archive at http://lists.w3.org/Archives/Public/uri/2004Oct/0017.html.

Source code for this implementation is available at http://dev.w3.org/cvsweb/search/, in particular http://dev.w3.org/cvsweb/search/cgi/mid.pl and http://dev.w3.org/cvsweb/search/bin/msgid-db.pl. These locations may be subject to change.

When using the message identifier to create an address for the archived mail, care has to be taken to escape characters in the message identifier that are not allowed in the URI, or to remove them, as done above for the "<" and ">" delimiters.

Implementations such as that described above can introduce a security issue. Somebody might deliberately reuse a message identifier to break the link to a message. This can be addressed by checking incoming message identifiers against those of the messages already in the archive and discarding incoming duplicates, by checking the content of incoming duplicates and discarding them if they are significantly different from the first message, by offering multiple choices in the response to the URI, or by using some authentication mechanism on incoming messages.

3.3.  Usage Considerations

It may at first seem strange to have a pointer to an archived form of a message in a header field of that same message. After all, if one has the message, why would one need a pointer to it? It turns out that such pointers can be extremely useful. This section describes some of the scenarios for their use.

A user may want to refer to messages in a non-message context, such as on a Web page, in an instant message, or in a phone conversation. In such a case, the user can extract the URI from the Archived-At header field, avoiding the search for the correct message in the archive.

A user may want to refer to other messages in a message context. Referring to a single message is often done by replying to that message. However, when referring to more than one message, providing pointers to archived messages is a widespread practice. The Archived-At header field makes it easier to provide these pointers.

A user may want to find messages related to a message at hand. The user may not have received the related messages, and therefore needs to use an archive. The user may also prefer finding related messages in the archive rather than in her MUA, because messages in archives may be linked in ways not provided by the MUA. The Archived-At header field provides a link to the starting point in the archive from which to find related messages.

Please note that in the above usage scenarios, it is mostly the human reader, rather than the email client software, that makes use of the URI in the Archived-At header. However, this does not rule out the use of the URI in the Archived-At header by the email client or other software if such use is found helpful.

4.  Security Considerations

There are many potential security issues when activating and dereferencing an URI. For more details, including some countermeasures, please see [STD66] (Berners-Lee, T., Fielding, R., and L. Masinter, “Uniform Resource Identifier (URI): Generic Syntax,” January 2005.). In the context of this proposal, the following are particularly relevant: An intruder may get access to the message transmission and be able to insert an URI pointing to some malicious content. This can be addressed by using a secured way of message transmission. Also, somebody may be able to construct a message that is harmless when received directly, but that produces problems when accessed via the URI. One reason for this may be the format used in the archive, where some content was not adequately escaped. This can be addressed by using adequate escaping.

The Archived-At header field points to some archived form of the message itself. This in turn may contain the Archived-At field. This creates a potential for a denial-of-service attack on the server pointed to by the URI in the Archived-At header field. The conditions are that the archived form of the message is downloaded automatically, and that further URIs in that message are followed and downloaded recursively without checking for already downloaded resources. However, this kind of scenario can easily be avoided by implementations. First, the URI in the Archived-At header field should not be dereferenced automatically. Second, appropriate measures for loop detection should be used.

In Section 3.2 (Implementation Considerations), an attack is described that may break an URI to a message by introducing a new message with the same message identifier. Possible countermeasures are also discussed.

5.  IANA Considerations

5.1.  Registration of the Archive-At Header Field

IANA is herewith requested to register the Archived-At header field in the Message Header Fields Registry ([RFC3864] (Klyne, G., Nottingham, M., and J. Mogul, “Registration Procedures for Message Header Fields,” September 2004.)) as follows:

   Header field name:
      Archived-At

   Applicable protocol:
      mail (RFC 2822) and netnews (RFC XXXX)

   Status:
      standard

   Author/Change controller:
      IETF

   Specification document(s):
      Internet-Draft draft-duerst-archived-at-08.txt
      (Note to IANA and RFC Editor: Replace this with
       RFC YYYY (RFC number of this specification))

   Related information:
      none

5.2.  Registration of the X-Archived-At Header Field

This section is non-normative (specifically, an implementation which ignores this section remains compliant with this specification).

IANA is herewith requested to register the X-Archived-At header field in the Message Header Fields Registry ([RFC3864] (Klyne, G., Nottingham, M., and J. Mogul, “Registration Procedures for Message Header Fields,” September 2004.)) as follows:

   Header field name:
      X-Archived-At

   Applicable protocol:
      mail (RFC 2822) and netnews (RFC XXXX)

   Status:
      deprecated

   Author/Change controller:
      IETF

   Specification document(s):
      Internet-Draft draft-duerst-archived-at-08.txt
      (Note to IANA and RFC Editor: Replace this with
       RFC YYYY (RFC number of this specification))

   Related information:
      none

6.  Change Log

Note to RFC Editor: Please remove this whole section before publication.

6.1.  Changes from -08.txt to -09.txt

Fixed some typos.

Changed from "message id" to more correct "message identifier".

Added a sentence to cover the case of messages without message identifiers.

6.2.  Changes from -07.txt to -08.txt

Replaced 'you' by 'a user' in usage considerations section.

Added a note to say that URIs may not be permanent for pointers to example implementation in "Implementation Considerations" section.

Improved advice on countermeasures for the security issue in Section 3.2 (Implementation Considerations).

Removed a superfluous sentence.

Added some discussion of countermeasures to the first security issue in the security section (first paragraph).

Updated acknoledgments.

6.3.  Changes from -06.txt to -07.txt

Changed ABNF to introduce the folded-URI rule.

Added text about a security issue to , and mentioned it in the security section. (Implementation Considerations)

Updated reference to netnews format.

Some wording improvements.

6.4.  Changes from -05.txt to -06.txt

Removed 'also optionally' for netnews.

Improved explanation in section about IRIs.

Some wording improvements.

6.5.  Changes from -04.txt to -05.txt

Small wording adjustments for readability.

Separated normative and informative references, added reference to RFC1036.

Moved X-Archived-At header into separate section and added registration template.

Clarified syntax: allowed FWS, provided alternate syntax in an attempt to describe different syntactic layers, changed single quotes to double quotes for literals.

Added section about message fragmentation.

Reorganized document to reduce number of top-level sections.

Added section about IRIs.

Removed reference to 'safe' URI characters (no longer a term used in URI spec).

Removed "URI not empty" comment in ABNF: URI according to STD66 has to contain a scheme part anyway because it is absolute.

6.6.  Changes from -03.txt to -04.txt

Updated from RFC 2234 to RFC 4234.

Updated author's address/affiliation.

6.7.  Changes from -02.txt to -03.txt

Fixed syntax to allow spaces after colon.

Avoided misunderstanding with message ids ('<' and '>' are part of the message id)

Added reference to RFC 2119 (keywords)

Changed "MUST" to "SHOULD" for existence of message

7.  Acknowledgments

The members of the W3C system team, in particular Gerald Oskoboiny, Olivier Thereaux, Jose Kahan, and Eric Prud'hommeaux, created the mid-based email archive lookup system and the experimental form of the Archived-At header. Pete Resnik provided the motivation for writing up this memo. Discussion on the ietf-822@imc.org mailing list, in particular contributions by Frank Ellermann, Arnt Gulbrandsen, Graham Klyne, Bruce Lilly, Charles Lindsey, and Keith Moore, has led to further improvements of the proposal. Chris Newman, Chris Lonvick, Stephane Borzmeyer, Vijay K. Gurbani, and S. Moonesamy provided additional valuable comments.

8.  References

8.1. Normative References

8.2. Informative References

Author's Address

Full Copyright Statement

Copyright © The IETF Trust (2007).

This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights.

This document and the information contained herein are provided on an “AS IS” basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM 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.

Intellectual Property

The IETF takes no position regarding the validity or scope of any Intellectual Property Rights or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; nor does it represent that it has made any independent effort to identify any such rights. Information on the procedures with respect to rights in RFC documents can be found in BCP 78 and BCP 79.

Copies of IPR disclosures made to the IETF Secretariat and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr.

The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement this standard. Please address the information to the IETF at ietf-ipr@ietf.org.