[pmg-devel] [PATCH pmg-docs] close #2449: clarify DNSBL check in SMTP Whitelist

[Stoiko Ivanov]

Thanks for the patch! - having a clear separation in the used terminology
between postfix and spamassassin (DNSBL, RBL) should help with orientation!


On Wed, Nov 13, 2019 at 02:46:26PM +0100, Mira Limbeck wrote:
> Rename RBL in the context of the SMTP Whitelist to DNSBL for
> consistency. The Mail Proxy Option is already named DNSBL
> Sites/Threshold and the postfix option also contains 'dnsbl', not 'rbl'.
> 
> The description of the SMTP Whitelist is not exactly clear because for DNSBL
> checks postscreen is used which only supports 'IP Address' and 'IP
> Network' entries.
> 
> Signed-off-by: Mira Limbeck <m.limbeck at proxmox.com>
> ---
> It might still not be clear what exactly the difference between the SMTP
> Whitelist, the Rule Whitelist and the User Whitelist is, I'll work on
> adding a comparison or so to the docs as well.
Thanks for the offer - much appreciated! Took a look at the index - maybe
a small dedicated section in 'pmgconfig.adoc' (4. Configuration Management)
between:
* 4.3. Service Configuration Templates and
* 4.4. System Configuration

could be fitting as it's a bit too technical IMO for the introduction and
too conceptual to stick it after the config-file sections with screenshots.
additionally it's before the first level of White/Blacklist (in the
mailproxy)



> 
>  pmg-intro.adoc | 2 +-
>  pmgconfig.adoc | 8 +++++++-
>  2 files changed, 8 insertions(+), 2 deletions(-)
> 
> diff --git a/pmg-intro.adoc b/pmg-intro.adoc
> index 873c9be..20d5422 100644
> --- a/pmg-intro.adoc
> +++ b/pmg-intro.adoc
> @@ -50,7 +50,7 @@ lists of addresses linked to spamming.
>  SMTP Whitelist::
>  
>  Exclude senders from SMTP blocking. To prevent all SMTP checks
> -(Greylisting, Receiver Verification, SPF and RBL) and accept all
> +(Greylisting, Receiver Verification, SPF and DNSBL) and accept all
>  e-mails for the analysis in the filter rule system, you can add the
>  following to this list: Domains (Sender/Receiver), Mail address
>  (Sender/Receiver), Regular Expression (Sender/Receiver), IP address
> diff --git a/pmgconfig.adoc b/pmgconfig.adoc
> index 2ac8a84..78bece2 100644
> --- a/pmgconfig.adoc
> +++ b/pmgconfig.adoc
> @@ -426,11 +426,17 @@ image::images/screenshot/pmg-gui-mailproxy-whitelist.png[]
>  endif::manvolnum[]
>  
>  All SMTP checks are disabled for those entries (e. g. Greylisting,
> -SPF, RBL, ...)
> +SPF, DNSBL, ...).
> +
> +DNSBL checks are done by `postscreen` which works on IP addresses and networks.
> +This means it can only make use of the `IP Address` and `IP Network` entries.
>  
>  NOTE: If you use a backup MX server (e.g. your ISP offers this service
>  for you) you should always add those servers here.
>  
> +NOTE: To disable DNSBL checks entirely, remove any `DNSBL Sites` entries in
> +xref:pmgconfig_mailproxy_options[Mail Proxy Options].
> +
>  
>  [[pmgconfig_spamdetector]]
>  Spam Detector Configuration
> -- 
> 2.20.1
> 
> 
> _______________________________________________
> pmg-devel mailing list
> pmg-devel at pve.proxmox.com
> https://pve.proxmox.com/cgi-bin/mailman/listinfo/pmg-devel
>