Header

Evaluate messages based on header inspection. Supports header existence checks and regex pattern matching. Header name matching is case-sensitive.

Uses OR logic -- the rule matches if any configured header exists or matches.

Type: message

Variants:

Action	ID
allow	com.synadia.protect.builtins.v1.allow.header.message
deny	com.synadia.protect.builtins.v1.deny.header.message
suspend	com.synadia.protect.builtins.v1.suspend.header.message

Configuration

A map of header names to regex patterns. An empty string checks for header existence only:

activations:
  com.synadia.protect.builtins.v1.allow.header.message: true

configurations:
  com.synadia.protect.builtins.v1.allow.header.message:
    X-API-Key: '' # header must exist
    X-App-Version: "^2\\." # value must match regex
    X-Tenant: '^(prod|staging)$' # multiple patterns supported

Schema

{
  "type": "object",
  "additionalProperties": {
    "type": "string",
    "format": "regex",
    "description": "Regex pattern (empty = existence check)"
  },
  "propertyNames": {
    "minLength": 1
  },
  "minProperties": 1
}