Property Manager Name: Modify Outgoing Request Header
Modify, add, remove, or pass along specific request headers going upstream towards the origin.
Depending on the type of action you want to perform, specify the corresponding standard header name, or a customHeaderName if the standard name is set to OTHER. The headerValue serves as a match condition when the action is DELETE or MODIFY, and the newHeaderValue applies when the action is ADD or MODIFY. Whole-text replacements apply when the action is MODIFY, and substitutions apply when set to REGEX.
See also modifyIncomingRequestHeader, modifyIncomingResponseHeader, and modifyOutgoingResponseHeader.
Options
- action (enum string): Either ADD or DELETE outgoing HTTP request headers, MODIFY their fixed values, or specify a REGEX pattern to transform them.
- standardAddHeaderName (enum string): If the value of action is ADD, this specifies the name of the field to add, either USER_AGENT or OTHER.
- standardDeleteHeaderName (enum string): If the value of action is DELETE, this specifies the name of the field to remove, either PRAGMA, USER_AGENT, VIA, or OTHER.
- standardModifyHeaderName (enum string): If the value of action is MODIFY or REGEX, this specifies the name of the field to modify, either USER_AGENT or OTHER.
- customHeaderName (string; allows variables): Specifies a custom field name that applies when the relevant standard header name is set to OTHER.
- headerValue (string; allows variables): With the action set to ADD, specifies the new header value.
- newHeaderValue (string; allows variables): With the action set to MODIFY, specifies an HTTP header replacement value.
- regexHeaderMatch (string; allows variables): When the action is REGEX, specifies a Perl-compatible regular expression to match within the header value.
- regexHeaderReplace (string; allows variables): When the action is REGEX, specifies text that replaces the regexHeaderMatch pattern within the header value.
- matchMultiple (boolean): When enabled with the action set to REGEX, replaces all occurrences of the matched regular expression, otherwise only the first match if disabled.
- avoidDuplicateHeaders (boolean): When enabled with the action set to MODIFY, prevents creation of more than one instance of a header.