Specifying the URL¶

The simplest HTTP configuration block requires a single <url> child element:

<http>
  <url>http://server/path?key=value</url>
</http>

Timeouts¶

You may configure the timeouts after which an HTTP request is abandoned:

<http>
  <url>http://server/path?key=value</url>

  <!-- timeout in seconds to wait while establishing a connection. This may be needed for
  firewalled MapCache or HTTP instances -->
  <connection_timeout>30</connection_timeout>

  <!-- total maximum time allowed for the whole request. Includes the time needed to
 transfer data down the wire -->
  <timeout>60</timeout>
</http>

Authorization¶

To access resources protected by a username and password, provide the <auth> element. Currently, only basic authentication is supported. Given that usernames and passwords are stored in unencrypted form, exercise caution when handling the configuration file (e.g., avoid committing it to a public repository and set restrictive file access permissions). The same precautions should be taken with the memory of the mapcache process (e.g., core files).

<http>
  <url>http://example.com/path?key=value</url>
  <auth scheme="basic">
    <user>alice</user>
    <pass>attackatdawn</pass>
  </auth>
</http>

Both the username and password are processed verbatim. Ensure not to include any extra symbols (e.g., space, newline). If there is no username or no password, simply leave the respective element empty.

<http>
  <url>http://example.com/path?key=value</url>
  <auth scheme="basic">
    <user>bob</user>
    <pass></pass> <!-- user "bob" has no password -->
  </auth>
</http>