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