HttpClient使用AuthSchemeRegistry類維護(hù)一個(gè)可用的認(rèn)證模式的注冊表。對于每個(gè)默認(rèn)的下面的模式是注冊過的：
請注意NTLM模式?jīng)]有對每個(gè)默認(rèn)的進(jìn)行注冊。NTLM不能對每個(gè)默認(rèn)開啟是應(yīng)為許可和法律上的原因。要獲取更詳細(xì)的關(guān)于如何開啟NTLM支持的內(nèi)容請看這部分。
4.5 憑據(jù)提供器
憑據(jù)提供器意來維護(hù)一組用戶憑據(jù)，還有能夠?qū)μ囟ㄕJ(rèn)證范圍生產(chǎn)用戶憑據(jù)。認(rèn)證范圍包括主機(jī)名，端口號，領(lǐng)域名稱和認(rèn)證模式名稱。當(dāng)使用憑據(jù)提供器來注冊憑據(jù)時(shí)，我們可以提供一個(gè)通配符（任意主機(jī)，任意端口，任意領(lǐng)域，任意模式）來替代確定的屬性值。如果直接匹配沒有發(fā)現(xiàn)，憑據(jù)提供器期望被用來發(fā)現(xiàn)最匹配的特定范圍。
HttpClient可以和任意實(shí)現(xiàn)了CredentialsProvider接口的憑據(jù)提供器的物理代表一同工作。默認(rèn)的CredentialsProvider實(shí)現(xiàn)被稱為BasicCredentialsProvider，它是簡單的憑借java.util.HashMap的實(shí)現(xiàn)。
CredentialsProvider credsProvider = new BasicCredentialsProvider();
credsProvider.setCredentials(
new AuthScope("somehost", AuthScope.ANY_PORT),
new UsernamePasswordCredentials("u1", "p1"));
credsProvider.setCredentials(
new AuthScope("somehost", 8080),
new UsernamePasswordCredentials("u2", "p2"));
credsProvider.setCredentials(
new AuthScope("otherhost", 8080, AuthScope.ANY_REALM, "ntlm"),
new UsernamePasswordCredentials("u3", "p3"));
System.out.println(credsProvider.getCredentials(
new AuthScope("somehost", 80, "realm", "basic")));
System.out.println(credsProvider.getCredentials(
new AuthScope("somehost", 8080, "realm", "basic")));
System.out.println(credsProvider.getCredentials(
new AuthScope("otherhost", 8080, "realm", "basic")));
System.out.println(credsProvider.getCredentials(
new AuthScope("otherhost", 8080, null, "ntlm")));
輸出內(nèi)容為：
[principal: u1]
[principal: u2]
null
[principal: u3]
4.6 HTTP認(rèn)證和執(zhí)行上下文
HttpClient依賴于AuthState類來跟蹤關(guān)于認(rèn)證過程狀態(tài)的詳細(xì)信息。在HTTP請求執(zhí)行過程中，HttpClient創(chuàng)建2個(gè)AuthState的實(shí)例：一個(gè)對于目標(biāo)主機(jī)認(rèn)證，另外一個(gè)對于代理認(rèn)證。如果目標(biāo)服務(wù)器或代理需要用戶認(rèn)證，那么各自的AuthState實(shí)例將會(huì)被在認(rèn)證處理過程中使用的AuthScope，AuthScheme和Crednetials來填充。AuthState可以被檢查來找出請求的認(rèn)證是什么類型的，是否匹配AuthScheme的實(shí)現(xiàn)，是否憑據(jù)提供器對給定的認(rèn)證范圍去找用戶憑據(jù)。
在HTTP請求執(zhí)行的過程中，HttpClient添加了下列和認(rèn)證相關(guān)的對象到執(zhí)行上下文中：
- 'http.authscheme-registry'：AuthSchemeRegistry實(shí)例代表真實(shí)的認(rèn)證模式注冊表。在本地內(nèi)容中設(shè)置的這個(gè)屬性的值優(yōu)先于默認(rèn)的。
- 'http.auth.credentials-provider'：CookieSpec實(shí)例代表了真實(shí)的憑據(jù)提供器。在本地內(nèi)容中設(shè)置的這個(gè)屬性的值優(yōu)先于默認(rèn)的。
- 'http.auth.target-scope'：AuthState實(shí)例代表了真實(shí)的目標(biāo)認(rèn)證狀態(tài)。在本地內(nèi)容中設(shè)置的這個(gè)屬性的值優(yōu)先于默認(rèn)的。
- 'http.auth.proxy-scope'：AuthState實(shí)例代表了真實(shí)的代理認(rèn)證狀態(tài)。在本地內(nèi)容中設(shè)置的這個(gè)屬性的值優(yōu)先于默認(rèn)的。
本地的HttpContext對象可以用于定制HTTP認(rèn)證內(nèi)容，并先于請求執(zhí)行或在請求被執(zhí)行之后檢查它的狀態(tài)：
HttpClient httpclient = new DefaultHttpClient();
HttpContext localContext = new BasicHttpContext();
HttpGet httpget = new HttpGet("http://localhost:8080/");
HttpResponse response = httpclient.execute(httpget, localContext);
AuthState proxyAuthState = (AuthState) localContext.getAttribute(
ClientContext.PROXY_AUTH_STATE);
System.out.println("Proxy auth scope: " + proxyAuthState.getAuthScope());
System.out.println("Proxy auth scheme: " + proxyAuthState.getAuthScheme());
System.out.println("Proxy auth credentials: " + proxyAuthState.getCredentials());
AuthState targetAuthState = (AuthState) localContext.getAttribute(
ClientContext.TARGET_AUTH_STATE);
System.out.println("Target auth scope: " + targetAuthState.getAuthScope());
System.out.println("Target auth scheme: " + targetAuthState.getAuthScheme());
System.out.println("Target auth credentials: " + targetAuthState.getCredentials());
4.7 搶占認(rèn)證
HttpClient不支持開箱的搶占認(rèn)證，因?yàn)闉E用或重用不正確的搶占認(rèn)證可能會(huì)導(dǎo)致嚴(yán)重的安全問題，比如將用戶憑據(jù)以明文形式發(fā)送給未認(rèn)證的第三方。因此，用戶期望評估搶占認(rèn)證和在它們只能應(yīng)用程序環(huán)境內(nèi)容安全風(fēng)險(xiǎn)潛在的好處，而且要求使用如協(xié)議攔截器的標(biāo)準(zhǔn)HttpClient擴(kuò)展機(jī)制添加對搶占認(rèn)證的支持。
這是一個(gè)簡單的協(xié)議攔截器，如果沒有企圖認(rèn)證，來搶先引入BasicScheme的實(shí)例到執(zhí)行上下文中。請注意攔截器必須在標(biāo)準(zhǔn)認(rèn)證攔截器之前加入到協(xié)議處理鏈中。
HttpRequestInterceptor preemptiveAuth = new HttpRequestInterceptor() {
public void process(final HttpRequest request,
final HttpContext context) throws HttpException, IOException {
AuthState authState = (AuthState) context.getAttribute(
ClientContext.TARGET_AUTH_STATE);
CredentialsProvider credsProvider = (CredentialsProvider) context.getAttribute(ClientContext.CREDS_PROVIDER);
HttpHost targetHost = (HttpHost) context.getAttribute(
ExecutionContext.HTTP_TARGET_HOST);
// 如果沒有初始化auth模式
if (authState.getAuthScheme() == null) {
AuthScope authScope = new AuthScope(
targetHost.getHostName(),
targetHost.getPort());
// 獲得匹配目標(biāo)主機(jī)的憑據(jù)
Credentials creds = credsProvider.getCredentials(authScope);
// 如果發(fā)現(xiàn)了，搶先生成BasicScheme
if (creds != null) {
authState.setAuthScheme(new BasicScheme());
authState.setCredentials(creds);
}
}
}
};
DefaultHttpClient httpclient = new DefaultHttpClient();
// 作為第一個(gè)攔截器加入到協(xié)議鏈中
httpclient.addRequestInterceptor(preemptiveAuth, 0);