known_senders plugin is designed to help you track and categorize email senders based on their domains. It allows you to maintain a list of known senders and classify incoming emails from these senders. This documentation will guide you through the configuration and usage of the
known_senders plugin is used to maintain a list of known sender domains and classify incoming emails based on these domains. It can be especially useful for distinguishing known senders from potentially malicious or unknown ones. This plugin is available from the version 3.7.0.
To configure the
known_senders plugin, you need to define it in your Rspamd configuration file (usually
local.d/known_senders.conf). Below is an example configuration with explanations for each parameter:
# This plugin must be explicitly enabled to work enabled = true; # Domains to track senders domains = "https://maps.rspamd.com/freemail/free.txt.zst"; # Maximum number of elements max_senders = 100000; # Maximum time to live (when not using bloom filters) max_ttl = 30d; # Use bloom filters (must be enabled in Redis as a plugin) use_bloom = false; # Insert symbol for new senders from the specific domains symbol_unknown = 'UNKNOWN_SENDER';
domainsparameter specifies the URLs or file paths from which the plugin will retrieve sender domains to track. These domains are typically listed in a file in plain text or compressed format.
max_sendersparameter sets the maximum number of sender domains that can be stored in the known senders list. Once this limit is reached, older entries may be removed to make room for new ones.
max_ttlparameter defines the maximum time a sender domain can remain in the known senders list when not using bloom filters. It is specified in days (e.g.,
30d). After this period, the sender domain is considered unknown again.
use_bloom parameter enables or disables the use of bloom filters for faster and memory-efficient lookup of known sender domains. To use bloom filters, follow these steps:
Enable Redis Bloom Plugin: In your Redis configuration (usually
redis.conf), enable the Redis Bloom plugin. This typically involves adding or uncommenting the following line (please bear in mind that you might need to compile this plugin manually):
Once you have completed these steps, the
known_senders plugin will be able to use bloom filters for efficient tracking and classification of known sender domains.
symbol_unknown parameter specifies the symbol that will be inserted for new senders from the domains listed in the
domains configuration. This symbol can be used to further classify emails from unknown senders.