In order to install this software you need to take the following simple steps:
The problem with qmail's pop3 daemons
QMail's pop3 daemons require an external program for authenticating users. They do not do any authentication at all, and that's why they don't write anything in the system logs. pop3-authd relies on authentication data coming from syslog to catch IPs which should be relayed. Some external programs write data to syslog, and some don't. Anyway, the outputs of 2 different authentication programs are different, so it's hard to make pop3-authd understand all formats.
Instead, I provide patched versions of qmail-pop3d and qmail-popup along with auth-relay. These modified daemons solve the problem independently of the authentication program used. To install them you need to:
Providing secure pop3 with sslwrap
SSLwrap by Rick Kaseguma is often used to tunnel pop3 connections through ssl. It binds to port 995 and forwards requests to port 110, making sure to encrypt outgoing packets and decrypt incoming ones. The problem with this is that authentication queries appear to come from 127.0.0.1. In order to fix the problem I have hacked sslwrap to make it send an extra "SSL host:pass" command, which will be understood by one of the hacked pop3 daemons I also provide in this package (see below). WARNING: the hacked version of sslwrap will not work with normal pop3 daemons.
The ipop3d hack
If you are using the combination sslwrap+ipop3d you have to install a hacked version of ipop3d if you want to relay clients authenticating through pop3-ssl, because of the reasons described in the previous section. The ipop3d-hack/ directory of the auth-relay distribution contains the needed hack for WU's ipop3d (it is based on the package imap-2000c). To install:
Issues with Vmailmgr
Vmailmgr's authentication program - checkvpw - does not log anything about authentication attempts. Besides the fact that this is annoying, it also makes it incompatible with pop3-authd, which relies on authentication data coming from syslog. To fix this you'll have to use the hacked versions of qmail-pop3d and qmail-popup that I provide. Afterwards it will work with sslwrap too. See above on how to install the hacked daemons.
Issues with Vpopmail
Vpopmail's authentication program - vchkpw - also suffers from the same unavoidable problem ipop3d does when used with sslwrap. I haven't provided a hacked version because it would be difficult to hack every authentication program out there and include support into pop3-authd for all of them. Instead, simply used the hacked qmail-pop* daemons that I included in auth-wrap. This fixes the problem independently of the authentication program. However, please note that pop3-authd does support vchkpw, but only when not using pop3-ssl. If you plan to use it with pop3-ssl also comment CHECK_DAEMON_VCHKPW in config.h and rebuild pop3-authd if necessary.
I know that you think this is the part where I tell you that if my software suddenly turns your computer into a green-ulgy-and-mean alien spawning machine you should blame it on the stars, tarot cards, common bad luck, curses, spells, atmospheric pressure variations, solar explosions, ozone layer gaps, black cats, the government, "them", or anything else besides me. However, it is not.
This is the part where I explain why I give so many obvious details like "mkfifo does not create directories". If you haven't noticed I was going into too much detail it's OK, you've just proven my point to the others who did. If you did, my point has just been proven to you by those I was referring at in the previous sentence.
All this is a sequel of 15 months of working as an admin at an ISP, where I had to do tech support too. Just in case you had to know.