From: Dietmar Maurer <dietmar@proxmox.com>
Date: Wed, 10 Jan 2018 11:18:41 +0000 (+0100)
Subject: pmg-mail-filter.adoc: document who objects
X-Git-Url: https://git.proxmox.com/?p=pmg-docs.git;a=commitdiff_plain;h=66b48b3a3403ab13415a35994c2f17cfa40b1390

pmg-mail-filter.adoc: document who objects
---

diff --git a/images/screenshot/pmg-gui-mail-filter-what-objects.png b/images/screenshot/pmg-gui-mail-filter-what-objects.png
new file mode 100644
index 0000000..e043be4
Binary files /dev/null and b/images/screenshot/pmg-gui-mail-filter-what-objects.png differ
diff --git a/images/screenshot/pmg-gui-mail-filter-when-objects.png b/images/screenshot/pmg-gui-mail-filter-when-objects.png
new file mode 100644
index 0000000..aa12035
Binary files /dev/null and b/images/screenshot/pmg-gui-mail-filter-when-objects.png differ
diff --git a/images/screenshot/pmg-gui-mail-filter-who-objects.png b/images/screenshot/pmg-gui-mail-filter-who-objects.png
new file mode 100644
index 0000000..813f18b
Binary files /dev/null and b/images/screenshot/pmg-gui-mail-filter-who-objects.png differ
diff --git a/pmg-mail-filter.adoc b/pmg-mail-filter.adoc
index d8f78d5..c927d1c 100644
--- a/pmg-mail-filter.adoc
+++ b/pmg-mail-filter.adoc
@@ -153,3 +153,37 @@ Disclaimer
 ~~~~~~~~~~
 
 Add a Disclaimer.
+
+
+WHO - objects
+-------------
+
+image::images/screenshot/pmg-gui-mail-filter-who-objects.png[]
+
+This type of objects can be used for the 'TO' and/or 'FROM' category,
+and macth the sender or receiver of the e-mail. A single object can
+combine multiple items, and the following item types are available:
+
+EMail::
+
+Allows you to match a single mail address.
+
+Domain::
+
+Only match the domain part of the mail address.
+
+Regular Expression::
+
+This one uses a regular expression to match the whole mail address.
+
+IP Address or Network::
+
+This can be used to match the senders IP address.
+
+LDAP User or Group::
+
+Test if the mail address belong to a specific LDAP user or group.
+
+We have two important WHO objects called 'Blacklist' and
+'Whitelist'. Those are used in the default ruleset to globally block
+or allow specific senders.
\ No newline at end of file