Configuration container for Membrane's HTTP client. Allows defining proxy, connection, authentication, TLS, and retry behavior. Can be used as a reusable bean and referenced via <spring:bean>. Most of its sub-elements are optional.

httpClientConfig:
   adjustHostHeader: true
   connection:
     timeout: 10000
   proxy:
     host: proxy.example.com
     port: 3128
   authentication:
     type: basic
     user: user
     password: pass
   ssl:
     keystoreLocation: classpath:client.jks
     keystorePassword: secret

httpClientConfig:
   adjustHostHeader: true
   connection:
     timeout: 10000
   proxy:
     host: proxy.example.com
     port: 3128
   authentication:
     type: basic
     user: user
     password: pass
   ssl:
     keystoreLocation: classpath:client.jks
     keystorePassword: secret

Syntax

httpClientConfig:
  '$ref': <string>
  adjustHostHeader: <boolean>
  authentication: {}
  connection: {}
  proxy: {}
  retries: {}
  ssl: {}
  useExperimentalHttp2: <boolean>

httpClientConfig:
  '$ref': <string>
  adjustHostHeader: <boolean>
  authentication: {}
  connection: {}
  proxy: {}
  retries: {}
  ssl: {}
  useExperimentalHttp2: <boolean>

Sample

<httpClientConfig maxRetries="5" adjustHostHeader="true">
    <connection timeout="10000"/>
    <proxy host="proxy.example.com" port="3128"/>
    <authentication type="basic" user="user" password="pass"/>
    <ssl keystoreLocation="classpath:client.jks" keystorePassword="secret"/>
</httpClientConfig>

<httpClientConfig maxRetries="5" adjustHostHeader="true">
    <connection timeout="10000"/>
    <proxy host="proxy.example.com" port="3128"/>
    <authentication type="basic" user="user" password="pass"/>
    <ssl keystoreLocation="classpath:client.jks" keystorePassword="secret"/>
</httpClientConfig>

Attributes

Name	Required	Default	Description	Examples
$ref	false	-	Reference a component defined under components.	-
adjustHostHeader	false	true	Whether to automatically rewrite the Host header to match the target address. This is useful when routing requests to internal systems where the Host header must match the backend.	-
useExperimentalHttp2	false	false	Enables experimental support for HTTP/2. When true, HTTP/2 connections are attempted when possible.	-

Child Structure

Element	Cardinality	Description
authentication	0..1	Optional authentication mechanism (e.g., basic auth).
connection	0..1	Connection-related configuration such as timeouts and connection pooling. Cannot be null.
proxy-configuration	0..1	Optional proxy configuration for outbound connections.
retries	0..1
ssl	0..1	Configures inbound or outbound SSL connections.

Can be used in

acme azureTableStorage balancerHealthMonitor components httpClient registration router sslProxy-routerIpResolver