Specifying Filter Rules
Votiro Cloud for Email filter rules are a set of filters that are used to exclude or include emails or SMTP sessions for positive selection.
You can set filters for Votiro Cloud for Email in the FilterSettings.xml file. Rules that result in a true value generate an action. SMTP sessions that do not match any of the explicitly specified rules are applied according to the DefaultAction value.
The basic structure of a filter rule is:
<?xml version="1.0" encoding="utf-8" ?> <FilterRules defaultAction="Block"> </FilterRules>
Note
If a filter rule is added to a specific user, all recipients of the same mail are affected.
Filters
You can specify values for the following filters.
Filter Name | Description |
---|---|
EmailUser | The user name of an email recipient, as specified in the SMTP session. |
Domain | The domain name to which an email is being sent. |
SmtpRemoteIP | Use this filter to specify that emails arriving from the IP address of Management are not processed. This prevents a loop in which already positively selected emails that are routed back to the Exchange server for delivery to the recipient do not enter the queue for positive selection again. |
Logical | The logical operators AND, OR and NOT which can be used to link sub-rules within a filter. |
Notes
nFilter names and values are case sensitive.
nTo exclude internal and outgoing emails from positive selection, you must update the domain rule type with the exchange company domain name or the IP address of the internal email server in the FilterSettings.xml file. This will allow passing every outgoing SMTP packet from the organization.
Example 1:
<Rule type="Domain" token="YourOrganizationDomain.com" action="Pass" precedence="1" scanFrom="true" scanTo="false" scanCC="false" />
Where YourOrganizationDomain.com is the domain name of your company or the IPv4 address of the internal mail server.
Example 2:
<Rule type="SmtpRemoteIP" token="XXX.XXX.XXX.XXX" action="Pass" precedence="1" />
Where XXX.XXX.XXX.XXX is the IPv4 address of the internal mail server.
Note
In order for the Positive Selection® Engine to send the original emails to recipients within the organization, you must add the SmtpRemoteIp rule type with the IPv4 address of the Management server in the FilterSettings.xml file.
Example 3:
<Rule type="SmtpRemoteIP" token="XXX.XXX.XXX.XXX" action="Pass" precedence="1" />
Where XXX.XXX.XXX.XXX is the IPv4 address of the Positive Selection® Engine.
Note
Adding a filter rule to a specific user will affect all of the mail recipients in the same SMTP session.
Actions
The actions that are available for filter rules are:
n | Block, which occurs when the true filter value is satisfied, that results in the email being positively selected. |
n | Pass, which occurs when the false filter value is satisfied or when the true filter is not satisfied. |
In the case of multiple filters, the process moves through each one, according the Precedence and Logical values.
Note
When no true value filters are satisfied, the email is processed according to the DefaultAction value.
Precedence
Precedence is a priority, expressed as an integer. The lowest number represents the highest priority. Filter rules are processed according to the assigned priority. When the first true value or DefaultAction value is satisfied, the filtering process stops
Tokens
A token can be specified as a search word for the EmailUser, Domain and SmtpRemoteIP fields.
Scan Values
You can use scanFrom, scanTo, and scanCC in Emailuser and Domain filters to specify whether a rule should be run on an email’s From, To, and CC fields.
When the value is true, the rule is applied.
Operators
Operators are used to specify logical operations between sub-rules in a filter.
For example, to specify that emails being sent from jack@abc.com to jill@votiro.com are not to be processed using positive selection, you can use the following filter.
<Rule type="Logical" operator="And" action="Pass" precedence="1"> <Rule type="Logical" operator="And"> <Rule type="EmailUser" token="jack" scanFrom="true" scanTo="false" scanCC="false" /> <Rule type="Domain" token="abc.com" scanFrom="true" scanTo="false" scanCC="false" /> </Rule> <Rule type="Logical" operator="And"> <Rule type="EmailUser" token="jill" scanFrom="false" scanTo="true" scanCC="false" /> <Rule type="Domain" token="votiro.com" scanFrom="false" scanTo="true" scanCC="false" /> </Rule> </Rule>
Example of Filter Rules
The following example shows the construction of a filter that allows email from the specific IP address 192.168.0.2 to Jeff to be delivered without positive selection processing.
<Rule type="Logical" operator="And" action="Pass" precedence="4"> <Rule type="SmtpRemoteIP" token="192.168.0.2" /> <Rule type="Logical" operator="Not" > <Rule type="EmailUser" token="jeff" scanFrom="false" scanTo="true" scanCC="true" /> </Rule> </Rule>
Comments
0 comments
Please sign in to leave a comment.