This program is an RFC 2645 On-Demand Mail Relay (ODMR) / Authenticated TURN (ATRN) server for vpopmail/vchkpw mail servers running qmail. $Id: README,v 1.15 2004/07/12 23:36:28 james Exp $ REQUIREMENTS For this program to work, you require; 1. A working vpopmail/vchkpw + qmail setup 2. Perl 5 with MIME::Base64, Mail::Header, CDB_File, vpopmail and Digest::HMAC_MD5 modules 3. Maildir mailboxes 4. A UCSPI-TCP server (tcpserver is ideal) or inetd / xinetd vpopmail is available from http://www.inter7.com/vpopmail/ tcpserver is available from http://cr.yp.to/ucspi-tcp.html Pick up any modules you need from http://search.cpan.org/ Latest information at http://romana.now.ie/#vodmr Read INSTALL for installation instructions and how to setup ODMR for a domain. The outline steps are: 1. Create a vpopmail domain in whatever way you usually do. 2. Set a mailbox (postmaster is a good choice) to receive all mail for the domain. 3. Set the comment for the mailbox to be the shared secret and enable ODMR service by setting a mailbox flag. INTRODUCTION vodmr is an On-Demand Mail Relay (ODMR) / Authenticated TURN (ATRN) / RFC2645 server for vpopmail/vchkpw mail servers. Some things to note; Requires vpopmail (and qmail) Uses comment, clear text or password field for passwords Compatible with qmailadmin Minimal implementation Message bouncing Connection filtering with tcpserver A customer makes a connection to the ODMR provider, authenticates using a challenge-response method and requests its mail. The roles of client and server are then reversed and normal SMTP proceeds over the same connection. In this way a network administrator does not need to allow inbound traffic for email delivery. Once the ODMR authentication is completed, SMTP runs on the session that was initiated from the customer system. The ODMR server, odmrd, is explicitly not a long running daemon. A copy of odmrd is started to service a new connection and the process exits when the session finishes. tcpserver/inetd manage the networking elements. odmrd deals only with stdin, stdout and stderr. odmrd does not need to run as root, so don't! Run it as your vpopmail user. (It'll complain if you do run it as root) CHANGES (Potential problems or incompatible changes between releases) 0.11: Requires vpopmail.pm perl module. Supports native clear-text password field. Configuration variables have changed: $vpopmail is gone and $usegecos is replaced by $secretfield to select secret from clear_text, gecos or passwd field. 0.10: A V_USER flag must be set on a mailbox to enable ODMR service from it. The default is to require V_USER2. Use 'vmoduser -2 ...' to accomplish this. If you are upgrading from a previous release you must set V_USER2 on your ODMR mailboxes. You can remove this requirement by setting the $require_flag variable to ``none'' but I strongly recommend against it. It's just too easy to leave mailboxes with guessable gecos values. PROBLEM REPORTING The vodmr mailing list is . To subscribe send a blank email to and confirm the confirmation request you will be sent. To unsubscribe from the list send a blank email to and confirm the confirmation request you will be sent. If you want to report a problem, submit a patch or a comment please email . Please review first the FAQ, INSTALL and other documentation at http://romana.now.ie/#vodmr for any recent updates that may be relevant to your problem. Please include as much information about your problem as you can. Some things which are especially useful are - what version of vodmr and perl you are using (``perl -v'') - name and version of your ODMR client; fetchmail, XATRN, etc - odmrd's debugging output. Note this will include shared secrets. I'm not interested in reading your email but somebody who might intercept your message to me might be. (And let's face it, you have no reason to trust me either). You should remove or obscure secrets (and _just_ the secrets) if this is a concern. Remember -- I can't see your computer and I didn't see what you tried to do. You'll have to tell me! There are two fine essays on the topics of bug reporting and requesting help available on the web. I strongly suggest you invest a little time to read them. They're entertaining _and_ educational! How to Report Bugs Effectively, by Simon Tatham: http://www.chiark.greenend.org.uk/~sgtatham/bugs.html How To Ask Questions The Smart Way, by Eric Steven Raymond: http://www.tuxedo.org/~esr/faqs/smart-questions.html THANKS A thank you to people who've helped out; Tiarnan DeBurca - documentation proof read Giovanni Panozzo - tested vodmr with his client program (XATRN) $Id: README,v 1.15 2004/07/12 23:36:28 james Exp $