User Tools

Site Tools


reference:white_black_lists

Spamfilter White/Blacklists

This lets you set whitelists & blacklists for the spam filter.

There are four lists you can manage. The Whitelist Addresses & Blacklist Addresses lists let you specify sender email addresses to check. With the default rule weights, if a sender's address is on the Whitelist, it will be allowed through the spam filter, and if it is on the Blacklist it will be blocked. If an address is on both the Whitelist and the Blacklist, they will cancel each other out, and the message will be treated as if the sender was on neither list.

You can change the rule weights (on Spamfilter -> GeneralRule Weights to alter this behaviour (eg you could increase the Whitelist rule weight which would mean that if an address is on both lists, the Whitelist will take precedence).

Note that, by default, local email addresses on the whitelist will be ignored. This is by design, because it is a common spammer trick to pretend to be from a local email address. The CheckLocalWhitelist setting on the spam filter Script Configuration tab can be used to alter this behaviour.

White/Blacklist entries

Address entries

When you are adding whitelist or blacklist address entries, you can specify either a full email address, or use 'standard' wildcards (* and ?) or you can use a PCRE regular expression by surrounding the text with / … / characters (with optional PCRE modifiers after the last /). Regular expressions give you the most control and flexibility over address matching, but can be complex if you are not used to them. There are many tutorials on the Internet about regular expressions, one we like is at http://regular-expressions.info.

So, for instance, these are valid entries

  • name@example.com
  • *@example.com
  • fred.*@example.com
  • /^fred\.[a-z+]@example\.com/i

Word entries

When you are adding whitelist or blacklist word entries, you can specify either a simple substring to match or you can use a PCRE regular expression by surrounding the text with / … / characters (with optional PCRE modifiers after the last /). Regular expressions give you the most control and flexibility over matching, but can be complex if you are not used to them. There are many tutorials on the Internet about regular expressions, one we like is at http://regular-expressions.info.

So, for instance, these are valid entries

  • sex
  • /\bv[1i]agra/i

Bulk Deletion of list entries

In v6.1 and later you can bulk delete whitelist & blacklist addresses based on conditions you specify. These are detailed below:

  1. auto - the entry was added automatically (whitelist only)
  2. manual - the entry was added manually
  3. addcount <comparator> <number> - compare the addcount to the specified value (whitelist only). e.g. addcount>100
  4. findcount <comparator> <number> - compare the findcount to the specified value. e.g. findcount<75
  5. initiallyadded <comparator> <age> - compare the initially added date to the specified age (whitelist only). e.g. initiallyadded<5years
  6. lastadded <comparator> <age> - compare the last added date to the specified age (whitelist only). e.g. lastadded>6months
  7. lastfound <comparator> <age> - compare the last found date to the specified age. e.g. lastfound>=2days
  8. addedby:<name> - compare the user which initially added the entry to the specified value (using wildcards). e.g. addedby:fred*
  9. autoaddedby:<name> - compare the address which automatically added the entry to the specified value (using wildcards) (whitelist only). e.g. autoaddedby:*@yahoo.com
  10. matches:<regexp> - compare the entry address to the specified regular expression (case insensitive)
  11. Any other value does a wildcard comparison of the value to the entry address

Do not put spaces around comparators, or after the colon character. Eg addedby:fred* is valid, addedby: fred* is not and will be treated as two separate conditions.

For ages, VPOP3 recognises the periods: minutes, hours, days, months, years (the 's' at the end is optional).

The comparators VPOP3 recognises are: <, =, > <=, >=, <>

Separate multiple conditions with space characters. All the specified conditions must match for the entry to be deleted. Once you have specified the conditions and pressed 'Delete', VPOP3 will tell you how many entries will be deleted, and will give you some examples of the entries which will be deleted. You can then confirm the deletion. If you find you have made a mistake, you can use the Undo Last Bulk Delete button to undo the latest bulk deletion (this only stores the deleted data for one day or until VPOP3 is restarted, whichever is the sooner).

reference/white_black_lists.txt · Last modified: 2018/11/14 10:45 (external edit)