]> Pileus Git - ~andy/sunrise/blob - mail-filter/postwhite/metadata.xml
166e30de435cc4a5c292688e7ce49cc2107f7603
[~andy/sunrise] / mail-filter / postwhite / metadata.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!DOCTYPE pkgmetadata SYSTEM "http://www.gentoo.org/dtd/metadata.dtd">
3 <pkgmetadata>
4         <herd>no-herd</herd>
5         <maintainer><email>maintainer-wanted@gentoo.org</email></maintainer>
6         <longdescription lang="en">
7                 Postwhite is a policy server for Postfix MTA which filters incoming emails
8                 based on per recipient whitelists managed by an email frontend.
9                 
10                 Incoming emails are denied unless the sender address or sender domain is 
11                 present on the recipient's whitelist. This concept is neither new nor fancy
12                 in itself, but the way Postwhite lets you manage your whitelist sure is.
13
14                 Here is a real life example:
15
16                 Arthur's main email address arthur@dent.tld is great for everyday
17                 use, but he doesn't want to pollute it by using it for mailing lists,
18                 websites, online shopping and such. Postwhite to the rescue! Arthur creates 
19                 a virtual email address hitchhike@dent.tld which is delivered to 
20                 the same mailbox. He adds this address to recipients.yml and then
21                 restarts Postwhite.
22
23                 Initially, all incoming emails will be denied, so when Arthur decides to 
24                 join the Betelgeuse mailing list, his whitelist has to learn about this. 
25                 Arthur sends an empty email to hitchhike+learn@dent.tld which
26                 puts Postwhite into learning mode for a limited period of time. In learning
27                 mode, Postwhite allows and delivers any incoming mails, yet it
28                 delivers a followup notification message along with it. When the first 
29                 email from the Betelgeuse mailing list comes in, Arthur simply replies to 
30                 the corresponding notification message thus adding Betelgeuse to the 
31                 whitelist.
32         </longdescription>
33 </pkgmetadata>