In part one of this tutorial looked at installing and configuring greylistd alongside Exim to help combat the evils of Spam. In this second part I will look at getting some information out of greylistd -- handy if you need to troubleshoot why the CEO's "urgent" message hasn't arrived yet!
Greylistd is the daemon called by Exim during SMTP connections. The acl_check_rcpt ACL (if setup for greylisting) will ensure that Exim logs SMTP connections resulting in greylisting. You can use this information along with statistics from greylistd itself to troubleshoot and track progress of greylisted sender-triplets and messages.
A typical greylisting entry in the Exim mainlog will look like this:
2008-09-11 06:25:59 H=(mx_relay.somedomain.com) [184.108.40.206] F=<email@example.com> temporarily rejected RCPT <firstname.lastname@example.org>: greylisted.
This tells you the date (11 September 2008), time and sender triplet of the message. If you want to know whether a greylisted messages was subsequently delivered on a retry, you can check further down the Exim log for a "Completed" entry:
2008-09-11 06:37:51 1KgLbh-0007zz-Kh <=email@example.com H=(mx_relay.somedomain.com) [220.127.116.11] P=smtp S=25153 id=F89EE039F5154749BCDAF05850A8993C0E8044B7@ASENDERPC 2008-09-11 06:37:51 1KgLbh-0007zz-Kh => firstname.lastname@example.org R=verify_recipient T=remote_smtp H=18.104.22.168 [22.214.171.124] 2008-09-11 06:37:51 1KgLbh-0007zz-Kh Completed
This tells you a message was delivered by that server from that sender to that recipient. It might be a second message that just happened to have the same triplet or it might be the second attempt for the first message. Because no delivery was made on the first attempt, Exim did no assign it an ID. The second successful attempt got one (1KgLbh-0007zz-Kh). Don't make the automatic assumption that these two entries refer to a single e-mail message. That said, you can say that the second entry means that mail with this triplet is now being delivered and is likely on the whitelist.
Greylistd itself can confirm this with use of the
greylist shell command. You need to supply the sender-triplet as
<sending host ip address> <sender e-mail address> <recipient e-mail address>:
myserver:/# greylist check 126.96.36.199 email@example.com firstname.lastname@example.org white myserver:/#
The response of
white confirms to us that this triplet is on the whitelist and future messages with that triplet will not be delayed. Be careful here if this returns
grey though, because that is also the default response for triplets not on any of the lists. That's because
check asks greylistd what status that triplet has -- an unknown triplet would be greylisted.
greylist command can also give you some statistics:
myserver:/# greylist stats Statistics since Fri Aug 22 16:04:45 2008 (21 days and 2 hours ago) ------------------------------------------------------------------- 18655 items, matching 48655 requests, are currently whitelisted 0 items, matching 0 requests, are currently blacklisted 2841 items, matching 2854 requests, are currently greylisted Of 167535 items that were initially greylisted: - 18655 ( 11.1%) became whitelisted - 148880 ( 88.9%) expired from the greylist
You'll note the ratio of whitelist items to requests. This is another indication that greylisting is doing its job: regular senders will send several requests each, but have only one item in the whitelist. It's also possible to view details of the grey, white or black lists:
myserver:/# greylist list --white Greylist data: ============== Last Seen Count Data 2008-09-12 09:45:15 2 188.8.131.52 email@example.com firstname.lastname@example.org ...
The Count column indicates that two messages have been successfully sent via that sender-triplet and Last Seen tells you when the last one was. These lists can be quite long, so you might like to pipe them into a pager (
greylist list --grey | more) or filter them with grep
greylist list --grey | grep somedomain.com. That last one will display all greylist entries containing "somedomain.com".
Greylist can also dump its data in a format to be used for MRTG, which you'll need redirect into a file if you want to save it:
greylist mrtg > ./filename will do the trick.
Altering the lists manually
So far the greylist commands I've shown you will not affect the three lists it maintains. You may come across situations where you need to move a triplet from one list to another or perhaps add a triplet to the whitelist. I'd recommend against adding a triplet to the blacklist -- prefering to let greylistd do its job. Greylist gives you a way to do this. Needless to say these options should be used with some degree of caution (don't go adding your CEOs LinkedIn notifications to the blacklist unless they ask you to).
greylist add --white <sender-triplet> will add the triplet to the white list. Replace
--black accordingly to add to those lists. Again don't forget it's the triplet that needs adding, and not just the sender e-mail address. In case you need it,
greylist delete <sender-triplet> will delete that triplet from whatever list it may be on.
May contain traces of nut
In the UK food products containing the word “diet” in their name ( e.g. Diet Coke) are accompanied by the warning “Can help only as part of a calorie controlled diet”. By the same nature greylisting can help reduce spam levels only in partnership with other tools, for example: Bayesian-rule based scanning, cautious use of one or more DNSBL and Client-side filtering. I have to say that it is one of the more effective measures I have implemented--and if nothing else, it will reduce the load on your server.