MetadataProviderHTTPAttributes

The following attributes are common to all HTTP metadata providers (i.e., DynamicHTTPMetadataProvider FileBackedHTTPMetadataProvider

An HTTP metadata provider includes a default implementation of an HttpClient to use. The attributes in the following subsections control the behavior of the default HTTP client. In most cases, the default behavior is sufficient.

To override the default client implementation, configure the following attribute:

Name	Type	Description

Name	Type	Description
httpClientRef	Bean ID	A reference to an externally defined Spring bean that specifies an HttpClient object. This attribute conflicts with and overrides all of the other HTTP attributes. See the HttpClientConfiguration topic for more information.

Use of the httpClientRef attribute precludes the use of any and all of the HTTP attributes in the following subsections.

The following attributes apply to the HTTP connections obtained and managed by an HTTP metadata provider:

Name	Type	Default	Description

Name	Type	Default	Description
connectionRequestTimeout	Duration	Depends on provider type	The maximum amount of time to wait for a connection to be returned from the HTTP client's connection pool manager. Set to `PT0S` to disable.
connectionTimeout	Duration	Depends on provider type	The maximum amount of time to wait to establish a connection with the remote server. Set to `PT0S` to disable.
socketTimeout	Duration	Depends on provider type	The maximum amount of time to wait between two consecutive packets while reading from the socket connected to the remote server. Set to `PT0S` to disable. NOTE: This is NOT an aggregate timeout on the whole request but merely between packets. For that responseTimeout is available, starting in 5.2.
responseTimeout ^5.2	Duration	Depends on provider type	The maximum amount of time to wait until a response from the remote server. Set to `PT0S` to disable.
requestTimeout ^5.2	Duration	Depends on provider type	The maximum allowed length of time for the entire request/response operation to complete.
requestTimeoutCorePoolSize ^5.2	Integer	20	The core pool size of the ScheduledExecutorService used to implement requestTimeout handling. This is the number of threads to keep in the pool, even if they are idle. The total number of threads in the pool is allowed to grow up to the max integer value.

The following security-related attributes apply to any HTTP metadata provider:

Name	Type	Default	Description

Name

Type

Default

Description

disregardTLSCertificate

Boolean

false

If true, no TLS certificate checking will take place over an HTTPS connection.

Be careful with this setting, it is typically only used during testing. See the HttpClientConfiguration topic for more information.

httpClientSecurityParametersRef

Bean ID

A reference to an externally defined Spring bean that specifies an HttpClientSecurityParameters instance, which consolidates all HTTP security parameters including advanced TLS usage.

In 5.0, this attribute conflicts with and overrides any explicit TrustEngine implementation configured as an inline <TLSTrustEngine> element. See the HttpClientConfiguration topic for more information.

In 5.1, if an inline trust engine is specified, it will be merged into any supplied instance.

The following attributes configure an HTTP proxy for use with an HTTP metadata provider:

Name	Type	Description

Name	Type	Description
proxyHost	String	The hostname of the HTTP proxy through which connections will be made
proxyPort	String	The port of the HTTP proxy through which connections will be made
proxyUser	String	The username used with the HTTP proxy through which connections will be made
proxyPassword	String	The password used with the HTTP proxy through which connections will be made