gateway api v1.6.2 experimental

HTTPRoute.spec.rules[].filters[].externalAuth.grpc.spec.rules.matches.headers

Headers specifies HTTP request header matchers. Multiple match values are ANDed together, meaning, a request must match all the specified headers to select the route.

3 fields
HTTPRoute.spec.rules[].filters[].externalAuth.grpc.spec.rules.matches.headers fields and descriptions
Field / TypeDescription
name
string required

Name is the name of the HTTP Header to be matched. Name matching MUST be case-insensitive. (See https://tools.ietf.org/html/rfc7230#section-3.2). If multiple entries specify equivalent header names, only the first entry with an equivalent name MUST be considered for a match. Subsequent entries with an equivalent header name MUST be ignored. Due to the case-insensitivity of header names, "foo" and "Foo" are considered equivalent. When a header is repeated in an HTTP request, it is implementation-specific behavior as to how this is represented. Generally, proxies should follow the guidance from the RFC: https://www.rfc-editor.org/rfc/rfc7230.html#section-3.2.2 regarding processing a repeated header, with special handling for "Set-Cookie".

  • minLength: 1
  • maxLength: 256
  • pattern: ^[A-Za-z0-9!#$%&'*+\-.^_\x60|~]+$
type
string

Type specifies how to match against the value of the header. Support: Core (Exact) Support: Implementation-specific (RegularExpression) Since RegularExpression HeaderMatchType has implementation-specific conformance, implementations can support POSIX, PCRE or any other dialects of regular expressions. Please read the implementation's documentation to determine the supported dialect.

  • enum: ["Exact","RegularExpression"]
  • default: "Exact"
value
string required

Value is the value of HTTP Header to be matched. Must consist of printable US-ASCII characters, optionally separated by single tabs or spaces. See: https://tools.ietf.org/html/rfc7230#section-3.2

  • minLength: 1
  • maxLength: 4096
  • pattern: ^[!-~]+([\t ]?[!-~]+)*$