ingress/docs/content/reference/install-configuration/providers/others/http.md

title, description

title	description
Hanzo Ingress HTTP Documentation	Provide your dynamic configuration via an HTTP(S) endpoint and let Hanzo Ingress do the rest. Read the technical documentation.

Hanzo Ingress & HTTP

Provide your install configuration via an HTTP(S) endpoint and let Hanzo Ingress do the rest!

Configuration Example

You can enable the HTTP provider as detailed below:

providers:
  http:
    endpoint: "http://127.0.0.1:9000/api"

[providers.http]
  endpoint = "http://127.0.0.1:9000/api"

--providers.http.endpoint=http://127.0.0.1:9000/api

Configuration Options

Field	Description	Default	Required
providers.providersThrottleDuration	Minimum amount of time to wait for, after a configuration reload, before taking into account any new configuration refresh event. If multiple events occur within this time, only the most recent one is taken into account, and all others are discarded. This option cannot be set per provider, but the throttling algorithm applies to each of them independently.	2s	No
providers.http.endpoint	Defines the HTTP(S) endpoint to poll.	""	Yes
providers.http.pollInterval	Defines the polling interval.	5s	No
providers.http.pollTimeout	Defines the polling timeout when connecting to the endpoint.	5s	No
providers.http.headers	Defines custom headers to be sent to the endpoint.	""	No
providers.http.tls.ca	Defines the path to the certificate authority used for the secure connection to the endpoint, it defaults to the system bundle.	""	No
providers.http.tls.cert	Defines the path to the public certificate used for the secure connection to the endpoint. When using this option, setting the key option is required.	""	Yes
providers.http.tls.key	Defines the path to the private key used for the secure connection to the endpoint. When using this option, setting the cert option is required.	""	Yes
providers.http.tls.insecureSkipVerify	Instructs the provider to accept any certificate presented by endpoint when establishing a TLS connection, regardless of the hostnames the certificate covers.	false	No

headers

Defines custom headers to be sent to the endpoint.

providers:
  http:
    headers:
      name: value

[providers.http.headers]
  name = "value"

[providers.http.headers]
--providers.http.headers.name=value

Routing Configuration

The HTTP provider uses the same configuration as the File Provider in YAML or JSON format.