modifyIncomingRequestHeader


Modify, add, remove, or pass along specific request headers coming upstream from the client.

Depending on the type of action you want to perform, specify the corresponding standard header name, or a custom‚ÄčHeader‚ÄčName if the standard name is set to OTHER. The header‚ÄčValue serves as a match condition when the action is DELETE or MODIFY, and the new‚ÄčHeader‚ÄčValue applies when the action is ADD or MODIFY.

See also modify‚ÄčIncoming‚ÄčResponse‚ÄčHeader, modify‚ÄčOutgoing‚ÄčRequest‚ÄčHeader, and modify‚ÄčOutgoing‚ÄčResponse‚ÄčHeader.

OptionTypeDescriptionRequires
actionenum

Either ADD, DELETE, MODIFY, or PASS incoming HTTP request headers.

{"displayType":"enum","options":["ADD","DELETE","MODIFY","PASS"],"tag":"select"}
ADD

Add the header.

DELETE

Delete the header.

MODIFY

Modify the header.

PASS

Pass through the header.

standard‚ÄčAdd‚ÄčHeader‚ÄčNameenum

If the value of action is ADD, this specifies the name of the field to add.

action is ADD
{"displayType":"enum","options":["ACCEPT_ENCODING","ACCEPT_LANGUAGE","OTHER"],"tag":"select"}
{"if":{"attribute":"action","op":"eq","value":"ADD"}}
ACCEPT_‚ÄčENCODING

Add an Accept-Encoding header.

ACCEPT_‚ÄčLANGUAGE

Add an Accept-Language header.

OTHER

Specify another header to add.

standard‚ÄčDelete‚ÄčHeader‚ÄčNameenum

If the value of action is DELETE, this specifies the name of the field to remove.

action is DELETE
{"displayType":"enum","options":["IF_MODIFIED_SINCE","VIA","OTHER"],"tag":"select"}
{"if":{"attribute":"action","op":"eq","value":"DELETE"}}
IF_‚ÄčMODIFIED_‚ÄčSINCE

The If-Modified-Since header.

VIA

The Via header.

OTHER

Specify another header to remove.

standard‚ÄčModify‚ÄčHeader‚ÄčNameenum

If the value of action is MODIFY, this specifies the name of the field to modify.

action is MODIFY
{"displayType":"enum","options":["ACCEPT_ENCODING","ACCEPT_LANGUAGE","OTHER"],"tag":"select"}
{"if":{"attribute":"action","op":"eq","value":"MODIFY"}}
ACCEPT_‚ÄčENCODING

Add an Accept-Encoding header.

ACCEPT_‚ÄčLANGUAGE

Add an Accept-Language header.

OTHER

Specify another header to add.

standard‚ÄčPass‚ÄčHeader‚ÄčNameenum

If the value of action is PASS, this specifies the name of the field to pass through.

action is PASS
{"displayType":"enum","options":["ACCEPT_ENCODING","ACCEPT_LANGUAGE","OTHER"],"tag":"select"}
{"if":{"attribute":"action","op":"eq","value":"PASS"}}
ACCEPT_‚ÄčENCODING

Add an Accept-Encoding header.

ACCEPT_‚ÄčLANGUAGE

Add an Accept-Language header.

OTHER

Specify another header to add.

custom‚ÄčHeader‚ÄčNamestring (allows¬†variables)

Specifies a custom field name that applies when the relevant standard header name is set to OTHER.

standard‚ÄčAdd‚ÄčHeader‚ÄčName is OTHER
OR¬†standard‚ÄčDelete‚ÄčHeader‚ÄčName is OTHER
OR¬†standard‚ÄčModify‚ÄčHeader‚ÄčName is OTHER
OR¬†standard‚ÄčPass‚ÄčHeader‚ÄčName is OTHER
{"displayType":"string","tag":"input","type":"text"}
{"if":{"op":"or","params":[{"attribute":"standardAddHeaderName","op":"eq","value":"OTHER"},{"attribute":"standardDeleteHeaderName","op":"eq","value":"OTHER"},{"attribute":"standardModifyHeaderName","op":"eq","value":"OTHER"},{"attribute":"standardPassHeaderName","op":"eq","value":"OTHER"}]}}
header‚ÄčValuestring (allows¬†variables)

Specifies the new header value.

action is ADD
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"action","op":"eq","value":"ADD"}}
new‚ÄčHeader‚ÄčValuestring (allows¬†variables)

Supplies an HTTP header replacement value.

action is MODIFY
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"action","op":"eq","value":"MODIFY"}}
avoid‚ÄčDuplicate‚ÄčHeadersboolean

When enabled with the action set to MODIFY, prevents creation of more than one instance of a header.

action is MODIFY
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"action","op":"eq","value":"MODIFY"}}