红帽全球峰会此内容没有您所选择的语言版本。
13.9.14. Configuring the HttpClient
You configure the HttpClient by specifying a set of properties. Here is an example configuration file:
- EasySSLProtocolSocketFactory can be used to create SSL connections that allow the target server to authenticate with a self-signed certificate.
- StrictSSLProtocolSocketFactory can be used to create SSL connections that can optionally perform host name verification in order to help preventing man-in-the-middle type of attacks.
- AuthSSLProtocolSocketFactory can be used to optionally enforce mutual client/server authentication. This is the most flexible implementation of a protocol socket factory. It allows for customization of most, if not all, aspects of the SSL authentication.
The only property that the HttpClientFactory requires is configurators, which specifies a comma-separated list of configurator implementations. Each configurator implementation configures different aspects of the HttpClient instance, extending the
org.jboss.soa.esb.http.Configurator class and providing a configure(HttpClient, Properties) method.
| Configurator | Description | Required |
|---|---|---|
| HttpProtocol |
Configure the HttpClient host, port and protocol information, including the socket factory and SSL keystore information.
| Yes |
| AuthBasic |
Configure HTTP Basic authentication for the HttpClient.
| No |
| AuthNTLM |
Configure NTLM authentication for the HttpClient.
| No |
Additional configurators can be created and configured by appending their class names to the list specified in the configurators property.
Configuration of the HTTP transport properties:
| Property | Description | Required |
|---|---|---|
| HttpProtocol |
Configure the HttpClient host, port and protocol information, including the socket factory and SSL keystore information.
| Yes |
| target-host-url |
Target URL for http/https endpoint
| Yes |
| https.proxyHost |
Proxy Host for https connections
| No |
| https.proxyPort |
Proxy Port for https connections, defaulting to port 443
| No |
| http.proxyHost |
Proxy Host for http connections
| No |
| http.proxyPort |
Proxy Port for http connections, defaulting to port 80
| No |
| protocol-socket-factory |
Override socket factory, implementing the
ProtocolSocketFactory or ProtocolSocketFactoryBuilder interface.
The default value for http is the httpclient
DefaultProtocolSocketFactory whereas the default value for https is the contributed StrictSSLProtocolSocketFactory.
There are two implementations of
ProtocolSocketFactoryBuilder provided in the ESB codebase, AuthSSLProtocolSocketFactoryBuilder and SelfSignedSSLProtocolSocketFactoryBuilder, for configuring the AuthSSLProtocolSocketFactory factory and self signed SSLContext respectively.
| No |
| keystore |
KeyStore location
| No |
| keystore-passw |
KeyStore password or encrypted file
| No |
| keystore-type |
KeyStore type, defaulting to jks
| No |
| truststore |
TrustStore location
| No |
| truststore-passw |
TrustStore password or encrypted file
| No |
| truststore-type |
TrustStore type, defaulting to jks
| No |
Configuration of the HTTP Basic Authentication properties:
| Property | Description | Required |
|---|---|---|
| auth-username |
Authentication Username
| Yes |
| auth-password |
Authentication Password
| Yes |
| authscope-host |
Authentication Scope Host
| Yes |
| authscope-port |
Authentication Scope Port
| Yes |
| authscope-domain |
Authentication Scope Domain
| Yes |
Configuration of the HTTP Basic Authentication NTLM properties:
| Property | Description | Required |
|---|---|---|
| ntauth-username |
Authentication Username
| Yes |
| ntauth-password |
Authentication Password
| Yes |
| ntauthscope-host |
Authentication Scope Host
| Yes |
| ntauthscope-port |
Authentication Scope Port
| Yes |
| ntauthscope-domain |
Authentication Scope Domain
| Yes |
| ntauthscope-realm |
Authentication Scope Realm
| No |
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}