Request Header Literal

Category: Request

Purpose: Identifies requests by whether they contain a request header set to a literalThis type of value does not assign a special meaning to characters. The only exception is % which is used for URL encoding. value.

Key information:

• Header name:
  • Header name comparisons are case-insensitive.
  • Replace spaces in the header name with %20.
  • Only request headers whose name is an exact match to the specified value may satisfy this condition.
• Header value:

  • The value associated with this match condition may be defined using any combination of numbers, letters, and/or symbols. All characters, with the exception of the % symbol, will be treated as a fixed value and cannot take on a special meaning.

  • The case-sensitivity of header value comparisons is determined by the Ignore Case option.
  • Replace spaces in the header value with %20.

• The Result option determines the conditions under which this match condition will be satisfied.

  • Match: Requires the request to contain the specified header and its value must match the one defined in this match condition.

  • Does Not Match: Requires that the request satisfy either of the following criteria:

    • It does not contain the specified header.
    • It contains the specified header, but its value does not match the one defined in this match condition.

• Due to the manner in which cache settings are tracked, this match condition is incompatible with the following features:

  • Complete Cache Fill (End-of-Life)
  • Default Internal Max-Age
  • Force Internal Max-Age
  • Ignore Origin No-Cache
  • Internal Max-Stale

Sample Scenario

A sample scenario is provided below.

The following sample configuration assumes that this match condition is satisfied when a request matches the specified value.

Header Name	Header Value	Description
Referer	http://www.domain.com/	This configuration will match a request with the following request header: Referer: http://www.domain.com/ It will not match a request with the following request header: Referer: http://www.domain.com/page.php