Qpsmtpd:dns whitelist soft

From SME Server
Jump to navigationJump to search

Qpsmtpd#Plugins

NAME

dns_whitelist_soft - dns-based whitelist override for other qpsmtpd plugins

DESCRIPTION

The dns_whitelist_soft plugin allows selected host to be whitelisted as exceptions to later plugin processing. It is strongly based on the original dnsbl plugin as well as Gavin Carr's original whitelist_soft plugin. It is most suitable for multisite installations, so that the whitelist is stored in one location and available from all.

CONFIGURATION

To enable the plugin, add it to the ~qpsmtpd/config/plugins file as usual. It should precede any plugins whose rejections you wish to override. You may have to alter those plugins to check the appropriate notes field.

Several configuration files are supported, corresponding to different parts of the SMTP conversation:

whitelist_zones
Any IP address listed in the whitelist_zones file is queried using the connecting MTA's IP address. Any A or TXT answer means that the remote HOST address can be selectively exempted at other stages by plugins testing for a 'whitelisthost' connection note.

NOTE: other 'connect' hooks will continue to fire (e.g. dnsbl), since the DNS queries happen in the background. This plugin's 'rcpt_handler' retrieves the results of the query and sets the connection note if found.

AUTHOR

John Peacock <jpeacock@rowman.com>

Based on the 'whitelist_soft' plugin by Gavin Carr <gavin@openfusion.com.au>, based on the 'whitelist' plugin by Devin Carraway <qpsmtpd@devin.com>.