Content Filtering

• Enable Content Filtering - This controls whether content filtering is enabled.
• Content Filter Rules - This is a list of content filter rules that will be used to control mail passing through your mail server. Rules are performed sequentially and some rules may affect subsequent rules. Therefore, you can change the order of the rules to achieve the desired effect.
• Add Preset - This allows you to add preset content filter rules to help save time and give an indication of the kind of rules that can be created.

Add / Edit Rule

• Enable Rule - This controls whether the content filter rule is enabled.
• Name - This is used to uniquely identify a rule in the settings and also as an indication of the nature of the rule. The name is only used in the settings and logs and does not have any effect during the rule being performed on any mails.
• Conditions - This is a list of content filter conditions for the rule. Conditions are triggers which evaluate to either true or false for a particular mail being filtered. Conditions are performed sequentially and use logical and/or/not operators together with brackets to achieve a logical equation which overall will evaluate true or false. You can change the order of the conditions and the logical and bracket operators to achieve the desired effect. All conditions do not change the mail being filtered.
• Actions - This is a list of content filter actions for the rule. If the conditions for the rule evaluate true for a given mail, the list of actions are performed. Actions are performed sequentially and some actions may affect subsequent actions. Therefore, you can change the order of the actions to achieve the desired effect.

Add / Edit Condition
There are several condition types. For simplicity, each condition type will be explained in turn followed by all conditions in a table showing their type and a description.

Condition Type - No Settings
This is the simplest type of condition. Each condition with this type requires no additional settings to be configured.

Condition Type - Substring Matches
‘Substring Match’ conditions evaluate based on a particular attribute value matching the substring search criteria provided.

• Match Type - This controls what kind of substring search will be performed against the values supplied. This can be one of the following…
  • String Matches - The value must match the substring provided.
  • String Contains - The value must contain the substring provided.
  • String Starts With - The value must start with the substring provided.
  • String Ends With - The value must end with the substring provided.
  • String Does Not Contain - The value must not contain the substring provided.
• Substrings (One Per Line) - This is the substrings to be used with the given ‘Match Type ’ during the string search .If any one of the substrings matches the search criteria the condition will evaluate true.
• Case Sensitive - If enabled, the string search will be case sensitive. Otherwise, a case in-sensitive search will be performed.

Condition Type - Header Line Matches
‘Substring Match’ conditions evaluate based on a particular attribute value matching the substring search criteria provided.

• Standard Header Field - If set, the substring search will be performed on the header field selected from the combo box.
• Custom Header Field - If set, the substring search will be performed on the header field specified in the available text box.
• Match Type - This controls what kind of substring search will be performed against the values supplied. This can be one of the following…
  • String Matches - The value must match the substring provided.
  • String Contains - The value must contain the substring provided.
  • String Starts With - The value must start with the substring provided.
  • String Ends With - The value must end with the substring provided.
  • String Does Not Contain - The value must not contain the substring provided.
• Substrings (One Per Line) - This is the substrings to be used with the given ‘Match Type ’ during the string search .If any one of the substrings matches the search criteria the condition will evaluate true.
• Case Sensitive - If enabled, the string search will be case sensitive. Otherwise, a case in-sensitive search will be performed.

Add / Edit Condition Type - Sender / Recipients Exist
The ‘Sender / Recipients Exist’ condition will evaluate based on whether one or more addresses exist locally on the mail server.

• Who - This controls which addresses we are checking for existing locally on the mail server. This can be one of the following…
  • Sender - The Sender from the SMTP envelope must match the existence criteria.
  • Any Recipients - At least one Recipient from the SMTP envelope must match the existence criteria.
  • All Recipients - All Recipients from the SMTP envelope must match the existence criteria.
• Exists - This controls whether we are checking for the given addresses existing. This can be one of the following…
  • Exists Locally - The given addresses must exist locally.
  • Does Not Exist Locally - The given addresses must not exist locally.

Condition Type - Number Match
The ‘Number Match ’ conditions evaluate based on the specified item being larger or smaller than the number provided.

• Match Type - This controls the kind of number comparison to be performed. This can be one of the following…
  • Larger Than - The value must be larger than the number provided.
  • Smaller Than - The value must be smaller than the number provided.
• Size - This is the mail size that will be used with the given ‘Comparison Type’ during the comparison.
• Score - This is the Bayesian score that will be used with the given ‘Comparison Type’ during the comparison.

Condition Type - Application Result
The ‘Application Execution Result’ condition will evaluate based on the return value of an application being executed. The application should perform some kind of processing and then exit returning an appropriate value showing the result of the processing done. If the application does not return it will be terminated after a time-out value and the condition will evaluate false.

• Application Path - This is the file path of the application to be executed. It is perfectly legal to have this path set to a network location. For more information on using network drives please view the FAQ page.
• Parameters - This is an optional set of parameters which will be passed to the application to aid in its processing. You can also pass the mail file path as a parameter using the special tag of “%s”, allowing relevant processing to be performed on the mail being filtered.
• Return Value - This is the value range to be compared against the return value given by the application. If the return value is in this range the condition will evaluate true.
• Hide Application Window - If enabled, the application window will be hidden when executed.

Add / Edit Condition - Condition Descriptions
Below is a table describing each of the conditions.

Add / Edit Action
There are several action types. For simplicity, each action type will be explained in turn followed by all actions in a table showing their type and a description.

Action Type - No Settings
This is the simplest type of action. Each action with this type requires no additional settings to be configured.

Action Type - Recipients
‘Recipients’ actions control the recipients in the SMTP envelope which governs which email addresses the mail is delivered to.

• Recipients - This is a list of recipients which are to be affected by the appropriate action.

Action Type - Rename
‘Rename’ actions are performed on a particular attribute based on its value matching the substring search criteria provided.

• Match Type - This controls what kind of substring search will be performed against the values supplied. This can be one of the following…
  • String Matches - The value must match the substring provided.
  • String Contains - The value must contain the substring provided.
  • String Starts With - The value must start with the substring provided.
  • String Ends With - The value must end with the substring provided.
  • String Does Not Contain - The value must not contain the substring provided.
• Substrings (One Per Line) - This is the substrings to be used with the given ‘Match Type ’ during the string search .If any one of the substrings matches the search criteria the condition will evaluate true.
• Case Sensitive - If enabled, the string search will be case sensitive. Otherwise, a case in-sensitive search will be performed.
• Rename To - This is what values matching the substring search will be renamed to.

Action Type - Remove
The ‘Remove’ actions are performed on a particular attribute based on its value matching the substring search criteria provided.

• Match Type - This controls what kind of substring search will be performed against the values supplied. This can be one of the following…
  • String Matches - The value must match the substring provided.
  • String Contains - The value must contain the substring provided.
  • String Starts With - The value must start with the substring provided.
  • String Ends With - The value must end with the substring provided.
  • String Does Not Contain - The value must not contain the substring provided.
• Substrings (One Per Line) - This is the substrings to be used with the given ‘Match Type ’ during the string search .If any one of the substrings matches the search criteria the condition will evaluate true.
• Case Sensitive - If enabled, the string search will be case sensitive. Otherwise, a case in-sensitive search will be performed.

Action Type - Train Bayesian
The ‘Train Bayesian’ action are trains the bayesian SPAM system with the mail being processed.

• Email Type - This controls how the mail is defined when training the Bayesian SPAM system. This can be one of the following…
  • Non-SPAM - The mail is trained as non-SPAM.
  • SPAM - The mail is trained as SPAM..

Action Type - String
The ‘String’ actions are performed based on the string provided.

• Custom Event - This is the custom event that will be added to the mail.
• Account Directory - This is the directory that mail will try to be delivered in instead of the default 'Inbox' directory. If the directory doesn't exist for a particular account, the mail will be placed in the 'Inbox' as normal.

Action Type - Edit Header Field
The ‘Edit Header Field’ action replaces the text of a particular header field. If the header field is not present it will be created.

• Standard Header Field - If set, the substring search will be performed on the header field selected from the combo box.
• Custom Header Field - If set, the substring search will be performed on the header field specified in the available text box.
• Text - This is the text that will replace the current header field text specified. This option allows the use of field tags. For more information please view the Tutorial: Using Field Tags page.

Action Type - Strip Attachments
The ‘Strip Attachment’ action removes attachments that match the substring search criteria provided.

• Match Type - This controls what kind of substring search will be performed against the values supplied. This can be one of the following…
  • String Matches - The value must match the substring provided.
  • String Contains - The value must contain the substring provided.
  • String Starts With - The value must start with the substring provided.
  • String Ends With - The value must end with the substring provided.
  • String Does Not Contain - The value must not contain the substring provided.
• Substrings (One Per Line) - This is the substrings to be used with the given ‘Match Type ’ during the string search .If any one of the substrings matches the search criteria the condition will evaluate true.
• Case Sensitive - If enabled, the string search will be case sensitive. Otherwise, a case in-sensitive search will be performed.
• Insert Removed Attachment Message - This will cause an extra attachment listing all removed attachments to be added to the mail.

Action Type - Strip All
The ‘Strip All’ actions remove all appropriate parts from the mail.

• Insert Removed Attachment Message - This will cause an extra attachment listing all removed attachments to be added to the mail.

Action Type - New Mail
‘New Mail’ actions create new mail to be inserted into the mail server.

• From - This is the email address that will be used as the ‘From’ address of the mail.
• To - This is a list of recipients that will receive the mail. You can add more than one email address separated by semi-colons (‘;’).
• Subject - This is the subject of the new mail. This option allows the use of field tags. For more information please view the Tutorial: Using Field Tags page.
• Message Text - If set, this will be the message body of the new mail. This option allows the use of field tags. For more information please view the Tutorial: Using Field Tags page.
• Message File - If set, the message body of the new mail will be the contents of this file.

Action Type - Add Text to File
The ‘Add Text to File’ action appends the provided text to a given file. If the file does not already exist it will be created.

• File Path - This is the path of the file to be appended to. It is perfectly legal to have this path set to a network location. For more information on using network drives please view the FAQ page.
• Text - This is the text that will be appended to the file. This option allows the use of field tags. For more information please view the Tutorial: Using Field Tags page.

Action Type - Copy All to Directory
The ‘Copy All to Directory’ actions copy all appropriate parts of the mail to a specified directory. The parts remain in the mail.

• Directory Path - This is the directory that all parts will be copied to. It is perfectly legal to have this path set to a network location. For more information on using network drives please view the FAQ page.

Action Type - Execute Application
The ‘Execute Application’ action executes a specified application.

• Application Path - This is the file path of the application to be executed. It is perfectly legal to have this path set to a network location. For more information on using network drives please view the FAQ page.
• Parameters - This is an optional set of parameters which will be passed to the application. This option allows the use of field tags. For more information please view the Tutorial: Using Field Tags page.
• Hide Application Window - If enabled, the application window will be hidden when executed.

Add / Edit Action - Action Descriptions
Below is a table describing each of the actions.