Index: authentication.xml =================================================================== RCS file: /home/cvspublic/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 23 Jun 2004 19:41:04 -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,23 @@

For a detailed explanation of how NTLM authentication works, please see http://davenport.sourceforge.net/ntlm.html.

+ + +

Per default HttpClient picks the authentication challenge in the following + order of priority: NTLM, Digest, Basic. In certain cases it may be desirable to + force the use of a weaker or a custom authentication scheme. +

+

The default priority order of the authentication schemes may be altered using + 'http.auth.scheme-priority' parameter. The parameter value is expected to be a List + of Strings containing names of authentication schemes with the most preferrable first + and the least preferrable one last. +

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