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).

@@ -176,6 +174,26 @@

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. +

+HttpClient client = new HttpClient(); +List authPrefs = new ArrayList(2); +authPrefs.add(AuthPolicy.DIGEST); +authPrefs.add(AuthPolicy.BASIC); +// This will exclude the NTLM authentication scheme +client.getParams().setParameter(AuthPolicy.AUTH_SCHEME_PRIORITY, authPrefs);