IronPort - advanced configuration guide

Strip Header Action
Insert Header Action
6-60
}
archive('joesmith');
Cisco IronPort AsyncOS 7.6 for Email Advanced Configuration Guide
Chapter 6 Using Message Filters to Enforce Email Policies
The strip-header action examines the message for a particular header and removes those lines from the
message before delivering it. When there are multiple headers, all instances of the header are removed
(for example, the “Received:” header.)
In the following example, all messages have the header X-DeleteMe removed before transmission:
stripXDeleteMeFilter:
if (true)
{
}
strip-header('X-DeleteMe');
When working with headers, remember that the current value of the header includes changes made
during processing (such as with filter actions that add, remove, or modify message headings). See
Message Header Rules and Evaluation, page 6-4 for more information.
The insert-header action inserts a new header into a message. AsyncOS does not verify the compliance
to standards of the header you insert; you are responsible for ensuring that the resulting message
complies with Internet standards for email.
The following example inserts a header named X-Company with the value set to My Company Name if the
header is not already found in the message:
addXCompanyFilter:
if (not header('X-Company'))
{
}
insert-header('X-Company', 'My Company Name');
The insert-header() action allows the use of non-ASCII characters in the text of the header, while
restricting the header name to be ASCII (to comply with standards). The transport encoding will be
quoted-printable to maximize the readability.
OL-25137-01