Additional Message Actions

The Additional Message Actions dialog box allows you to configure an additional action for a rule.

You can add a banner to the top or bottom of a message, add or replace the header of a message, or send a notification to the sender, recipient, or to a custom address.

To configure an additional action:

  • Select Add banner if you want to add a banner to the top or bottom of a message.
    • Select Top or Bottom to configure the banner location.
    • Enter the banner text in the text box.
    • [Optional] Select the Preserve the character encoding of the original message check box to ensure that the message body's encoding is maintained during the processing of the message. When selected, the message body's encoding is also applied to the banner.

      You may want to select this option if the appliance processes messages with a character encoding that is not universal (for example, Shift_JIS).

      Note
      If you are configuring multiple rules that will add a banner when triggered, you should be consistent in the use of this option. Otherwise, more than one character encoding may be applied to a message, causing the message or banner to be displayed incorrectly.
  • Select Add header if you want to add or replace the header of a message.
    • Select Add or Replace to configure whether a header will be added or replaced.
      Note
      If you select Replace, and multiple headers of the same name are present, all of them will be replaced.
    • In the Header name text box, enter the name of the header you want to replace.
    • In the Header value box, enter the header text.
  • Select Add a log entry if you want events that trigger this policy rule to be logged to the message policy log. Events are displayed in the log as key/value pairs with the form user_<key>=<value>, where user_ is added to beginning of the assigned key. The message policy log is accessible through either FTP backup or syslog.
    • Select Add or Replace to configure whether a log entry will be added or replaced.
      Note
      If you select Add, there can be multiple entries of the same key, but with different values. For example, if multiple policies trigger, entries similar to the following will appear:
      user_policy=strip_suspect_attachment
      user_policy=quarantine_for_spam

      If you select Replace, and multiple log entries with the same key are present, all of them will be replaced.

    • In the Key text box, enter the key that you want to assign to this log entry.
      Note
      Keys will be logged with the prefix user_. Keys may only contain alphanumeric characters, or the underscore ("_") character.
    • In the Value text box, enter the value that you want assigned as the key for this log entry.

    You can choose arbitrary key/value pairs.

    When selecting this option, you should also configure syslog monitoring for your appliance.

  • Select Notify if you want to send a notification to the sender, recipient, or to a custom address.
    • In the Notify users section, select:
      • Sender to send a copy of the message to the sender.
      • Recipient to send a copy of the message to the recipient.
      • Postmaster to send a copy of the message to the system postmaster.
      • Custom email address to send a copy of the message to a different email address than the sender or recipient. Enter the custom address in the Custom email address text box.
    • In the Subject text box, enter the subject line of the notification.
    • In the Notification message text box, enter the text, if any, of any notification message you want to include.
    • Select the Attach Original Message check box if you want to include the original message with the notification.
  • Use predefined variables called template variables, if you want to include additional information in a notification. For example, you can insert the template variable %%MESSAGE_SIZE%% in the Subject text box of a notification, and the appliance will replace the template variable with the message size.