Index: authentication.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/xdocs/authentication.xml,v
retrieving revision 1.11
diff -u -r1.11 authentication.xml
--- authentication.xml 12 Jun 2004 22:47:23 -0000 1.11
+++ authentication.xml 28 Jun 2004 01:41:16 -0000
@@ -95,9 +95,7 @@
authentication with the exception that the credentials for each are
stored independantly. So for proxy authentication you must use
setProxyCredentials(AuthScope authscope, Credentials cred) and
- getProxyCredentials(AuthScope authscope). As with server
- authentication, passing null as the realm sets or returns
- the default credentials.
getProxyCredentials(AuthScope authscope).
For a detailed explanation of how NTLM authentication works, please see http://davenport.sourceforge.net/ntlm.html.
+ +Some servers support multiple schemes for authenticating users. + Given that only one scheme may be used at a time for authenticating, HttpClient + must choose which scheme to use. To accompish this, HttpClient uses an order of + preference to select the correct authentication scheme. By default + this order is: NTLM, Digest, Basic. +
+In certain cases it may be desirable to change this default. The + default preference of the authentication schemes may be altered using the + 'http.auth.scheme-priority' parameter. The parameter value is expected to be a List + of Strings containing names of authentication schemes in descending order of + preference. +
+