You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hc.apache.org by sv...@apache.org on 2021/02/19 13:00:58 UTC
svn commit: r1886691 [1/3] - in /httpcomponents/site: ./
httpcomponents-asyncclient-4.1.x/ httpcomponents-client-4.5.x/
httpcomponents-client-5.0.x/ httpcomponents-client-5.1.x/
httpcomponents-core-4.4.x/ httpcomponents-core-5.0.x/ httpcomponents-core-...
Author: svn-site-role
Date: Fri Feb 19 13:00:57 2021
New Revision: 1886691
URL: http://svn.apache.org/viewvc?rev=1886691&view=rev
Log:
Site checkin for project Apache HttpComponents WebSite
Removed:
httpcomponents/site/httpcomponents-client-5.1.x/android.html
httpcomponents/site/httpcomponents-client-5.1.x/logging.html
httpcomponents/site/httpcomponents-client-5.1.x/related-projects.html
httpcomponents/site/httpcomponents-core-5.1.x/related-projects.html
Modified:
httpcomponents/site/charter.html
httpcomponents/site/downloads.html
httpcomponents/site/get-involved.html
httpcomponents/site/httpcomponents-asyncclient-4.1.x/download.html
httpcomponents/site/httpcomponents-asyncclient-4.1.x/examples.html
httpcomponents/site/httpcomponents-asyncclient-4.1.x/index.html
httpcomponents/site/httpcomponents-asyncclient-4.1.x/quickstart.html
httpcomponents/site/httpcomponents-client-4.5.x/android.html
httpcomponents/site/httpcomponents-client-4.5.x/download.html
httpcomponents/site/httpcomponents-client-4.5.x/examples.html
httpcomponents/site/httpcomponents-client-4.5.x/index.html
httpcomponents/site/httpcomponents-client-4.5.x/logging.html
httpcomponents/site/httpcomponents-client-4.5.x/ntlm.html
httpcomponents/site/httpcomponents-client-4.5.x/primer.html
httpcomponents/site/httpcomponents-client-4.5.x/quickstart.html
httpcomponents/site/httpcomponents-client-5.0.x/android.html
httpcomponents/site/httpcomponents-client-5.0.x/download.html
httpcomponents/site/httpcomponents-client-5.0.x/examples-async.html
httpcomponents/site/httpcomponents-client-5.0.x/examples-reactive.html
httpcomponents/site/httpcomponents-client-5.0.x/examples.html
httpcomponents/site/httpcomponents-client-5.0.x/index.html
httpcomponents/site/httpcomponents-client-5.0.x/logging.html
httpcomponents/site/httpcomponents-client-5.0.x/quickstart.html
httpcomponents/site/httpcomponents-client-5.0.x/related-projects.html
httpcomponents/site/httpcomponents-client-5.1.x/download.html
httpcomponents/site/httpcomponents-client-5.1.x/examples-async.html
httpcomponents/site/httpcomponents-client-5.1.x/examples-reactive.html
httpcomponents/site/httpcomponents-client-5.1.x/examples.html
httpcomponents/site/httpcomponents-client-5.1.x/index.html
httpcomponents/site/httpcomponents-client-5.1.x/quickstart.html
httpcomponents/site/httpcomponents-core-4.4.x/download.html
httpcomponents/site/httpcomponents-core-4.4.x/examples.html
httpcomponents/site/httpcomponents-core-4.4.x/index.html
httpcomponents/site/httpcomponents-core-5.0.x/download.html
httpcomponents/site/httpcomponents-core-5.0.x/examples.html
httpcomponents/site/httpcomponents-core-5.0.x/index.html
httpcomponents/site/httpcomponents-core-5.0.x/related-projects.html
httpcomponents/site/httpcomponents-core-5.1.x/download.html
httpcomponents/site/httpcomponents-core-5.1.x/examples.html
httpcomponents/site/httpcomponents-core-5.1.x/index.html
httpcomponents/site/index.html
httpcomponents/site/licenses.html
httpcomponents/site/mail.html
httpcomponents/site/mailing-lists.html
httpcomponents/site/news.html
httpcomponents/site/project-info.html
httpcomponents/site/status.html
httpcomponents/site/team.html
Modified: httpcomponents/site/charter.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/charter.html?rev=1886691&r1=1886690&r2=1886691&view=diff
==============================================================================
--- httpcomponents/site/charter.html (original)
+++ httpcomponents/site/charter.html Fri Feb 19 13:00:57 2021
@@ -25,7 +25,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2021-02-15<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2021-02-19<span class="divider">|</span>
</li>
<li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
<li class="active ">Charter <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/markdown/charter.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li>
Modified: httpcomponents/site/downloads.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/downloads.html?rev=1886691&r1=1886690&r2=1886691&view=diff
==============================================================================
--- httpcomponents/site/downloads.html (original)
+++ httpcomponents/site/downloads.html Fri Feb 19 13:00:57 2021
@@ -25,7 +25,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2021-02-15<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2021-02-19<span class="divider">|</span>
</li>
<li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
<li class="active ">HttpComponents Downloads <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/xdoc/downloads.xml"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li>
Modified: httpcomponents/site/get-involved.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/get-involved.html?rev=1886691&r1=1886690&r2=1886691&view=diff
==============================================================================
--- httpcomponents/site/get-involved.html (original)
+++ httpcomponents/site/get-involved.html Fri Feb 19 13:00:57 2021
@@ -25,7 +25,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2021-02-15<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2021-02-19<span class="divider">|</span>
</li>
<li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
<li class="active ">Get Involved With HttpComponents <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/markdown/get-involved.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li>
Modified: httpcomponents/site/httpcomponents-asyncclient-4.1.x/download.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-asyncclient-4.1.x/download.html?rev=1886691&r1=1886690&r2=1886691&view=diff
==============================================================================
--- httpcomponents/site/httpcomponents-asyncclient-4.1.x/download.html (original)
+++ httpcomponents/site/httpcomponents-asyncclient-4.1.x/download.html Fri Feb 19 13:00:57 2021
@@ -25,7 +25,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2021-02-15<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2021-02-19<span class="divider">|</span>
</li>
<li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
<li class="active ">HttpAsyncClient Downloads <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/markdown/httpcomponents-asyncclient-4.1.x/download.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
Modified: httpcomponents/site/httpcomponents-asyncclient-4.1.x/examples.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-asyncclient-4.1.x/examples.html?rev=1886691&r1=1886690&r2=1886691&view=diff
==============================================================================
--- httpcomponents/site/httpcomponents-asyncclient-4.1.x/examples.html (original)
+++ httpcomponents/site/httpcomponents-asyncclient-4.1.x/examples.html Fri Feb 19 13:00:57 2021
@@ -25,7 +25,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2021-02-15<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2021-02-19<span class="divider">|</span>
</li>
<li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
<li class="active ">HttpAsyncClient Examples <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/markdown/httpcomponents-asyncclient-4.1.x/examples.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
Modified: httpcomponents/site/httpcomponents-asyncclient-4.1.x/index.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-asyncclient-4.1.x/index.html?rev=1886691&r1=1886690&r2=1886691&view=diff
==============================================================================
--- httpcomponents/site/httpcomponents-asyncclient-4.1.x/index.html (original)
+++ httpcomponents/site/httpcomponents-asyncclient-4.1.x/index.html Fri Feb 19 13:00:57 2021
@@ -25,7 +25,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2021-02-15<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2021-02-19<span class="divider">|</span>
</li>
<li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
<li class="active ">HttpAsyncClient Overview <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/markdown/httpcomponents-asyncclient-4.1.x/index.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
Modified: httpcomponents/site/httpcomponents-asyncclient-4.1.x/quickstart.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-asyncclient-4.1.x/quickstart.html?rev=1886691&r1=1886690&r2=1886691&view=diff
==============================================================================
--- httpcomponents/site/httpcomponents-asyncclient-4.1.x/quickstart.html (original)
+++ httpcomponents/site/httpcomponents-asyncclient-4.1.x/quickstart.html Fri Feb 19 13:00:57 2021
@@ -25,7 +25,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2021-02-15<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2021-02-19<span class="divider">|</span>
</li>
<li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
<li class="active ">HttpAsyncClient Quick Start <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/markdown/httpcomponents-asyncclient-4.1.x/quickstart.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
Modified: httpcomponents/site/httpcomponents-client-4.5.x/android.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-4.5.x/android.html?rev=1886691&r1=1886690&r2=1886691&view=diff
==============================================================================
--- httpcomponents/site/httpcomponents-client-4.5.x/android.html (original)
+++ httpcomponents/site/httpcomponents-client-4.5.x/android.html Fri Feb 19 13:00:57 2021
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/apt/httpcomponents-client-4.5.x/android.apt
+ | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/markdown/httpcomponents-client-4.5.x/android.md
| Rendered using Apache Maven Fluido Skin 1.9
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -25,10 +25,10 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2021-02-15<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2021-02-19<span class="divider">|</span>
</li>
<li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
- <li class="active ">HttpClient for Android <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/apt/httpcomponents-client-4.5.x/android.apt"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
+ <li class="active ">HttpClient for Android <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/markdown/httpcomponents-client-4.5.x/android.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
<li class="pull-right"><a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a></li>
</ul>
</div>
@@ -92,28 +92,64 @@
</div>
</header>
<main id="bodyColumn" class="span10" >
-<section>
-<h2><a name="HttpClient_for_Android"></a>HttpClient for Android</h2>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+<h1>HttpClient for Android</h1>
<p>Google Android 1.0 was released with a pre-BETA snapshot of Apache HttpClient. To coincide with the first Android release Apache HttpClient 4.0 APIs had to be frozen prematurely, while many of interfaces and internal structures were still not fully worked out. As Apache HttpClient 4.0 was maturing the project was expecting Google to incorporate the latest code improvements into their code tree. Unfortunately it did not happen. Version of Apache HttpClient shipped with Android has effectively become a fork.</p>
<p>Eventually Google decided to discontinue further development of their fork while refusing to upgrade to the stock version of Apache HttpClient citing compatibility concerns as a reason for such decision. Google completely removed their fork of Apache HttpClient from Android in version 8.0 (API 26) only.</p>
-<p>Those users who want to continue using Apache HttpClient on Android are advised to consider </p>
+<p>Those users who want to continue using Apache HttpClient on Android are advised to consider</p>
<ul>
-<li>Apache HttpCLient 5.x stock version, which works well with Android API 19 and newer
-<div>
-<pre>dependencies {
- compile group: 'org.apache.httpcomponents.client5' , name: 'httpclient5' , version: '5.0-beta4'
-}</pre></div></li>
-<li>Apache HttpClient packages for Android <a class="externalLink" href="https://github.com/smarek/httpclient-android/wiki/Project-Introduction"> maintained by Marek Sebera</a> when targeting Android API 23 and newer
-<div>
-<pre>dependencies {
+
+<li>
+
+<p><a href="../httpcomponents-client-ga">Apache HttpCLient 5.0</a> stock version, which works well with Android API 19 and newer</p>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">dependencies {
+ compile group: 'org.apache.httpcomponents.client5' , name: 'httpclient5' , version: '5.0.3'
+}
+</pre></div></div>
+</li>
+<li>
+
+<p>Apache HttpClient packages for Android <a class="externalLink" href="https://github.com/smarek/httpclient-android/wiki/Project-Introduction">maintained by Marek Sebera</a> when targeting Android API 23 and newer</p>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">dependencies {
compile group: 'cz.msebera.android' , name: 'httpclient', version: '4.5.3'
-}</pre></div></li>
-<li><a class="externalLink" href="https://ok2c.github.io/httpclient-android-ext/">Android extensions</a> for Apache HttpClient 4.5 when targeting Android API 26 or newer.
+}
+</pre></div></div>
+</li>
+<li>
+
+<p><a class="externalLink" href="https://ok2c.github.io/httpclient-android-ext/">Android extensions</a> for Apache HttpClient 4.5 when targeting Android API 26 or newer.</p>
+</li>
+</ul>
<p>Android extensions for Apache HttpClient provide a replacement for the default <code>HostnameVerifier</code> implementation incompatible with Android and provide a builder for <code>PoolingHttpClientConnectionManager</code> instances optimized for Android called <code>AndroidHttpClientConnectionManagerBuilder</code>.</p>
-<div>
-<pre>dependencies {
+
+<div class="source">
+<div class="source"><pre class="prettyprint">```
+dependencies {
api 'com.github.ok2c.hc4.android:httpclient-android:0.1.0'
-}</pre></div></li></ul></section>
+}
+```
+</pre></div></div>
</main>
</div>
</div>
Modified: httpcomponents/site/httpcomponents-client-4.5.x/download.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-4.5.x/download.html?rev=1886691&r1=1886690&r2=1886691&view=diff
==============================================================================
--- httpcomponents/site/httpcomponents-client-4.5.x/download.html (original)
+++ httpcomponents/site/httpcomponents-client-4.5.x/download.html Fri Feb 19 13:00:57 2021
@@ -25,7 +25,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2021-02-15<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2021-02-19<span class="divider">|</span>
</li>
<li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
<li class="active ">HttpClient Downloads <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/markdown/httpcomponents-client-4.5.x/download.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
Modified: httpcomponents/site/httpcomponents-client-4.5.x/examples.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-4.5.x/examples.html?rev=1886691&r1=1886690&r2=1886691&view=diff
==============================================================================
--- httpcomponents/site/httpcomponents-client-4.5.x/examples.html (original)
+++ httpcomponents/site/httpcomponents-client-4.5.x/examples.html Fri Feb 19 13:00:57 2021
@@ -25,7 +25,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2021-02-15<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2021-02-19<span class="divider">|</span>
</li>
<li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
<li class="active ">HttpClient Examples <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/markdown/httpcomponents-client-4.5.x/examples.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
Modified: httpcomponents/site/httpcomponents-client-4.5.x/index.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-4.5.x/index.html?rev=1886691&r1=1886690&r2=1886691&view=diff
==============================================================================
--- httpcomponents/site/httpcomponents-client-4.5.x/index.html (original)
+++ httpcomponents/site/httpcomponents-client-4.5.x/index.html Fri Feb 19 13:00:57 2021
@@ -25,7 +25,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2021-02-15<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2021-02-19<span class="divider">|</span>
</li>
<li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
<li class="active ">HttpClient Overview <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/markdown/httpcomponents-client-4.5.x/index.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
Modified: httpcomponents/site/httpcomponents-client-4.5.x/logging.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-4.5.x/logging.html?rev=1886691&r1=1886690&r2=1886691&view=diff
==============================================================================
--- httpcomponents/site/httpcomponents-client-4.5.x/logging.html (original)
+++ httpcomponents/site/httpcomponents-client-4.5.x/logging.html Fri Feb 19 13:00:57 2021
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/apt/httpcomponents-client-4.5.x/logging.apt
+ | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/markdown/httpcomponents-client-4.5.x/logging.md
| Rendered using Apache Maven Fluido Skin 1.9
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -8,7 +8,7 @@
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
- <title>Apache HttpComponents – HttpClient Logging Practices</title>
+ <title>Apache HttpComponents – Logging Practices</title>
<link rel="stylesheet" href="../css/apache-maven-fluido-1.9.min.css" />
<link rel="stylesheet" href="../css/site.css" />
<link rel="stylesheet" href="../css/print.css" media="print" />
@@ -25,10 +25,10 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2021-02-15<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2021-02-19<span class="divider">|</span>
</li>
<li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
- <li class="active ">HttpClient Logging Practices <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/apt/httpcomponents-client-4.5.x/logging.apt"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
+ <li class="active ">Logging Practices <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/markdown/httpcomponents-client-4.5.x/logging.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
<li class="pull-right"><a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a></li>
</ul>
</div>
@@ -92,84 +92,156 @@
</div>
</header>
<main id="bodyColumn" class="span10" >
-<section>
-<h2><a name="Logging_Practices"></a>Logging Practices</h2>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+<h1>Logging Practices</h1>
<p>Being a library HttpClient is not to dictate which logging framework the user has to use. Therefore HttpClient utilizes the logging interface provided by the <a class="externalLink" href="http://commons.apache.org/logging/">Commons Logging</a> package. <code>Commons Logging</code> provides a simple and generalized <a class="externalLink" href="http://commons.apache.org/logging/commons-logging-1.0.4/docs/apidocs/">log interface</a> to various logging packages. By using <code>Commons Logging</code>, HttpClient can be configured for a variety of different logging behaviours. That means the user will have to make a choice which logging framework to use. By default <code>Commons Logging</code> supports the following logging frameworks:</p>
<ul>
-<li><a class="externalLink" href="http://logging.apache.org/log4j/docs/index.html">Log4J</a></li>
-<li><a class="externalLink" href="http://docs.oracle.com/javase/7/docs/api/java/util/logging/package-summary.html"> java.util.logging</a></li>
-<li><a class="externalLink" href="http://commons.apache.org/logging/commons-logging-1.0.4/docs/apidocs/org/apache/commons/logging/impl/SimpleLog.html"> SimpleLog</a> (internal to <code>Commons Logging</code>)
+
+<li>
+
+<p><a class="externalLink" href="http://logging.apache.org/log4j/docs/index.html">Log4J</a></p>
+</li>
+<li>
+
+<p><a class="externalLink" href="http://docs.oracle.com/javase/7/docs/api/java/util/logging/package-summary.html">java.util.logging</a></p>
+</li>
+<li>
+
+<p><a class="externalLink" href="http://commons.apache.org/logging/commons-logging-1.0.4/docs/apidocs/org/apache/commons/logging/impl/SimpleLog.html">SimpleLog</a> ( internal to <code>Commons Logging</code>)</p>
+</li>
+</ul>
<p>By implementing some simple interfaces <code>Commons Logging</code> can be extended to support basically any other custom logging framework. <code>Commons Logging</code> tries to automatically discover the logging framework to use. If it fails to select the expected one, you must configure <code>Commons Logging</code> by hand. Please refer to the <code>Commons Logging</code> documentation for more information.</p>
-<p>HttpClient performs three different kinds of logging: the standard context logging used within each class, HTTP header logging and full wire logging. </p></li></ul><section>
-<h3><a name="Context_Logging">Context Logging</a></h3>
-<p>Context logging contains information about the internal operation of HttpClient as it performs HTTP requests. Each class has its own log named according to the class's fully qualified name. For example the class <code>DefaultHttpClient</code> has a log named <code>org.apache.http.impl.client.DefaultHttpClient</code>. Since all classes follow this convention it is possible to configure context logging for all classes using the single log named <code>org.apache.http.impl.client</code>.</p></section><section>
-<h3><a name="Wire_Logging">Wire Logging</a></h3>
+<p>HttpClient performs three different kinds of logging: the standard context logging used within each class, HTTP header logging and full wire logging.</p><section><section>
+<h3><a name="Context_Logging"></a>Context Logging</h3>
+<p>Context logging contains information about the internal operation of HttpClient as it performs HTTP requests. Each class has its own log named according to the class’s fully qualified name. For example the class <code>DefaultHttpClient</code> has a log named <code>org.apache.http.impl.client.DefaultHttpClient</code>. Since all classes follow this convention it is possible to configure context logging for all classes using the single log named <code>org.apache.http.impl.client</code>.</p></section><section>
+<h3><a name="Wire_Logging"></a>Wire Logging</h3>
<p>The wire log is used to log all data transmitted to and from servers when executing HTTP requests. The wire log uses the <code>org.apache.http.wire</code> logging category. This log should only be enabled to debug problems, as it will produce an extremely large amount of log data.</p></section><section>
-<h3><a name="HTTP_header_Logging">HTTP header Logging</a></h3>
+<h3><a name="HTTP_header_Logging"></a>HTTP header Logging</h3>
<p>Because the content of HTTP requests is usually less important for debugging than the HTTP headers, the <code>org.apache.http.headers</code> logging category for capturing HTTP headers only.</p></section><section>
-<h3><a name="Configuration_Examples">Configuration Examples</a></h3>
-<p><code>Commons Logging</code> can delegate to a variety of loggers for processing the actual output. Below are configuration examples for <code>Commons Logging</code>, <code>Log4j</code> and <code>java.util.logging</code>.</p><section>
-<h4><a name="Commons_Logging_Examples">Commons Logging Examples</a></h4>
-<p><code>Commons Logging</code> comes with a basic logger called <code>SimpleLog</code>. This logger writes all logged messages to <code>System.err</code>. The following examples show how to configure <code>Commons Logging</code> via system properties to use <code>SimpleLog</code>. It is strongly recommended to configure <code>Commons Logging</code> system properties through JVM process arguments at the start up.</p>
-<ul>
-<li>Enable header wire + context logging - <b>Best for Debugging</b>
-<div>
-<pre>-Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.SimpleLog
+<h3><a name="Configuration_Examples"></a>Configuration Examples</h3>
+<p><code>Commons Logging</code> can delegate to a variety of loggers for processing the actual output. Below are configuration examples for <code>Commons Logging</code>, <code>Log4j</code> and <code>java.util.logging</code>.</p></section></section><section>
+<h2><a name="Commons_Logging_Examples"></a>Commons Logging Examples</h2>
+<p><code>Commons Logging</code> comes with a basic logger called <code>SimpleLog</code>. This logger writes all logged messages to <code>System.err</code>. The following examples show how to configure <code>Commons Logging</code> via system properties to use <code>SimpleLog</code>. It is strongly recommended configuring <code>Commons Logging</code> system properties through JVM process arguments at the start up.</p>
+<ul>
+
+<li>Enable header wire + context logging - «Best for Debugging»</li>
+</ul>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">-Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.SimpleLog
-Dorg.apache.commons.logging.simplelog.showdatetime=true
-Dorg.apache.commons.logging.simplelog.log.org.apache.http=DEBUG
--Dorg.apache.commons.logging.simplelog.log.org.apache.http.wire=ERROR</pre></div></li>
-<li>Enable full wire + context logging
-<div>
-<pre>-Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.SimpleLog
+-Dorg.apache.commons.logging.simplelog.log.org.apache.http.wire=ERROR
+</pre></div></div>
+
+<ul>
+
+<li>Enable full wire + context logging</li>
+</ul>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">-Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.SimpleLog
-Dorg.apache.commons.logging.simplelog.showdatetime=true
--Dorg.apache.commons.logging.simplelog.log.org.apache.http=DEBUG</pre></div></li>
-<li>Enable context logging for connection management
-<div>
-<pre>-Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.SimpleLog
+-Dorg.apache.commons.logging.simplelog.log.org.apache.http=DEBUG
+</pre></div></div>
+
+<ul>
+
+<li>Enable context logging for connection management</li>
+</ul>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">-Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.SimpleLog
-Dorg.apache.commons.logging.simplelog.showdatetime=true
--Dorg.apache.commons.logging.simplelog.log.org.apache.http.impl.conn=DEBUG</pre></div></li>
-<li>Enable context logging for connection management / request execution
-<div>
-<pre>-Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.SimpleLog
+-Dorg.apache.commons.logging.simplelog.log.org.apache.http.impl.conn=DEBUG
+</pre></div></div>
+
+<ul>
+
+<li>Enable context logging for connection management / request execution</li>
+</ul>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">-Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.SimpleLog
-Dorg.apache.commons.logging.simplelog.showdatetime=true
-Dorg.apache.commons.logging.simplelog.log.org.apache.http.impl.conn=DEBUG
-Dorg.apache.commons.logging.simplelog.log.org.apache.http.impl.client=DEBUG
--Dorg.apache.commons.logging.simplelog.log.org.apache.http.client=DEBUG</pre></div></li></ul></section><section>
-<h4><a name="Log4j_Examples">Log4j Examples</a></h4>
-<p>The simplest way to configure <code>Log4j</code> is via a <code>log4j.properties</code> file. <code>Log4j</code> will automatically read and configure itself using a file named <code>log4j.properties</code> when it's present at the root of the application classpath. Below are some <code>Log4j</code> configuration examples.</p>
-<p><b>Note:</b> <code>Log4j</code> is not included in the <code>HttpClient</code> distribution. </p>
-<ul>
-<li>Enable header wire + context logging - <b>Best for Debugging</b>
-<div>
-<pre>log4j.rootLogger=INFO, stdout
+-Dorg.apache.commons.logging.simplelog.log.org.apache.http.client=DEBUG
+</pre></div></div>
+</section><section>
+<h2><a name="Log4j_Examples"></a>Log4j Examples</h2>
+<p>The simplest way to configure <code>Log4j</code> is via a <code>log4j.properties</code> file. <code>Log4j</code> will automatically read and configure itself using a file named <code>log4j.properties</code> when it’s present at the root of the application classpath. Below are some <code>Log4j</code> configuration examples.</p>
+<p><b>Note:</b> <code>Log4j</code> is not included in the <code>HttpClient</code> distribution.</p>
+<ul>
+
+<li>Enable header wire + context logging - <b>Best for Debugging</b></li>
+</ul>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">log4j.rootLogger=INFO, stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%c] %m%n
log4j.logger.org.apache.http=DEBUG
-log4j.logger.org.apache.http.wire=ERROR</pre></div></li>
-<li>Enable full wire + context logging
-<div>
-<pre>log4j.rootLogger=INFO, stdout
+log4j.logger.org.apache.http.wire=ERROR
+</pre></div></div>
+
+<ul>
+
+<li>Enable full wire + context logging</li>
+</ul>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">log4j.rootLogger=INFO, stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%c] %m%n
-log4j.logger.org.apache.http=DEBUG</pre></div></li>
-<li>Enable context logging for connection management
-<div>
-<pre>log4j.rootLogger=INFO, stdout
+log4j.logger.org.apache.http=DEBUG
+</pre></div></div>
+
+<ul>
+
+<li>Enable context logging for connection management</li>
+</ul>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">log4j.rootLogger=INFO, stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%c] %m%n
-log4j.logger.org.apache.http.impl.conn=DEBUG</pre></div></li>
-<li>Enable context logging for connection management / request execution
-<div>
-<pre>log4j.rootLogger=INFO, stdout
+log4j.logger.org.apache.http.impl.conn=DEBUG
+</pre></div></div>
+
+<ul>
+
+<li>Enable context logging for connection management / request execution</li>
+</ul>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">log4j.rootLogger=INFO, stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
@@ -177,12 +249,15 @@ log4j.appender.stdout.layout.ConversionP
log4j.logger.org.apache.http.impl.conn=DEBUG
log4j.logger.org.apache.http.impl.client=DEBUG
-log4j.logger.org.apache.http.client=DEBUG</pre></div></li></ul>
-<p>Note that the default configuration for Log4J is very inefficient as it causes all the logging information to be generated but not actually sent anywhere. The <code>Log4J</code> manual is the best reference for how to configure <code>Log4J</code>. It is available at <a class="externalLink" href="http://logging.apache.org/log4j/docs/manual.html"> http://logging.apache.org/log4j/docs/manual.html</a>.</p></section><section>
-<h4><a name="java.util.logging_Examples">java.util.logging Examples</a></h4>
-<p>Since JDK 1.4 there has been a package <a class="externalLink" href="http://docs.oracle.com/javase/7/docs/api/java/util/logging/package-summary.html"> java.util.logging</a> that provides a logging framework similar to <code>Log4J</code>. By default it reads a config file from <code>$JAVA_HOME/jre/lib/logging.properties</code> which looks like this (comments stripped):</p>
-<div>
-<pre>handlers=java.util.logging.ConsoleHandler
+log4j.logger.org.apache.http.client=DEBUG
+</pre></div></div>
+
+<p>Note that the default configuration for Log4J is very inefficient as it causes all the logging information to be generated but not actually sent anywhere. The <code>Log4J</code> manual is the best reference for how to configure <code>Log4J</code>. It is available at <a class="externalLink" href="http://logging.apache.org/log4j/docs/manual.html">http://logging.apache.org/log4j/docs/manual.html</a> .</p><section>
+<h3><a name="java.util.logging_Examples"></a>java.util.logging Examples</h3>
+<p>Since JDK 1.4 there has been a package <a class="externalLink" href="http://docs.oracle.com/javase/7/docs/api/java/util/logging/package-summary.html">java.util.logging</a> that provides a logging framework similar to <code>Log4J</code>. By default it reads a config file from <code>$JAVA_HOME/jre/lib/logging.properties</code> which looks like this (comments stripped):</p>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">handlers=java.util.logging.ConsoleHandler
.level=INFO
java.util.logging.FileHandler.pattern = %h/java%u.log
java.util.logging.FileHandler.limit = 50000
@@ -190,44 +265,70 @@ java.util.logging.FileHandler.count = 1
java.util.logging.FileHandler.formatter = java.util.logging.XMLFormatter
java.util.logging.ConsoleHandler.level = INFO
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
-com.xyz.foo.level = SEVERE</pre></div>
-<p>To customize logging a custom <code>logging.properties</code> file should be created in the project directory. The location of this file must be passed to the JVM as asystem property. This can be done on the command line like so:</p>
-<div>
-<pre>$JAVA_HOME/java -Djava.util.logging.config.file=$HOME/myapp/logging.properties
--classpath $HOME/myapp/target/classes com.myapp.Main</pre></div>
-<p>Alternatively <a class="externalLink" href="http://docs.oracle.com/javase/7/docs/api/java/util/logging/LogManager.html#readConfiguration(java.io.InputStream)""> LogManager#readConfiguration(InputStream)</a> can be used to pass it the desired configuration.</p>
-<ul>
-<li>Enable header wire + context logging - <b>Best for Debugging</b>
-<div>
-<pre>.level = INFO
+com.xyz.foo.level = SEVERE
+</pre></div></div>
+
+<p>To customize logging a custom <code>logging.properties</code> file should be created in the project directory. The location of this file must be passed to the JVM as a system property. This can be done on the command line like so:</p>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">$JAVA_HOME/java -Djava.util.logging.config.file=$HOME/myapp/logging.properties
+-classpath $HOME/myapp/target/classes com.myapp.Main
+</pre></div></div>
+
+<p>Alternatively <a class="externalLink" href="http://docs.oracle.com/javase/7/docs/api/java/util/logging/LogManager.html#readConfiguration(java.io.InputStream)">LogManager#readConfiguration(InputStream)</a> can be used to pass it the desired configuration.</p>
+<ul>
+
+<li>Enable header wire + context logging - <b>Best for Debugging</b></li>
+</ul>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">.level = INFO
handlers=java.util.logging.ConsoleHandler
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
java.util.logging.ConsoleHandler.level = ALL
org.apache.http.level = FINEST
-org.apache.http.wire.level = SEVERE</pre></div></li>
-<li>Enable full wire + context logging
-<div>
-<pre>.level = INFO
+org.apache.http.wire.level = SEVERE
+</pre></div></div>
+
+<ul>
+
+<li>Enable full wire + context logging</li>
+</ul>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">.level = INFO
handlers=java.util.logging.ConsoleHandler
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
java.util.logging.ConsoleHandler.level = ALL
-org.apache.http.level = FINEST</pre></div></li>
-<li>Enable context logging for connection management
-<div>
-<pre>.level = INFO
+org.apache.http.level = FINEST
+</pre></div></div>
+
+<ul>
+
+<li>Enable context logging for connection management</li>
+</ul>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">.level = INFO
handlers=java.util.logging.ConsoleHandler
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
java.util.logging.ConsoleHandler.level = ALL
-org.apache.http.impl.conn.level = FINEST</pre></div></li>
-<li>Enable context logging for connection management / request execution
-<div>
-<pre>.level = INFO
+org.apache.http.impl.conn.level = FINEST
+</pre></div></div>
+
+<ul>
+
+<li>Enable context logging for connection management / request execution</li>
+</ul>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">.level = INFO
handlers=java.util.logging.ConsoleHandler
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
@@ -235,8 +336,10 @@ java.util.logging.ConsoleHandler.level =
org.apache.http.impl.conn.level = FINEST
org.apache.http.impl.client.level = FINEST
-org.apache.http.client.level = FINEST</pre></div></li></ul>
-<p>More detailed information is available from the <a class="externalLink" href="http://docs.oracle.com/javase/7/docs/technotes/guides/logging/overview.html"> Java Logging documentation</a>.</p></section></section></section>
+org.apache.http.client.level = FINEST
+</pre></div></div>
+
+<p>More detailed information is available from the <a class="externalLink" href="http://docs.oracle.com/javase/7/docs/technotes/guides/logging/overview.html">Java Logging documentation</a>.</p></section></section>
</main>
</div>
</div>
Modified: httpcomponents/site/httpcomponents-client-4.5.x/ntlm.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-4.5.x/ntlm.html?rev=1886691&r1=1886690&r2=1886691&view=diff
==============================================================================
--- httpcomponents/site/httpcomponents-client-4.5.x/ntlm.html (original)
+++ httpcomponents/site/httpcomponents-client-4.5.x/ntlm.html Fri Feb 19 13:00:57 2021
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/apt/httpcomponents-client-4.5.x/ntlm.apt
+ | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/markdown/httpcomponents-client-4.5.x/ntlm.md
| Rendered using Apache Maven Fluido Skin 1.9
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -25,10 +25,10 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2021-02-15<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2021-02-19<span class="divider">|</span>
</li>
<li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
- <li class="active ">NTLM support in HttpClient <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/apt/httpcomponents-client-4.5.x/ntlm.apt"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
+ <li class="active ">NTLM support in HttpClient <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/markdown/httpcomponents-client-4.5.x/ntlm.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
<li class="pull-right"><a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a></li>
</ul>
</div>
@@ -92,27 +92,64 @@
</div>
</header>
<main id="bodyColumn" class="span10" >
-<section>
-<h2><a name="NTLM_support_in_HttpClient"></a>NTLM support in HttpClient</h2><section>
-<h3><a name="Background">Background</a></h3>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+<h1>NTLM support in HttpClient</h1><section>
+<h2><a name="Background"></a>Background</h2>
<p>NTLM is a proprietary authentication scheme developed by Microsoft and optimized for Windows operating system.</p>
<p>Until year 2008 there was no official, publicly available, complete documentation of the protocol. <a class="externalLink" href="http://davenport.sourceforge.net/ntlm.html">Unofficial</a> 3rd party protocol descriptions existed as a result of reverse-engineering efforts. It was not really known whether the protocol based on the reverse-engineering were complete or even correct.</p>
-<p>Microsoft published <a class="externalLink" href="http://download.microsoft.com/download/a/e/6/ae6e4142-aa58-45c6-8dcf-a657e5900cd3/%5BMS-NLMP%5D.pdf">MS-NLMP</a> and <a class="externalLink" href="http://download.microsoft.com/download/a/e/6/ae6e4142-aa58-45c6-8dcf-a657e5900cd3/%5BMS-NTHT%5D.pdf">MS-NTHT</a> specifications in February 2008 as a part of its <a class="externalLink" href="http://www.microsoft.com/interop/principles/default.mspx">Interoperability Principles initiative</a>. </p>
-<p>HttpClient as of version 4.1 initially supported NTLMv1, NTLMv2, and NTLM2SessionResponse authentication protocols, based on the reverse engineering approach. As of version 4.2.3, HttpClient now supports a more correct implementation, based in large part on Microsoft's own specifications. This is expected to correct a number of problems, especially since Microsoft (as of Windows Server 2008 R2) began using a new implementation of its protocols. This new Microsoft implementation has led to authentication failures in some cases from some of the older reverse-engineered client implementations of NTLM.</p>
+<p>Microsoft published <a class="externalLink" href="http://download.microsoft.com/download/a/e/6/ae6e4142-aa58-45c6-8dcf-a657e5900cd3/%5BMS-NLMP%5D.pdf">MS-NLMP</a> and <a class="externalLink" href="http://download.microsoft.com/download/a/e/6/ae6e4142-aa58-45c6-8dcf-a657e5900cd3/%5BMS-NTHT%5D.pdf">MS-NTHT</a> specifications in February 2008 as a part of its <a class="externalLink" href="http://www.microsoft.com/interop/principles/default.mspx">Interoperability Principles initiative</a>.</p>
+<p>HttpClient as of version 4.1 initially supported NTLMv1, NTLMv2, and NTLM2SessionResponse authentication protocols, based on the reverse engineering approach. As of version 4.2.3, HttpClient now supports a more correct implementation, based in large part on Microsoft’s own specifications. This is expected to correct a number of problems, especially since Microsoft (as of Windows Server 2008 R2) began using a new implementation of its protocols. This new Microsoft implementation has led to authentication failures in some cases from some of the older reverse-engineered client implementations of NTLM.</p>
<p>The new HttpClient NTLM implementation is known to have been tried successfully against at least the following systems:</p>
<ul>
-<li>Windows Server 2000 and Server 2003 systems, configured to use LM and NTLMv1 authentication</li>
-<li>Windows Server 2003 systems, configured to use NTLMv2 authentication</li>
-<li>Windows Server 2008 R2 systems, configured to use NTLM2SessionResponse authentication</li></ul>
-<p>If the current HttpClient NTLM implementation should prove problematic in your environment, we'd definitely like to hear about it. You are also welcome to try an alternative NTLM implementation, should it seem necessary. One can also use <a class="externalLink" href="http://jcifs.samba.org/">JCIFS</a>, which includes an NTLM engine developed by members of the Samba project. </p></section><section>
-<h3><a name="Using_Samba_JCIFS_as_an_alternative_NTLM_engine">Using Samba JCIFS as an alternative NTLM engine</a></h3>
+
+<li>
+
+<p>Windows Server 2000 and Server 2003 systems, configured to use LM and NTLMv1 authentication</p>
+</li>
+<li>
+
+<p>Windows Server 2003 systems, configured to use NTLMv2 authentication</p>
+</li>
+<li>
+
+<p>Windows Server 2008 R2 systems, configured to use NTLM2SessionResponse authentication</p>
+</li>
+</ul>
+<p>If the current HttpClient NTLM implementation should prove problematic in your environment, we’d definitely like to hear about it. You are also welcome to try an alternative NTLM implementation, should it seem necessary. One can also use <a class="externalLink" href="http://jcifs.samba.org/">JCIFS</a>, which includes an NTLM engine developed by members of the Samba project.</p></section><section>
+<h2><a name="Using_Samba_JCIFS_as_an_alternative_NTLM_engine"></a>Using Samba JCIFS as an alternative NTLM engine</h2>
<p>Follow these instructions to build an NTLMEngine implementation using JCIFS library</p>
-<p><b>Disclaimer: Use code at your own discretion. Do NOT report any issues related to the use of JCIFS library to Apache HttpComponents project</b>.</p>
+<p><b><i>Disclaimer: Use code at your own discretion. Do NOT report any issues related to the use of JCIFS library to Apache HttpComponents project</i></b>.</p>
<ul>
-<li>Download version 1.3.14 or newer of the JCIFS library from the <a class="externalLink" href="http://jcifs.samba.org/">Samba</a> web site</li>
-<li>Implement NTLMEngine interface
-<div>
-<pre>import java.io.IOException;
+
+<li>
+
+<p>Download version 1.3.14 or newer of the JCIFS library from the <a class="externalLink" href="http://jcifs.samba.org/">Samba</a> web site</p>
+</li>
+<li>
+
+<p>Implement NTLMEngine interface</p>
+</li>
+</ul>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">import java.io.IOException;
import jcifs.ntlmssp.NtlmFlags;
import jcifs.ntlmssp.Type1Message;
@@ -155,28 +192,45 @@ public final class JCIFSEngine implement
return Base64.encode(type3Message.toByteArray());
}
-}</pre></div></li>
-<li>Implement AuthSchemeProvider interface
-<div>
-<pre>public class JCIFSNTLMSchemeFactory implements AuthSchemeProvider {
+}
+</pre></div></div>
+
+<ul>
+
+<li>Implement AuthSchemeProvider interface</li>
+</ul>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">public class JCIFSNTLMSchemeFactory implements AuthSchemeProvider {
public AuthScheme create(final HttpContext context) {
return new NTLMScheme(new JCIFSEngine());
}
-}</pre></div></li>
-<li>Register NTLMSchemeFactory with the HttpClient instance you want to NTLM enable.
-<div>
-<pre>Registry<AuthSchemeProvider> authSchemeRegistry = RegistryBuilder.<AuthSchemeProvider>create()
- .register(AuthSchemes.NTLM, new JCIFSNTLMSchemeFactory())
- .register(AuthSchemes.BASIC, new BasicSchemeFactory())
- .register(AuthSchemes.DIGEST, new DigestSchemeFactory())
- .register(AuthSchemes.SPNEGO, new SPNegoSchemeFactory())
- .register(AuthSchemes.KERBEROS, new KerberosSchemeFactory())
- .build();
+}
+</pre></div></div>
+
+<ul>
+
+<li>Register NTLMSchemeFactory with the HttpClient instance you want to NTLM enable.</li>
+</ul>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">Registry<AuthSchemeProvider> authSchemeRegistry = RegistryBuilder.<AuthSchemeProvider>create()
+ .register(AuthSchemes.NTLM, new JCIFSNTLMSchemeFactory())
+ .register(AuthSchemes.BASIC, new BasicSchemeFactory())
+ .register(AuthSchemes.DIGEST, new DigestSchemeFactory())
+ .register(AuthSchemes.SPNEGO, new SPNegoSchemeFactory())
+ .register(AuthSchemes.KERBEROS, new KerberosSchemeFactory())
+ .build();
CloseableHttpClient httpClient = HttpClients.custom()
- .setDefaultAuthSchemeRegistry(authSchemeRegistry)
- .build();</pre></div></li>
-<li>Set NTCredentials for the web server you are going to access.</li></ul></section></section>
+ .setDefaultAuthSchemeRegistry(authSchemeRegistry)
+ .build();
+</pre></div></div>
+
+<ul>
+
+<li>Set NTCredentials for the web server you are going to access.</li>
+</ul></section>
</main>
</div>
</div>