Request headers match

Matches when any specified request header names and patterns match.

This condition inspects the incoming request to verify the presence of a specific set of header names and their corresponding values. It returns true if any defined header name is present and contains a value that matches its respective regular expression.

Configuration

  • Case sensitive: Whether to enable case sensitivity during the comparison. When disabled, the condition performs a case-insensitive match for both the header names and the values against the defined patterns.
  • Name: The exact name of the request header to inspect. Multiple headers can be added to the list.
  • Pattern: The RE2 regular expression used to evaluate the specific header’s value.
  • Defined patterns: The list of all active name-pattern pairs for this condition. The condition returns true only if the request matches every entry in this list.

Measurement

The condition resolves the specified headers from the incoming request and evaluates them against the Defined patterns as a collective set.

  • Match found: The condition returns true upon the first match found.
  • No match found: The condition returns false if no matches are found.
  • Missing header: The condition returns false if the specified header names are missing from the request.

Performance

  • Sequential validation: The system must evaluate each header entry in the list until a result is determined. Processing time increases incrementally with each additional name-pattern pair defined.
  • Short-circuit optimization: The system stops processing and returns false as soon as a mismatch is identified or a missing header is detected. To minimize processing time, place the headers most likely to be missing or mismatched at the top of the list.

Last modified March 5, 2026