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