1 |
|
---|
2 |
|
---|
3 |
|
---|
4 | HTTPbis Working Group R. Fielding, Ed.
|
---|
5 | Internet-Draft Day Software
|
---|
6 | Obsoletes: 2616 (if approved) J. Gettys
|
---|
7 | Updates: 2617 (if approved) One Laptop per Child
|
---|
8 | Intended status: Standards Track J. Mogul
|
---|
9 | Expires: January 14, 2010 HP
|
---|
10 | H. Frystyk
|
---|
11 | Microsoft
|
---|
12 | L. Masinter
|
---|
13 | Adobe Systems
|
---|
14 | P. Leach
|
---|
15 | Microsoft
|
---|
16 | T. Berners-Lee
|
---|
17 | W3C/MIT
|
---|
18 | Y. Lafon, Ed.
|
---|
19 | W3C
|
---|
20 | J. Reschke, Ed.
|
---|
21 | greenbytes
|
---|
22 | July 13, 2009
|
---|
23 |
|
---|
24 |
|
---|
25 | HTTP/1.1, part 7: Authentication
|
---|
26 | draft-ietf-httpbis-p7-auth-07
|
---|
27 |
|
---|
28 | Status of this Memo
|
---|
29 |
|
---|
30 | This Internet-Draft is submitted to IETF in full conformance with the
|
---|
31 | provisions of BCP 78 and BCP 79. This document may contain material
|
---|
32 | from IETF Documents or IETF Contributions published or made publicly
|
---|
33 | available before November 10, 2008. The person(s) controlling the
|
---|
34 | copyright in some of this material may not have granted the IETF
|
---|
35 | Trust the right to allow modifications of such material outside the
|
---|
36 | IETF Standards Process. Without obtaining an adequate license from
|
---|
37 | the person(s) controlling the copyright in such materials, this
|
---|
38 | document may not be modified outside the IETF Standards Process, and
|
---|
39 | derivative works of it may not be created outside the IETF Standards
|
---|
40 | Process, except to format it for publication as an RFC or to
|
---|
41 | translate it into languages other than English.
|
---|
42 |
|
---|
43 | Internet-Drafts are working documents of the Internet Engineering
|
---|
44 | Task Force (IETF), its areas, and its working groups. Note that
|
---|
45 | other groups may also distribute working documents as Internet-
|
---|
46 | Drafts.
|
---|
47 |
|
---|
48 | Internet-Drafts are draft documents valid for a maximum of six months
|
---|
49 | and may be updated, replaced, or obsoleted by other documents at any
|
---|
50 | time. It is inappropriate to use Internet-Drafts as reference
|
---|
51 | material or to cite them other than as "work in progress."
|
---|
52 |
|
---|
53 |
|
---|
54 |
|
---|
55 | Fielding, et al. Expires January 14, 2010 [Page 1]
|
---|
56 |
|
---|
57 | Internet-Draft HTTP/1.1, Part 7 July 2009
|
---|
58 |
|
---|
59 |
|
---|
60 | The list of current Internet-Drafts can be accessed at
|
---|
61 | http://www.ietf.org/ietf/1id-abstracts.txt.
|
---|
62 |
|
---|
63 | The list of Internet-Draft Shadow Directories can be accessed at
|
---|
64 | http://www.ietf.org/shadow.html.
|
---|
65 |
|
---|
66 | This Internet-Draft will expire on January 14, 2010.
|
---|
67 |
|
---|
68 | Copyright Notice
|
---|
69 |
|
---|
70 | Copyright (c) 2009 IETF Trust and the persons identified as the
|
---|
71 | document authors. All rights reserved.
|
---|
72 |
|
---|
73 | This document is subject to BCP 78 and the IETF Trust's Legal
|
---|
74 | Provisions Relating to IETF Documents in effect on the date of
|
---|
75 | publication of this document (http://trustee.ietf.org/license-info).
|
---|
76 | Please review these documents carefully, as they describe your rights
|
---|
77 | and restrictions with respect to this document.
|
---|
78 |
|
---|
79 | Abstract
|
---|
80 |
|
---|
81 | The Hypertext Transfer Protocol (HTTP) is an application-level
|
---|
82 | protocol for distributed, collaborative, hypermedia information
|
---|
83 | systems. HTTP has been in use by the World Wide Web global
|
---|
84 | information initiative since 1990. This document is Part 7 of the
|
---|
85 | seven-part specification that defines the protocol referred to as
|
---|
86 | "HTTP/1.1" and, taken together, obsoletes RFC 2616. Part 7 defines
|
---|
87 | HTTP Authentication.
|
---|
88 |
|
---|
89 | Editorial Note (To be removed by RFC Editor)
|
---|
90 |
|
---|
91 | Discussion of this draft should take place on the HTTPBIS working
|
---|
92 | group mailing list (ietf-http-wg@w3.org). The current issues list is
|
---|
93 | at <http://tools.ietf.org/wg/httpbis/trac/report/11> and related
|
---|
94 | documents (including fancy diffs) can be found at
|
---|
95 | <http://tools.ietf.org/wg/httpbis/>.
|
---|
96 |
|
---|
97 | The changes in this draft are summarized in Appendix C.8.
|
---|
98 |
|
---|
99 |
|
---|
100 |
|
---|
101 |
|
---|
102 |
|
---|
103 |
|
---|
104 |
|
---|
105 |
|
---|
106 |
|
---|
107 |
|
---|
108 |
|
---|
109 |
|
---|
110 |
|
---|
111 | Fielding, et al. Expires January 14, 2010 [Page 2]
|
---|
112 |
|
---|
113 | Internet-Draft HTTP/1.1, Part 7 July 2009
|
---|
114 |
|
---|
115 |
|
---|
116 | Table of Contents
|
---|
117 |
|
---|
118 | 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 4
|
---|
119 | 1.1. Requirements . . . . . . . . . . . . . . . . . . . . . . . 4
|
---|
120 | 1.2. Syntax Notation . . . . . . . . . . . . . . . . . . . . . 4
|
---|
121 | 1.2.1. Core Rules . . . . . . . . . . . . . . . . . . . . . . 5
|
---|
122 | 1.2.2. ABNF Rules defined in other Parts of the
|
---|
123 | Specification . . . . . . . . . . . . . . . . . . . . 5
|
---|
124 | 2. Status Code Definitions . . . . . . . . . . . . . . . . . . . 5
|
---|
125 | 2.1. 401 Unauthorized . . . . . . . . . . . . . . . . . . . . . 5
|
---|
126 | 2.2. 407 Proxy Authentication Required . . . . . . . . . . . . 5
|
---|
127 | 3. Header Field Definitions . . . . . . . . . . . . . . . . . . . 5
|
---|
128 | 3.1. Authorization . . . . . . . . . . . . . . . . . . . . . . 6
|
---|
129 | 3.2. Proxy-Authenticate . . . . . . . . . . . . . . . . . . . . 7
|
---|
130 | 3.3. Proxy-Authorization . . . . . . . . . . . . . . . . . . . 7
|
---|
131 | 3.4. WWW-Authenticate . . . . . . . . . . . . . . . . . . . . . 7
|
---|
132 | 4. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 8
|
---|
133 | 4.1. Message Header Registration . . . . . . . . . . . . . . . 8
|
---|
134 | 5. Security Considerations . . . . . . . . . . . . . . . . . . . 8
|
---|
135 | 5.1. Authentication Credentials and Idle Clients . . . . . . . 8
|
---|
136 | 6. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 9
|
---|
137 | 7. References . . . . . . . . . . . . . . . . . . . . . . . . . . 9
|
---|
138 | 7.1. Normative References . . . . . . . . . . . . . . . . . . . 9
|
---|
139 | 7.2. Informative References . . . . . . . . . . . . . . . . . . 10
|
---|
140 | Appendix A. Compatibility with Previous Versions . . . . . . . . 10
|
---|
141 | A.1. Changes from RFC 2616 . . . . . . . . . . . . . . . . . . 10
|
---|
142 | Appendix B. Collected ABNF . . . . . . . . . . . . . . . . . . . 10
|
---|
143 | Appendix C. Change Log (to be removed by RFC Editor before
|
---|
144 | publication) . . . . . . . . . . . . . . . . . . . . 11
|
---|
145 | C.1. Since RFC2616 . . . . . . . . . . . . . . . . . . . . . . 11
|
---|
146 | C.2. Since draft-ietf-httpbis-p7-auth-00 . . . . . . . . . . . 11
|
---|
147 | C.3. Since draft-ietf-httpbis-p7-auth-01 . . . . . . . . . . . 11
|
---|
148 | C.4. Since draft-ietf-httpbis-p7-auth-02 . . . . . . . . . . . 11
|
---|
149 | C.5. Since draft-ietf-httpbis-p7-auth-03 . . . . . . . . . . . 11
|
---|
150 | C.6. Since draft-ietf-httpbis-p7-auth-04 . . . . . . . . . . . 11
|
---|
151 | C.7. Since draft-ietf-httpbis-p7-auth-05 . . . . . . . . . . . 12
|
---|
152 | C.8. Since draft-ietf-httpbis-p7-auth-06 . . . . . . . . . . . 12
|
---|
153 | Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
|
---|
154 | Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 13
|
---|
155 |
|
---|
156 |
|
---|
157 |
|
---|
158 |
|
---|
159 |
|
---|
160 |
|
---|
161 |
|
---|
162 |
|
---|
163 |
|
---|
164 |
|
---|
165 |
|
---|
166 |
|
---|
167 | Fielding, et al. Expires January 14, 2010 [Page 3]
|
---|
168 |
|
---|
169 | Internet-Draft HTTP/1.1, Part 7 July 2009
|
---|
170 |
|
---|
171 |
|
---|
172 | 1. Introduction
|
---|
173 |
|
---|
174 | This document defines HTTP/1.1 access control and authentication.
|
---|
175 | Right now it includes the extracted relevant sections of RFC 2616
|
---|
176 | with only minor changes. The intention is to move the general
|
---|
177 | framework for HTTP authentication here, as currently specified in
|
---|
178 | [RFC2617], and allow the individual authentication mechanisms to be
|
---|
179 | defined elsewhere. This introduction will be rewritten when that
|
---|
180 | occurs.
|
---|
181 |
|
---|
182 | HTTP provides several OPTIONAL challenge-response authentication
|
---|
183 | mechanisms which can be used by a server to challenge a client
|
---|
184 | request and by a client to provide authentication information. The
|
---|
185 | general framework for access authentication, and the specification of
|
---|
186 | "basic" and "digest" authentication, are specified in "HTTP
|
---|
187 | Authentication: Basic and Digest Access Authentication" [RFC2617].
|
---|
188 | This specification adopts the definitions of "challenge" and
|
---|
189 | "credentials" from that specification.
|
---|
190 |
|
---|
191 | 1.1. Requirements
|
---|
192 |
|
---|
193 | The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
|
---|
194 | "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
|
---|
195 | document are to be interpreted as described in [RFC2119].
|
---|
196 |
|
---|
197 | An implementation is not compliant if it fails to satisfy one or more
|
---|
198 | of the MUST or REQUIRED level requirements for the protocols it
|
---|
199 | implements. An implementation that satisfies all the MUST or
|
---|
200 | REQUIRED level and all the SHOULD level requirements for its
|
---|
201 | protocols is said to be "unconditionally compliant"; one that
|
---|
202 | satisfies all the MUST level requirements but not all the SHOULD
|
---|
203 | level requirements for its protocols is said to be "conditionally
|
---|
204 | compliant."
|
---|
205 |
|
---|
206 | 1.2. Syntax Notation
|
---|
207 |
|
---|
208 | This specification uses the ABNF syntax defined in Section 1.2 of
|
---|
209 | [Part1] (which extends the syntax defined in [RFC5234] with a list
|
---|
210 | rule). Appendix B shows the collected ABNF, with the list rule
|
---|
211 | expanded.
|
---|
212 |
|
---|
213 | The following core rules are included by reference, as defined in
|
---|
214 | [RFC5234], Appendix B.1: ALPHA (letters), CR (carriage return), CRLF
|
---|
215 | (CR LF), CTL (controls), DIGIT (decimal 0-9), DQUOTE (double quote),
|
---|
216 | HEXDIG (hexadecimal 0-9/A-F/a-f), LF (line feed), OCTET (any 8-bit
|
---|
217 | sequence of data), SP (space), VCHAR (any visible USASCII character),
|
---|
218 | and WSP (whitespace).
|
---|
219 |
|
---|
220 |
|
---|
221 |
|
---|
222 |
|
---|
223 | Fielding, et al. Expires January 14, 2010 [Page 4]
|
---|
224 |
|
---|
225 | Internet-Draft HTTP/1.1, Part 7 July 2009
|
---|
226 |
|
---|
227 |
|
---|
228 | 1.2.1. Core Rules
|
---|
229 |
|
---|
230 | The core rules below are defined in Section 1.2.2 of [Part1]:
|
---|
231 |
|
---|
232 | OWS = <OWS, defined in [Part1], Section 1.2.2>
|
---|
233 |
|
---|
234 | 1.2.2. ABNF Rules defined in other Parts of the Specification
|
---|
235 |
|
---|
236 | The ABNF rules below are defined in other specifications:
|
---|
237 |
|
---|
238 | challenge = <challenge, defined in [RFC2617], Section 1.2>
|
---|
239 | credentials = <credentials, defined in [RFC2617], Section 1.2>
|
---|
240 |
|
---|
241 |
|
---|
242 | 2. Status Code Definitions
|
---|
243 |
|
---|
244 | 2.1. 401 Unauthorized
|
---|
245 |
|
---|
246 | The request requires user authentication. The response MUST include
|
---|
247 | a WWW-Authenticate header field (Section 3.4) containing a challenge
|
---|
248 | applicable to the requested resource. The client MAY repeat the
|
---|
249 | request with a suitable Authorization header field (Section 3.1). If
|
---|
250 | the request already included Authorization credentials, then the 401
|
---|
251 | response indicates that authorization has been refused for those
|
---|
252 | credentials. If the 401 response contains the same challenge as the
|
---|
253 | prior response, and the user agent has already attempted
|
---|
254 | authentication at least once, then the user SHOULD be presented the
|
---|
255 | entity that was given in the response, since that entity might
|
---|
256 | include relevant diagnostic information. HTTP access authentication
|
---|
257 | is explained in "HTTP Authentication: Basic and Digest Access
|
---|
258 | Authentication" [RFC2617].
|
---|
259 |
|
---|
260 | 2.2. 407 Proxy Authentication Required
|
---|
261 |
|
---|
262 | This code is similar to 401 (Unauthorized), but indicates that the
|
---|
263 | client must first authenticate itself with the proxy. The proxy MUST
|
---|
264 | return a Proxy-Authenticate header field (Section 3.2) containing a
|
---|
265 | challenge applicable to the proxy for the requested resource. The
|
---|
266 | client MAY repeat the request with a suitable Proxy-Authorization
|
---|
267 | header field (Section 3.3). HTTP access authentication is explained
|
---|
268 | in "HTTP Authentication: Basic and Digest Access Authentication"
|
---|
269 | [RFC2617].
|
---|
270 |
|
---|
271 |
|
---|
272 | 3. Header Field Definitions
|
---|
273 |
|
---|
274 | This section defines the syntax and semantics of HTTP/1.1 header
|
---|
275 | fields related to authentication.
|
---|
276 |
|
---|
277 |
|
---|
278 |
|
---|
279 | Fielding, et al. Expires January 14, 2010 [Page 5]
|
---|
280 |
|
---|
281 | Internet-Draft HTTP/1.1, Part 7 July 2009
|
---|
282 |
|
---|
283 |
|
---|
284 | 3.1. Authorization
|
---|
285 |
|
---|
286 | A user agent that wishes to authenticate itself with a server--
|
---|
287 | usually, but not necessarily, after receiving a 401 response--does so
|
---|
288 | by including an Authorization request-header field with the request.
|
---|
289 | The field "Authorization" consists of credentials containing the
|
---|
290 | authentication information of the user agent for the realm of the
|
---|
291 | resource being requested.
|
---|
292 |
|
---|
293 | Authorization = "Authorization" ":" OWS Authorization-v
|
---|
294 | Authorization-v = credentials
|
---|
295 |
|
---|
296 | HTTP access authentication is described in "HTTP Authentication:
|
---|
297 | Basic and Digest Access Authentication" [RFC2617]. If a request is
|
---|
298 | authenticated and a realm specified, the same credentials SHOULD be
|
---|
299 | valid for all other requests within this realm (assuming that the
|
---|
300 | authentication scheme itself does not require otherwise, such as
|
---|
301 | credentials that vary according to a challenge value or using
|
---|
302 | synchronized clocks).
|
---|
303 |
|
---|
304 | When a shared cache (see Section 1.2 of [Part6]) receives a request
|
---|
305 | containing an Authorization field, it MUST NOT return the
|
---|
306 | corresponding response as a reply to any other request, unless one of
|
---|
307 | the following specific exceptions holds:
|
---|
308 |
|
---|
309 | 1. If the response includes the "s-maxage" cache-control directive,
|
---|
310 | the cache MAY use that response in replying to a subsequent
|
---|
311 | request. But (if the specified maximum age has passed) a proxy
|
---|
312 | cache MUST first revalidate it with the origin server, using the
|
---|
313 | request-headers from the new request to allow the origin server
|
---|
314 | to authenticate the new request. (This is the defined behavior
|
---|
315 | for s-maxage.) If the response includes "s-maxage=0", the proxy
|
---|
316 | MUST always revalidate it before re-using it.
|
---|
317 |
|
---|
318 | 2. If the response includes the "must-revalidate" cache-control
|
---|
319 | directive, the cache MAY use that response in replying to a
|
---|
320 | subsequent request. But if the response is stale, all caches
|
---|
321 | MUST first revalidate it with the origin server, using the
|
---|
322 | request-headers from the new request to allow the origin server
|
---|
323 | to authenticate the new request.
|
---|
324 |
|
---|
325 | 3. If the response includes the "public" cache-control directive, it
|
---|
326 | MAY be returned in reply to any subsequent request.
|
---|
327 |
|
---|
328 |
|
---|
329 |
|
---|
330 |
|
---|
331 |
|
---|
332 |
|
---|
333 |
|
---|
334 |
|
---|
335 | Fielding, et al. Expires January 14, 2010 [Page 6]
|
---|
336 |
|
---|
337 | Internet-Draft HTTP/1.1, Part 7 July 2009
|
---|
338 |
|
---|
339 |
|
---|
340 | 3.2. Proxy-Authenticate
|
---|
341 |
|
---|
342 | The response-header field "Proxy-Authenticate" MUST be included as
|
---|
343 | part of a 407 (Proxy Authentication Required) response. The field
|
---|
344 | value consists of a challenge that indicates the authentication
|
---|
345 | scheme and parameters applicable to the proxy for this request-
|
---|
346 | target.
|
---|
347 |
|
---|
348 | Proxy-Authenticate = "Proxy-Authenticate" ":" OWS
|
---|
349 | Proxy-Authenticate-v
|
---|
350 | Proxy-Authenticate-v = 1#challenge
|
---|
351 |
|
---|
352 | The HTTP access authentication process is described in "HTTP
|
---|
353 | Authentication: Basic and Digest Access Authentication" [RFC2617].
|
---|
354 | Unlike WWW-Authenticate, the Proxy-Authenticate header field applies
|
---|
355 | only to the current connection and SHOULD NOT be passed on to
|
---|
356 | downstream clients. However, an intermediate proxy might need to
|
---|
357 | obtain its own credentials by requesting them from the downstream
|
---|
358 | client, which in some circumstances will appear as if the proxy is
|
---|
359 | forwarding the Proxy-Authenticate header field.
|
---|
360 |
|
---|
361 | 3.3. Proxy-Authorization
|
---|
362 |
|
---|
363 | The request-header field "Proxy-Authorization" allows the client to
|
---|
364 | identify itself (or its user) to a proxy which requires
|
---|
365 | authentication. The Proxy-Authorization field value consists of
|
---|
366 | credentials containing the authentication information of the user
|
---|
367 | agent for the proxy and/or realm of the resource being requested.
|
---|
368 |
|
---|
369 | Proxy-Authorization = "Proxy-Authorization" ":" OWS
|
---|
370 | Proxy-Authorization-v
|
---|
371 | Proxy-Authorization-v = credentials
|
---|
372 |
|
---|
373 | The HTTP access authentication process is described in "HTTP
|
---|
374 | Authentication: Basic and Digest Access Authentication" [RFC2617].
|
---|
375 | Unlike Authorization, the Proxy-Authorization header field applies
|
---|
376 | only to the next outbound proxy that demanded authentication using
|
---|
377 | the Proxy-Authenticate field. When multiple proxies are used in a
|
---|
378 | chain, the Proxy-Authorization header field is consumed by the first
|
---|
379 | outbound proxy that was expecting to receive credentials. A proxy
|
---|
380 | MAY relay the credentials from the client request to the next proxy
|
---|
381 | if that is the mechanism by which the proxies cooperatively
|
---|
382 | authenticate a given request.
|
---|
383 |
|
---|
384 | 3.4. WWW-Authenticate
|
---|
385 |
|
---|
386 | The WWW-Authenticate response-header field MUST be included in 401
|
---|
387 | (Unauthorized) response messages. The field value consists of at
|
---|
388 |
|
---|
389 |
|
---|
390 |
|
---|
391 | Fielding, et al. Expires January 14, 2010 [Page 7]
|
---|
392 |
|
---|
393 | Internet-Draft HTTP/1.1, Part 7 July 2009
|
---|
394 |
|
---|
395 |
|
---|
396 | least one challenge that indicates the authentication scheme(s) and
|
---|
397 | parameters applicable to the request-target.
|
---|
398 |
|
---|
399 | WWW-Authenticate = "WWW-Authenticate" ":" OWS WWW-Authenticate-v
|
---|
400 | WWW-Authenticate-v = 1#challenge
|
---|
401 |
|
---|
402 | The HTTP access authentication process is described in "HTTP
|
---|
403 | Authentication: Basic and Digest Access Authentication" [RFC2617].
|
---|
404 | User agents are advised to take special care in parsing the WWW-
|
---|
405 | Authenticate field value as it might contain more than one challenge,
|
---|
406 | or if more than one WWW-Authenticate header field is provided, the
|
---|
407 | contents of a challenge itself can contain a comma-separated list of
|
---|
408 | authentication parameters.
|
---|
409 |
|
---|
410 |
|
---|
411 | 4. IANA Considerations
|
---|
412 |
|
---|
413 | 4.1. Message Header Registration
|
---|
414 |
|
---|
415 | The Message Header Registry located at <http://www.iana.org/
|
---|
416 | assignments/message-headers/message-header-index.html> should be
|
---|
417 | updated with the permanent registrations below (see [RFC3864]):
|
---|
418 |
|
---|
419 | +---------------------+----------+----------+-------------+
|
---|
420 | | Header Field Name | Protocol | Status | Reference |
|
---|
421 | +---------------------+----------+----------+-------------+
|
---|
422 | | Authorization | http | standard | Section 3.1 |
|
---|
423 | | Proxy-Authenticate | http | standard | Section 3.2 |
|
---|
424 | | Proxy-Authorization | http | standard | Section 3.3 |
|
---|
425 | | WWW-Authenticate | http | standard | Section 3.4 |
|
---|
426 | +---------------------+----------+----------+-------------+
|
---|
427 |
|
---|
428 | The change controller is: "IETF (iesg@ietf.org) - Internet
|
---|
429 | Engineering Task Force".
|
---|
430 |
|
---|
431 |
|
---|
432 | 5. Security Considerations
|
---|
433 |
|
---|
434 | This section is meant to inform application developers, information
|
---|
435 | providers, and users of the security limitations in HTTP/1.1 as
|
---|
436 | described by this document. The discussion does not include
|
---|
437 | definitive solutions to the problems revealed, though it does make
|
---|
438 | some suggestions for reducing security risks.
|
---|
439 |
|
---|
440 | 5.1. Authentication Credentials and Idle Clients
|
---|
441 |
|
---|
442 | Existing HTTP clients and user agents typically retain authentication
|
---|
443 | information indefinitely. HTTP/1.1 does not provide a method for a
|
---|
444 |
|
---|
445 |
|
---|
446 |
|
---|
447 | Fielding, et al. Expires January 14, 2010 [Page 8]
|
---|
448 |
|
---|
449 | Internet-Draft HTTP/1.1, Part 7 July 2009
|
---|
450 |
|
---|
451 |
|
---|
452 | server to direct clients to discard these cached credentials. This
|
---|
453 | is a significant defect that requires further extensions to HTTP.
|
---|
454 | Circumstances under which credential caching can interfere with the
|
---|
455 | application's security model include but are not limited to:
|
---|
456 |
|
---|
457 | o Clients which have been idle for an extended period following
|
---|
458 | which the server might wish to cause the client to reprompt the
|
---|
459 | user for credentials.
|
---|
460 |
|
---|
461 | o Applications which include a session termination indication (such
|
---|
462 | as a `logout' or `commit' button on a page) after which the server
|
---|
463 | side of the application `knows' that there is no further reason
|
---|
464 | for the client to retain the credentials.
|
---|
465 |
|
---|
466 | This is currently under separate study. There are a number of work-
|
---|
467 | arounds to parts of this problem, and we encourage the use of
|
---|
468 | password protection in screen savers, idle time-outs, and other
|
---|
469 | methods which mitigate the security problems inherent in this
|
---|
470 | problem. In particular, user agents which cache credentials are
|
---|
471 | encouraged to provide a readily accessible mechanism for discarding
|
---|
472 | cached credentials under user control.
|
---|
473 |
|
---|
474 |
|
---|
475 | 6. Acknowledgments
|
---|
476 |
|
---|
477 | [[anchor2: TBD.]]
|
---|
478 |
|
---|
479 |
|
---|
480 | 7. References
|
---|
481 |
|
---|
482 | 7.1. Normative References
|
---|
483 |
|
---|
484 | [Part1] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H.,
|
---|
485 | Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed.,
|
---|
486 | and J. Reschke, Ed., "HTTP/1.1, part 1: URIs, Connections,
|
---|
487 | and Message Parsing", draft-ietf-httpbis-p1-messaging-07
|
---|
488 | (work in progress), July 2009.
|
---|
489 |
|
---|
490 | [Part6] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H.,
|
---|
491 | Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed.,
|
---|
492 | Nottingham, M., Ed., and J. Reschke, Ed., "HTTP/1.1, part
|
---|
493 | 6: Caching", draft-ietf-httpbis-p6-cache-07 (work in
|
---|
494 | progress), July 2009.
|
---|
495 |
|
---|
496 | [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
|
---|
497 | Requirement Levels", BCP 14, RFC 2119, March 1997.
|
---|
498 |
|
---|
499 | [RFC2617] Franks, J., Hallam-Baker, P., Hostetler, J., Lawrence, S.,
|
---|
500 |
|
---|
501 |
|
---|
502 |
|
---|
503 | Fielding, et al. Expires January 14, 2010 [Page 9]
|
---|
504 |
|
---|
505 | Internet-Draft HTTP/1.1, Part 7 July 2009
|
---|
506 |
|
---|
507 |
|
---|
508 | Leach, P., Luotonen, A., and L. Stewart, "HTTP
|
---|
509 | Authentication: Basic and Digest Access Authentication",
|
---|
510 | RFC 2617, June 1999.
|
---|
511 |
|
---|
512 | [RFC5234] Crocker, D., Ed. and P. Overell, "Augmented BNF for Syntax
|
---|
513 | Specifications: ABNF", STD 68, RFC 5234, January 2008.
|
---|
514 |
|
---|
515 | 7.2. Informative References
|
---|
516 |
|
---|
517 | [RFC2616] Fielding, R., Gettys, J., Mogul, J., Frystyk, H.,
|
---|
518 | Masinter, L., Leach, P., and T. Berners-Lee, "Hypertext
|
---|
519 | Transfer Protocol -- HTTP/1.1", RFC 2616, June 1999.
|
---|
520 |
|
---|
521 | [RFC3864] Klyne, G., Nottingham, M., and J. Mogul, "Registration
|
---|
522 | Procedures for Message Header Fields", BCP 90, RFC 3864,
|
---|
523 | September 2004.
|
---|
524 |
|
---|
525 |
|
---|
526 | Appendix A. Compatibility with Previous Versions
|
---|
527 |
|
---|
528 | A.1. Changes from RFC 2616
|
---|
529 |
|
---|
530 |
|
---|
531 | Appendix B. Collected ABNF
|
---|
532 |
|
---|
533 | Authorization = "Authorization:" OWS Authorization-v
|
---|
534 | Authorization-v = credentials
|
---|
535 |
|
---|
536 | OWS = <OWS, defined in [Part1], Section 1.2.2>
|
---|
537 |
|
---|
538 | Proxy-Authenticate = "Proxy-Authenticate:" OWS Proxy-Authenticate-v
|
---|
539 | Proxy-Authenticate-v = *( "," OWS ) challenge *( OWS "," [ OWS
|
---|
540 | challenge ] )
|
---|
541 | Proxy-Authorization = "Proxy-Authorization:" OWS
|
---|
542 | Proxy-Authorization-v
|
---|
543 | Proxy-Authorization-v = credentials
|
---|
544 |
|
---|
545 | WWW-Authenticate = "WWW-Authenticate:" OWS WWW-Authenticate-v
|
---|
546 | WWW-Authenticate-v = *( "," OWS ) challenge *( OWS "," [ OWS
|
---|
547 | challenge ] )
|
---|
548 |
|
---|
549 | challenge = <challenge, defined in [RFC2617], Section 1.2>
|
---|
550 | credentials = <credentials, defined in [RFC2617], Section 1.2>
|
---|
551 |
|
---|
552 |
|
---|
553 |
|
---|
554 |
|
---|
555 |
|
---|
556 |
|
---|
557 |
|
---|
558 |
|
---|
559 | Fielding, et al. Expires January 14, 2010 [Page 10]
|
---|
560 |
|
---|
561 | Internet-Draft HTTP/1.1, Part 7 July 2009
|
---|
562 |
|
---|
563 |
|
---|
564 | ABNF diagnostics:
|
---|
565 |
|
---|
566 | ; Authorization defined but not used
|
---|
567 | ; Proxy-Authenticate defined but not used
|
---|
568 | ; Proxy-Authorization defined but not used
|
---|
569 | ; WWW-Authenticate defined but not used
|
---|
570 |
|
---|
571 |
|
---|
572 | Appendix C. Change Log (to be removed by RFC Editor before publication)
|
---|
573 |
|
---|
574 | C.1. Since RFC2616
|
---|
575 |
|
---|
576 | Extracted relevant partitions from [RFC2616].
|
---|
577 |
|
---|
578 | C.2. Since draft-ietf-httpbis-p7-auth-00
|
---|
579 |
|
---|
580 | Closed issues:
|
---|
581 |
|
---|
582 | o <http://tools.ietf.org/wg/httpbis/trac/ticket/35>: "Normative and
|
---|
583 | Informative references"
|
---|
584 |
|
---|
585 | C.3. Since draft-ietf-httpbis-p7-auth-01
|
---|
586 |
|
---|
587 | Ongoing work on ABNF conversion
|
---|
588 | (<http://tools.ietf.org/wg/httpbis/trac/ticket/36>):
|
---|
589 |
|
---|
590 | o Explicitly import BNF rules for "challenge" and "credentials" from
|
---|
591 | RFC2617.
|
---|
592 |
|
---|
593 | o Add explicit references to BNF syntax and rules imported from
|
---|
594 | other parts of the specification.
|
---|
595 |
|
---|
596 | C.4. Since draft-ietf-httpbis-p7-auth-02
|
---|
597 |
|
---|
598 | Ongoing work on IANA Message Header Registration
|
---|
599 | (<http://tools.ietf.org/wg/httpbis/trac/ticket/40>):
|
---|
600 |
|
---|
601 | o Reference RFC 3984, and update header registrations for headers
|
---|
602 | defined in this document.
|
---|
603 |
|
---|
604 | C.5. Since draft-ietf-httpbis-p7-auth-03
|
---|
605 |
|
---|
606 | C.6. Since draft-ietf-httpbis-p7-auth-04
|
---|
607 |
|
---|
608 | Ongoing work on ABNF conversion
|
---|
609 | (<http://tools.ietf.org/wg/httpbis/trac/ticket/36>):
|
---|
610 |
|
---|
611 |
|
---|
612 |
|
---|
613 |
|
---|
614 |
|
---|
615 | Fielding, et al. Expires January 14, 2010 [Page 11]
|
---|
616 |
|
---|
617 | Internet-Draft HTTP/1.1, Part 7 July 2009
|
---|
618 |
|
---|
619 |
|
---|
620 | o Use "/" instead of "|" for alternatives.
|
---|
621 |
|
---|
622 | o Introduce new ABNF rules for "bad" whitespace ("BWS"), optional
|
---|
623 | whitespace ("OWS") and required whitespace ("RWS").
|
---|
624 |
|
---|
625 | o Rewrite ABNFs to spell out whitespace rules, factor out header
|
---|
626 | value format definitions.
|
---|
627 |
|
---|
628 | C.7. Since draft-ietf-httpbis-p7-auth-05
|
---|
629 |
|
---|
630 | Final work on ABNF conversion
|
---|
631 | (<http://tools.ietf.org/wg/httpbis/trac/ticket/36>):
|
---|
632 |
|
---|
633 | o Add appendix containing collected and expanded ABNF, reorganize
|
---|
634 | ABNF introduction.
|
---|
635 |
|
---|
636 | C.8. Since draft-ietf-httpbis-p7-auth-06
|
---|
637 |
|
---|
638 | None.
|
---|
639 |
|
---|
640 |
|
---|
641 | Index
|
---|
642 |
|
---|
643 | 4
|
---|
644 | 401 Unauthorized (status code) 5
|
---|
645 | 407 Proxy Authentication Required (status code) 5
|
---|
646 |
|
---|
647 | A
|
---|
648 | Authorization header 6
|
---|
649 |
|
---|
650 | G
|
---|
651 | Grammar
|
---|
652 | Authorization 6
|
---|
653 | Authorization-v 6
|
---|
654 | challenge 5
|
---|
655 | credentials 5
|
---|
656 | Proxy-Authenticate 7
|
---|
657 | Proxy-Authenticate-v 7
|
---|
658 | Proxy-Authorization 7
|
---|
659 | Proxy-Authorization-v 7
|
---|
660 | WWW-Authenticate 8
|
---|
661 | WWW-Authenticate-v 8
|
---|
662 |
|
---|
663 | H
|
---|
664 | Headers
|
---|
665 | Authorization 6
|
---|
666 | Proxy-Authenticate 7
|
---|
667 | Proxy-Authorization 7
|
---|
668 |
|
---|
669 |
|
---|
670 |
|
---|
671 | Fielding, et al. Expires January 14, 2010 [Page 12]
|
---|
672 |
|
---|
673 | Internet-Draft HTTP/1.1, Part 7 July 2009
|
---|
674 |
|
---|
675 |
|
---|
676 | WWW-Authenticate 7
|
---|
677 |
|
---|
678 | P
|
---|
679 | Proxy-Authenticate header 7
|
---|
680 | Proxy-Authorization header 7
|
---|
681 |
|
---|
682 | S
|
---|
683 | Status Codes
|
---|
684 | 401 Unauthorized 5
|
---|
685 | 407 Proxy Authentication Required 5
|
---|
686 |
|
---|
687 | W
|
---|
688 | WWW-Authenticate header 7
|
---|
689 |
|
---|
690 |
|
---|
691 | Authors' Addresses
|
---|
692 |
|
---|
693 | Roy T. Fielding (editor)
|
---|
694 | Day Software
|
---|
695 | 23 Corporate Plaza DR, Suite 280
|
---|
696 | Newport Beach, CA 92660
|
---|
697 | USA
|
---|
698 |
|
---|
699 | Phone: +1-949-706-5300
|
---|
700 | Fax: +1-949-706-5305
|
---|
701 | Email: fielding@gbiv.com
|
---|
702 | URI: http://roy.gbiv.com/
|
---|
703 |
|
---|
704 |
|
---|
705 | Jim Gettys
|
---|
706 | One Laptop per Child
|
---|
707 | 21 Oak Knoll Road
|
---|
708 | Carlisle, MA 01741
|
---|
709 | USA
|
---|
710 |
|
---|
711 | Email: jg@laptop.org
|
---|
712 | URI: http://www.laptop.org/
|
---|
713 |
|
---|
714 |
|
---|
715 | Jeffrey C. Mogul
|
---|
716 | Hewlett-Packard Company
|
---|
717 | HP Labs, Large Scale Systems Group
|
---|
718 | 1501 Page Mill Road, MS 1177
|
---|
719 | Palo Alto, CA 94304
|
---|
720 | USA
|
---|
721 |
|
---|
722 | Email: JeffMogul@acm.org
|
---|
723 |
|
---|
724 |
|
---|
725 |
|
---|
726 |
|
---|
727 | Fielding, et al. Expires January 14, 2010 [Page 13]
|
---|
728 |
|
---|
729 | Internet-Draft HTTP/1.1, Part 7 July 2009
|
---|
730 |
|
---|
731 |
|
---|
732 | Henrik Frystyk Nielsen
|
---|
733 | Microsoft Corporation
|
---|
734 | 1 Microsoft Way
|
---|
735 | Redmond, WA 98052
|
---|
736 | USA
|
---|
737 |
|
---|
738 | Email: henrikn@microsoft.com
|
---|
739 |
|
---|
740 |
|
---|
741 | Larry Masinter
|
---|
742 | Adobe Systems, Incorporated
|
---|
743 | 345 Park Ave
|
---|
744 | San Jose, CA 95110
|
---|
745 | USA
|
---|
746 |
|
---|
747 | Email: LMM@acm.org
|
---|
748 | URI: http://larry.masinter.net/
|
---|
749 |
|
---|
750 |
|
---|
751 | Paul J. Leach
|
---|
752 | Microsoft Corporation
|
---|
753 | 1 Microsoft Way
|
---|
754 | Redmond, WA 98052
|
---|
755 |
|
---|
756 | Email: paulle@microsoft.com
|
---|
757 |
|
---|
758 |
|
---|
759 | Tim Berners-Lee
|
---|
760 | World Wide Web Consortium
|
---|
761 | MIT Computer Science and Artificial Intelligence Laboratory
|
---|
762 | The Stata Center, Building 32
|
---|
763 | 32 Vassar Street
|
---|
764 | Cambridge, MA 02139
|
---|
765 | USA
|
---|
766 |
|
---|
767 | Email: timbl@w3.org
|
---|
768 | URI: http://www.w3.org/People/Berners-Lee/
|
---|
769 |
|
---|
770 |
|
---|
771 |
|
---|
772 |
|
---|
773 |
|
---|
774 |
|
---|
775 |
|
---|
776 |
|
---|
777 |
|
---|
778 |
|
---|
779 |
|
---|
780 |
|
---|
781 |
|
---|
782 |
|
---|
783 | Fielding, et al. Expires January 14, 2010 [Page 14]
|
---|
784 |
|
---|
785 | Internet-Draft HTTP/1.1, Part 7 July 2009
|
---|
786 |
|
---|
787 |
|
---|
788 | Yves Lafon (editor)
|
---|
789 | World Wide Web Consortium
|
---|
790 | W3C / ERCIM
|
---|
791 | 2004, rte des Lucioles
|
---|
792 | Sophia-Antipolis, AM 06902
|
---|
793 | France
|
---|
794 |
|
---|
795 | Email: ylafon@w3.org
|
---|
796 | URI: http://www.raubacapeu.net/people/yves/
|
---|
797 |
|
---|
798 |
|
---|
799 | Julian F. Reschke (editor)
|
---|
800 | greenbytes GmbH
|
---|
801 | Hafenweg 16
|
---|
802 | Muenster, NW 48155
|
---|
803 | Germany
|
---|
804 |
|
---|
805 | Phone: +49 251 2807760
|
---|
806 | Fax: +49 251 2807761
|
---|
807 | Email: julian.reschke@greenbytes.de
|
---|
808 | URI: http://greenbytes.de/tech/webdav/
|
---|
809 |
|
---|
810 |
|
---|
811 |
|
---|
812 |
|
---|
813 |
|
---|
814 |
|
---|
815 |
|
---|
816 |
|
---|
817 |
|
---|
818 |
|
---|
819 |
|
---|
820 |
|
---|
821 |
|
---|
822 |
|
---|
823 |
|
---|
824 |
|
---|
825 |
|
---|
826 |
|
---|
827 |
|
---|
828 |
|
---|
829 |
|
---|
830 |
|
---|
831 |
|
---|
832 |
|
---|
833 |
|
---|
834 |
|
---|
835 |
|
---|
836 |
|
---|
837 |
|
---|
838 |
|
---|
839 | Fielding, et al. Expires January 14, 2010 [Page 15]
|
---|
840 |
|
---|