Settings the HTTP client uses for calls to a backend: socket timeouts, an upstream proxy, credentials, TLS and retry behavior. Every part is optional and falls back to its defaults when omitted. Configure it once globally, or on a single plugin that calls a backend.

Example Configuration

configuration:
   httpClientConfig:
     connection:
       timeout: 5000
     proxy:
       host: proxy.example.com
       port: 3128
     retries:
       retries: 3

configuration:
   httpClientConfig:
     connection:
       timeout: 5000
     proxy:
       host: proxy.example.com
       port: 3128
     retries:
       retries: 3

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>

Attributes

Name	Required	Default	Description	Examples
$ref	false	-	Reference a component defined under components.	-
adjustHostHeader	false	true	Rewrites the Host header to the address of the backend. Set to `false` to forward the Host header the client sent, e.g. when the backend serves virtual hosts under that name.	false
useExperimentalHttp2	false	false	Negotiates HTTP/2 over TLS when the backend offers it and falls back to HTTP/1.1 otherwise. Experimental.	true

Child Structure

Element	Cardinality	Description
authentication	0..1	Credentials sent as HTTP Basic Authentication with every outgoing request.
connection	0..1	Socket timeouts and the local network interface used for outgoing connections.
proxy	0..1	Upstream HTTP proxy that outgoing requests are routed through.
retries	0..1	Retries a request to the backend when the connection fails or the server answers with a status code that is worth another attempt. The initial call is followed by a configurable number of further attempts.
ssl	0..1	Configures inbound or outbound SSL connections.

Can be used in

acme azureTableStorage balancerHealthMonitor components configuration httpClient lokiExchangeStore registration router soapProxy sslProxy-routerIpResolver