Welcome > DNS Providers > HTTP request

HTTP request

Configuration for HTTP request.

Here is an example bash command using the HTTP request provider:

HTTPREQ_ENDPOINT=http://my.server.com:9090 \
lego --email you@example.com --dns httpreq --domains my.example.org run

Credentials

Environment Variable Name	Description
`HTTPREQ_ENDPOINT`	The URL of the server
`HTTPREQ_MODE`	`RAW`, none

The environment variable names can be suffixed by _FILE to reference a file instead of a value. More information here.

Environment Variable Name	Description
`HTTPREQ_HTTP_TIMEOUT`	API request timeout
`HTTPREQ_PASSWORD`	Basic authentication password
`HTTPREQ_POLLING_INTERVAL`	Time between DNS propagation check
`HTTPREQ_PROPAGATION_TIMEOUT`	Maximum waiting time for DNS propagation
`HTTPREQ_USERNAME`	Basic authentication username

The environment variable names can be suffixed by _FILE to reference a file instead of a value. More information here.

The server must provide:

The URL of the server must be define by HTTPREQ_ENDPOINT.

There are 2 modes (HTTPREQ_MODE):

{
  "fqdn": "_acme-challenge.domain.",
  "value": "LHDhK3oGRvkiefQnx7OOczTY5Tic_xZ6HcMOc_gmtoM"
}

{
  "domain": "domain",
  "token": "token",
  "keyAuth": "key"
}

Basic authentication (optional) can be set with some environment variables: