November 2006

Interface ProxyAuthorizationHeader

All Superinterfaces:
AuthorizationHeader, java.lang.Cloneable, Header, Parameters, java.io.Serializable

public interface ProxyAuthorizationHeader
extends AuthorizationHeader

The Proxy-Authorization header field allows the client to identify itself (or its user) to a proxy that requires authentication. A Proxy-Authorization field value consists of credentials containing the authentication information of the user agent for the proxy and/or realm of the resource being requested.

This header field, along with Authorization, breaks the general rules about multiple header field names. Although not a comma-separated list, this header field name may be present multiple times, and MUST NOT be combined into a single header line.

An UAC sends a request to a proxy server containing a Proxy-Authorization header field, so that the proxy can authenticate the UAC before processing the request. A proxy can challenge for credentials by rejecting a request with a 407 (Proxy Authentication Required) status code upon which a UAC may provide credentials for the requested resource in the Proxy-Authorization header.

A Proxy-Authorization header field value applies only to the proxy whose realm is identified in the "realm" parameter. When multiple proxies are used in a chain, a Proxy-Authorization header field value MUST NOT be consumed by any proxy whose realm does not match the "realm" parameter specified in that value. Note that if an authentication scheme that does not support realms is used in the Proxy-Authorization header field, a proxy server MUST attempt to parse all Proxy-Authorization header field values to determine whether one of them has what the proxy server considers to be valid credentials.

Proxy-Authorization: Digest username="Alice", realm="atlanta.com", nonce="c60f3082ee1212b402a21831ae", response="245f23415f11432b3434341c022"

BEA Systems, NIST
See Also:
Parameters, ProxyAuthenticateHeader

Field Summary
static java.lang.String NAME
          Name of ProxyAuthorizationHeader
Method Summary
Methods inherited from interface javax.sip.header.AuthorizationHeader
getAlgorithm, getCNonce, getNonce, getNonceCount, getOpaque, getQop, getRealm, getResponse, getScheme, getURI, getUsername, setAlgorithm, setCNonce, setNonce, setNonceCount, setOpaque, setQop, setRealm, setResponse, setScheme, setURI, setUsername
Methods inherited from interface javax.sip.header.Parameters
getParameter, getParameterNames, removeParameter, setParameter
Methods inherited from interface javax.sip.header.Header
clone, equals, getName, hashCode, toString

Field Detail


static final java.lang.String NAME
Name of ProxyAuthorizationHeader

See Also:
Constant Field Values

November 2006

If you have any comments, please mail them to JAIN-SIP-INTEREST@java.sun.com after subscribing at http://archives.java.sun.com
Copyright - 2006 BEA Systems and Sun Microsystems