ietf-corpus

rfc-7615

HTTP Authentication-Info and Proxy-Authentication-Info Response Header Fields

J. Reschke
date2015-09 streamIETF areawit wghttpbis statusPROPOSED STANDARD pages6 canonicalhttps://www.rfc-editor.org/rfc/rfc7615 doi10.17487/RFC7615
This specification defines the "Authentication-Info" and "Proxy- Authentication-Info" response header fields for use in Hypertext Transfer Protocol (HTTP) authentication schemes that need to return information once the client's authentication credentials have been accepted.

obsoleted by

obsoletes

Extracted elements (14)

design-rationale §3.1

For backwards compatibility, authentication scheme definitions can restrict senders to one of the two parameter value formats (token or quoted-string). This is important when deployed implementations are known to fail on one of the formats.

http

design-rationale §1

This specification generalizes Authentication-Info and Proxy-Authentication-Info from their original definition in RFC 2617 (Digest-only) so they can be used by any HTTP authentication scheme that needs to return information after credentials are accepted.

http

design-rationale §4

When multiple proxies are used within the same administrative domain (e.g., office and regional caching proxies in a corporate network), credentials generated by the user agent may be passed through the hierarchy, making Proxy-Authentication-Info appear to be forwarded as each proxy sends the same field value.

http

interoperability-note §1

This document obsoletes RFC 2617, extracting and generalizing the Authentication-Info and Proxy-Authentication-Info header field definitions previously scoped only to the HTTP Digest authentication scheme.

http

normative-requirement §3 MUST NOT

A proxy forwarding a response MUST NOT modify the Authentication-Info field value in any way.

http, security

normative-requirement §3 MAY

Authentication-Info can be used in any HTTP response independently of request method and status code; its semantics are defined by the authentication scheme indicated by the Authorization header field of the corresponding request.

http

normative-requirement §3 MAY

Authentication-Info MAY be used inside HTTP trailers when the authentication scheme explicitly allows this use.

http

normative-requirement §3.1 MUST

Authentication scheme definitions MUST allow both 'token' and 'quoted-string' notations for parameter values, for both senders and recipients, to allow use of generic parsing components.

http

normative-requirement §4 MUST NOT

Unlike Authentication-Info, the Proxy-Authentication-Info header field applies only to the next outbound client on the response chain, because only the client that chose a given proxy is likely to have the credentials necessary for authentication.

http

protocol-element §3

The Authentication-Info response header field communicates information after the client's authentication credentials have been accepted, including possible finalization messages such as server authentication. Its field value is a list of auth-param name/value pairs as defined in RFC 7235 Section 2.1.

http, security

protocol-element §4

The Proxy-Authentication-Info response header field is equivalent to Authentication-Info but applies to proxy authentication; its semantics are defined by the scheme indicated in the Proxy-Authorization header field of the corresponding request. Its ABNF is `Proxy-Authentication-Info = #auth-param`.

http, security

registry §6

This document updates the 'Permanent Message Header Field Names' registry within IANA's 'Message Headers' registry, registering 'Authentication-Info' (http, standard, Section 3) and 'Proxy-Authentication-Info' (http, standard, Section 4).

http, registry

security-consideration §5

Adding information to HTTP responses sent over an unencrypted channel can affect security and privacy. The presence of Authentication-Info or Proxy-Authentication-Info alone reveals that HTTP authentication is in use, and scheme-specific parameters may expose additional sensitive information.

http, security, privacy

wire-format §3

The Authentication-Info field value is defined as `Authentication-Info = #auth-param`, a comma-separated list of auth-param pairs using ABNF with the list extension from RFC 7230 Section 7.

http