GuideReference
TrainingSupportCommunity

modify_​incoming_​request_​header


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"}}