From: Friedrich Weber <f.weber@proxmox.com>
To: pmg-devel@lists.proxmox.com
Subject: [pmg-devel] [PATCH pmg-docs v2] pmg-mail-filter: clarify matching of Who objects
Date: Mon, 17 Feb 2025 12:55:17 +0100 [thread overview]
Message-ID: <20250217115517.40171-1-f.weber@proxmox.com> (raw)
In particular, explain that Who objects match against Envelope From
and Envelope To, not the From: and To: mail headers. This is
occasionally a source of confusion in enterprise support.
Signed-off-by: Friedrich Weber <f.weber@proxmox.com>
---
Notes:
changes since v1: (thx stoiko!)
- mention that these addresses are also visible in the logs, fix
phrasing
- fix commands (they are called `MAIL`/`RCPT`, not `MAIL TO`/`MAIL
FROM`)
pmg-mail-filter.adoc | 13 +++++++++++++
1 file changed, 13 insertions(+)
diff --git a/pmg-mail-filter.adoc b/pmg-mail-filter.adoc
index 235f156..6e7b21f 100644
--- a/pmg-mail-filter.adoc
+++ b/pmg-mail-filter.adoc
@@ -265,6 +265,19 @@ We have two important 'Who' objects called 'Blacklist' and
'Whitelist'. These are used in the default ruleset to globally block
or allow specific senders.
+Note that 'Who' objects match against the mail addresses given during the SMTP
+dialog:
+
+* 'Who' objects in the 'FROM' category match against the sender's mail address
+ given in the `MAIL` command (the Envelope From).
+* 'Who' objects in the 'TO' category match against the recipient's mail address
+ given in the `RCPT` command (the Envelope To).
+
+These addresses are also visible in the logs and the
+xref:pmg_tracking_center[Tracking Center].
+
+If you want to match against the `From:` or `To:` header fields of the mail,
+use a 'What' object with type 'Match Field' instead.
[[pmg_mailfilter_what]]
'What' objects
--
2.39.5
_______________________________________________
pmg-devel mailing list
pmg-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pmg-devel
next reply other threads:[~2025-02-17 11:56 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-02-17 11:55 Friedrich Weber [this message]
2025-02-21 16:57 ` [pmg-devel] applied: " Thomas Lamprecht
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20250217115517.40171-1-f.weber@proxmox.com \
--to=f.weber@proxmox.com \
--cc=pmg-devel@lists.proxmox.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.