home *** CD-ROM | disk | FTP | other *** search
/ Internet Core Protocols / Oreilly-InternetCoreProtocols.iso / RFCs / rfc2310.txt < prev    next >
Encoding:
Text File  |  1999-10-14  |  8.2 KB  |  284 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                          K. Holtman
  8. Request for Comments: 2310                                            TUE
  9. Category: Experimental                                         April 1998
  10.  
  11.  
  12.                      The Safe Response Header Field
  13.  
  14. Status of this Memo
  15.  
  16.    This memo defines an Experimental Protocol for the Internet
  17.    community.  It does not specify an Internet standard of any kind.
  18.    Discussion and suggestions for improvement are requested.
  19.    Distribution of this memo is unlimited.
  20.  
  21. Copyright Notice
  22.  
  23.    Copyright (C) The Internet Society (1998).  All Rights Reserved.
  24.  
  25. Abstract
  26.  
  27.    This document defines a HTTP response header field called Safe, which
  28.    can be used to indicate that repeating a HTTP request is safe.  Such
  29.    an indication will allow user agents to handle retries of some safe
  30.    requests, in particular safe POST requests, in a more user-friendly
  31.    way.
  32.  
  33. 1 Introduction
  34.  
  35.    This document defines a HTTP response header field called Safe, which
  36.    can be used to indicate that repeating a HTTP request is safe.  Such
  37.    an indication will allow user agents to handle retries of some safe
  38.    requests, in particular safe POST requests, in a more user-friendly
  39.    way.
  40.  
  41. 2 Terminology and Notation
  42.  
  43.    This document uses the HTTP terminology and BNF notation defined in
  44.    [1].  It uses the key words in RFC 2119 for defining the significance
  45.    of each particular requirement.
  46.  
  47. 3 Rationale
  48.  
  49.    According to Section 9.1.1 (Safe Methods) of the HTTP/1.1
  50.    specification [1], POST requests are assumed to be `unsafe' by
  51.    default.  `Unsafe' means `causes side effects for which the user will
  52.    be held accountable'.
  53.  
  54.  
  55.  
  56.  
  57.  
  58. Holtman                       Experimental                      [Page 1]
  59.  
  60. RFC 2310             The Safe Response Header Field           April 1998
  61.  
  62.  
  63.    It is sometimes necessary for a user agent to repeat a POST request.
  64.    Examples of such cases are
  65.  
  66.      - when retrying a POST request which gave an indeterminate error
  67.        result in the previous attempt
  68.      - when the user presses the RELOAD button while a POST result is
  69.        displayed
  70.      - when the history function is used to redisplay a POST result
  71.        which is no longer in the history buffer.
  72.  
  73.    If the POST request is unsafe, HTTP requires explicit user
  74.    confirmation is before the request is repeated.  The confirmation
  75.    dialog often takes the form of a `repost form data?'  dialog box.
  76.    This dialog is confusing to many users, and slows down navigation in
  77.    any case.
  78.  
  79.    If the repeated POST request is safe, the user-unfriendly
  80.    confirmation dialog can be omitted.  However plain HTTP/1.1 [1] has
  81.    no mechanism by which agents can tell if POST requests are safe, and
  82.    they must be assumed unsafe by default.  This document adds a
  83.    mechanism to HTTP, the Safe header field, for telling if a POST
  84.    request is safe.
  85.  
  86.    Using the Safe header field, web applications which require the use
  87.    of a safe POST request, rather than a GET request, for the submission
  88.    of web forms, can be made more user-friendly.  The use of a POST
  89.    request may be required for a number of reasons, including
  90.  
  91.      - the contents of the form are potentially very large
  92.      - the form is used to upload a file (see [2])
  93.      - the application needs some internationalization features
  94.        (see [3]) which are only available if the form contents are
  95.        transmitted in a request body the information in the form cannot
  96.        be encoded in a GET request URL because of security
  97.        considerations.
  98.  
  99. 4 The Safe response header field
  100.  
  101.    The Safe response header field is defined as an addition to the
  102.    HTTP/1.x protocol suite.
  103.  
  104.    The Safe response header field is used by origin servers to indicate
  105.    whether repeating the received HTTP request is safe in the sense of
  106.    Section 9.1.1 (Safe Methods) of the HTTP/1.1 specification [1].  For
  107.    the purpose of this specification, a HTTP request is considered to be
  108.    a repetition of a previous request if both requests
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Holtman                       Experimental                      [Page 2]
  115.  
  116. RFC 2310             The Safe Response Header Field           April 1998
  117.  
  118.  
  119.      - are issued by the same user agent, and
  120.      - apply to the same resource, and
  121.      - have the same request method, and
  122.      - both have no request body, or both have request bodies which are
  123.        byte-wise identical after decoding of any content and transfer
  124.        codings.
  125.  
  126.    The Safe header field has the following syntax.
  127.  
  128.      Safe        = "Safe" ":" safe-nature
  129.      safe-nature = "yes" | "no"
  130.  
  131.    An example of the header field is:
  132.  
  133.      Safe: yes
  134.  
  135.    If a Safe header field is absent in the response, the corresponding
  136.    request MUST be considered unsafe, unless it is a GET or HEAD
  137.    request.  As GET and HEAD requests are safe by definition, user
  138.    agents SHOULD ignore a `Safe: no' header field in GET and HEAD
  139.    responses.
  140.  
  141.    If, according to a received Safe header field, the repeating of a
  142.    request is safe, the request MAY be repeated automatically without
  143.    asking for user confirmation.
  144.  
  145. 5 Security Considerations
  146.  
  147.    For a discussion of the security considerations connected to HTTP
  148.    form submission, see [1].  The Safe header field introduces no new
  149.    security risks.
  150.  
  151.    The use of GET requests for form submission has some security risks
  152.    which are absent for submission with other HTTP methods.  By taking
  153.    away a counter-incentive to the use of GET requests for form
  154.    submission, the Safe header field may improve overall security.
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170. Holtman                       Experimental                      [Page 3]
  171.  
  172. RFC 2310             The Safe Response Header Field           April 1998
  173.  
  174.  
  175. 6 References
  176.  
  177.    [1] Fielding, R., Gettys, J., Mogul, J., Frystyk, H., and
  178.    T. Berners-Lee, "Hypertext Transfer Protocol -- HTTP/1.1",  RFC
  179.    2068, January 1997.
  180.  
  181.    [2] Nebel, E., and L. Masinter, "Form-based File Upload in HTML",
  182.    RFC 1867, November 1995.
  183.  
  184.    [3] Yergeau, F., Nicol, G., Adams, G., and M. Duerst,
  185.    "Internationalization of the Hypertext Markup Language", RFC
  186.    2070, January 1997.
  187.  
  188. 7 Author's Address
  189.  
  190.    Koen Holtman
  191.    Technische Universiteit Eindhoven
  192.    Postbus 513
  193.    Kamer HG 6.57
  194.    5600 MB Eindhoven (The Netherlands)
  195.  
  196.    EMail: koen@win.tue.nl
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226. Holtman                       Experimental                      [Page 4]
  227.  
  228. RFC 2310             The Safe Response Header Field           April 1998
  229.  
  230.  
  231. 8.  Full Copyright Statement
  232.  
  233.    Copyright (C) The Internet Society (1998).  All Rights Reserved.
  234.  
  235.    This document and translations of it may be copied and furnished to
  236.    others, and derivative works that comment on or otherwise explain it
  237.    or assist in its implementation may be prepared, copied, published
  238.    and distributed, in whole or in part, without restriction of any
  239.    kind, provided that the above copyright notice and this paragraph are
  240.    included on all such copies and derivative works.  However, this
  241.    document itself may not be modified in any way, such as by removing
  242.    the copyright notice or references to the Internet Society or other
  243.    Internet organizations, except as needed for the purpose of
  244.    developing Internet standards in which case the procedures for
  245.    copyrights defined in the Internet Standards process must be
  246.    followed, or as required to translate it into languages other than
  247.    English.
  248.  
  249.    The limited permissions granted above are perpetual and will not be
  250.    revoked by the Internet Society or its successors or assigns.
  251.  
  252.    This document and the information contained herein is provided on an
  253.    "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
  254.    TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
  255.    BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
  256.    HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
  257.    MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  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. Holtman                       Experimental                      [Page 5]
  283.  
  284.