<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<!-- THIS PAGE IS AUTOMATICALLY GENERATED. DO NOT EDIT. -->
<!-- Mon Feb 9 14:15:58 2004 -->
<!-- USING HT2HTML 2.0 -->
<!-- SEE http://ht2html.sf.net -->
<!-- User-specified headers:
Title: TMDA Server Configuration
-->
<head>
<title>TMDA Server Configuration</title>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="generator" content="HT2HTML/2.0">
<style type="text/css">
body { margin: 0px; }
</style>
</head>
<body bgcolor="#ffffff" text="#000000"
marginwidth="0" marginheight="0"
link="#0000bb" vlink="#551a8b"
alink="#ff0000">
<!-- start of page table -->
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<!-- start of banner row -->
<tr>
<!-- start of corner cells -->
<td width="150" valign="middle" bgcolor="#afeeee" class="corner">
<center><font size="+2"
>>>> TMDA </font></center> </td>
<td width="15" bgcolor="#cccccc"> </td><!--spacer-->
<!-- end of corner cells -->
<!-- start of banner -->
<td width="90%" bgcolor="#cccccc" class="banner">
<!-- start of site links table -->
<table width="100%" border="0"
CELLSPACING=0 CELLPADDING=0
bgcolor="#ffffff">
<tr>
<td bgcolor="#cccccc">
<a href="./index.html">Home</a>
</td>
<td bgcolor="#cccccc">
<a href="./trouble.html">Help</a>
</td>
<td bgcolor="#cccccc">
<a href="tmda-cgi">TMDA-CGI</a>
</td>
<td bgcolor="#cccccc">
<a href="http://sourceforge.net/projects/tmda">SourceForge</a>
</td>
</tr><tr>
<td bgcolor="#cccccc">
[ <a href="http://www.au.tmda.net/" title="Australia Mirror">AU</a> | <a href="http://www.de.tmda.net/" title="Germany Mirror">DE</a> | <a href="http://www.it.tmda.net/" title="Italy Mirror">IT</a> | <a href="http://www.pl.tmda.net/" title="Poland Mirror">PL</a> | <a href="http://www.us.tmda.net/" title="USA Mirror">US</a> mirror ]
</td>
<td bgcolor="#cccccc">
<a href="http://tmda.net/faq.cgi">FAQ</a>
</td>
<td bgcolor="#cccccc">
<a href="http://wiki.tmda.net/">Wiki</a>
</td>
<td bgcolor="#cccccc">
<a href="http://www.cafeshops.com/TMDA/">Store</a>
</td>
</tr>
</table><!-- end of site links table -->
</td><!-- end of banner -->
</tr><!-- end of banner row -->
<tr><!-- start of sidebar/body row -->
<!-- start of sidebar cells -->
<td width="150" valign="top" bgcolor="#cccccc" class="sidebar">
<!-- start of sidebar table -->
<table width="100%" border="0" cellspacing="0" cellpadding="3"
bgcolor="#ffffff">
<tr><td bgcolor="#191970"><b><font color="#ffffff">
About
</font></b></td></tr>
<tr><td bgcolor="#cccccc">
<a href="index.html">Introduction</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="history.html">History</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="features.html">Features</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="challengeresponse.html">Challenge / Response</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="donations.html">Donations</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="http://wiki.tmda.net/index.cgi/TmdaAdvocacy">Advocacy</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<tr><td bgcolor="#191970"><b><font color="#ffffff">
Install
</font></b></td></tr>
<tr><td bgcolor="#cccccc">
<a href="requirements.html">Requirements</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="download.html">Download</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="install.html">Installation</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="upgrade.html">Upgrading</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<tr><td bgcolor="#191970"><b><font color="#ffffff">
Configuration
</font></b></td></tr>
<tr><td bgcolor="#cccccc">
<a href="config.html">Overview</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="config-pre.html">Pre-Config</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<b>Server Config</b>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="config-client.html">Client Config</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="config-vars.html">Config Variables</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="config-filter.html">Filter Spec</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="filter-sources.html">Filter Sources</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="howto-template.html">Templates</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="tmda-vdomains.html">Virtual Domains</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="tmda-ofmipd.html">tmda-ofmipd</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="http://wiki.tmda.net/index.cgi/TmdaHowtos">User HOWTOs</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<tr><td bgcolor="#191970"><b><font color="#ffffff">
Support
</font></b></td></tr>
<tr><td bgcolor="#cccccc">
<a href="trouble.html">Help</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="http://tmda.net/faq.cgi">FAQ</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="http://wiki.tmda.net/index.cgi/TmdaMailingListsAndNewsgroups">Lists & Newsgroups</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="http://wiki.tmda.net/index.cgi/TmdaMailingListArchives">List Archives</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="http://wiki.tmda.net/index.cgi/TmdaCommercialSupport">Commercial Support</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="http://wiki.tmda.net/index.cgi/TmdaDocumentation">External Docs</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="http://wiki.tmda.net/">TmdaWiki</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<tr><td bgcolor="#191970"><b><font color="#ffffff">
Miscellaneous
</font></b></td></tr>
<tr><td bgcolor="#cccccc">
<a href="http://wiki.tmda.net/index.cgi/TmdaMirrors">Mirrors</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="logos.html">Logos</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<a href="http://www.cafeshops.com/TMDA/" TARGET="Resource Window">Merchandise</a>
</td></tr>
<tr><td bgcolor="#cccccc">
<tr><td bgcolor="#191970"><b><font color="#ffffff">
Contact
</font></b></td></tr>
<tr><td bgcolor="#cccccc">
<a href="mailto:tmda-users@tmda.net">TMDA Users List</a>
</td></tr>
<tr><td bgcolor="#cccccc">
</td></tr>
<tr><td bgcolor="#cccccc">
© 2001-2004
</td></tr>
</table><!-- end of sidebar table -->
</td>
<td width="15"> </td><!--spacer-->
<!-- end of sidebar cell -->
<!-- start of body cell -->
<td valign="top" width="90%" class="body"><br>
<h3>TMDA Server Configuration</h3>
TMDA processes incoming messages on the SMTP server though a mail
filter program called tmda-filter.
<br><br>
Server configuration instructions differ based on which MTA you are running.
First follow the <A HREF="#general">general</a> set of instructions,
and then read the set of instructions corresponding to your MTA
[ <A HREF="#qmail">qmail</a> |
<A HREF="#courier">Courier</a> |
<A HREF="#exim-postfix">Exim/Postfix</a> |
<A HREF="#sendmail">Sendmail</a>
]
<br><br>
<hr>
<a name="general"><h4>TMDA Server Configuration (general)</h4></a>
<ol>
<li>A unique, private key is required for every TMDA user. This key
is stored in its own file <b>~/.tmda/crypt_key</b>. A
key-generation utility is included with the distribution. Simply run
<b>tmda-keygen</b> and follow its instructions.
<br><br>
<li>Optionally create an incoming filter file by reading through the
<a href="config-filter.html">TMDA Filter Specification</a> (especially
the examples section at the end). If you don't have an incoming
filter file, or the sender address doesn't match any lines in your
filter file, the incoming message will require confirmation. The
lines in your filter make exceptions to that rule. You can also
change the default by setting <strong>ACTION_INCOMING</strong> in your
~/.tmda/config. <br><br>
The most common use for the incoming filter is to create both a
"whitelist" (see the FAQ) to allow your trusted contacts
directly into your mailbox, as well as a "blacklist" for those senders
you want to refuse mail from.
<br><br>
</ol>
<hr>
<a name="qmail"><h4>TMDA Server Configuration (qmail-only)</h4></a>
<ol>
<li>Finish setting up your <b>~/.tmda/config</b> and optionally a
system-wide <b>/etc/tmdarc</b> by reading through the included
<b>sample.config</b> file.<br><br>
<li>Setup dot-qmail files appropriately in your home directory.<br><br>
First setup <b>.qmail</b> as shown below, and then make a symbolic
link from there to <b>.qmail-default</b>. This way you will only
have to make changes to the one file.
See
<a href="http://www.qmail.org/man/man5/dot-qmail.html" TARGET="Resource Window">dot-qmail(5)</a>
if you are unfamiliar with how to use dot-qmail files to control the
delivery of mail messages.
<br><br>
<table border cellpadding=4 cellspacing=2>
<tr>
<th>dot-qmail file:</th>
<th>file contents:</th>
<th>action:</th>
</td>
<tr>
<td>.qmail</td>
<td><code>
|preline /path/to/bin/tmda-filter<br>
./Mailbox
</code>
</td>
<td>
If the message is legitimate, it
will pass-through to the second line and get saved to "~/Mailbox",
otherwise it goes through the confirmation process.
</td>
</tr>
<tr>
<td>.qmail-default</td>
<td><code>symbolic link<br> ($ ln -s ~/.qmail ~/.qmail-default)</code></td>
<td>Catches jason-*@ as long as another dot-qmail file does not take priority.</td>
</tr>
</table>
<br>
You may decide that you don't want to use TMDA on your primary
address, but would still like to set aside a secondary address which
does. This would be useful not only for testing purposes, but also
for using in public forums such as newgroups and mailing lists where
the "harvesting" potential is high. This is a much better alternative
than using a munged address such as <em>jasonNOspam@mastaler.com</em>
or <em>jason@REMOVE_THIS.mastaler.com</em> which is confusing, error
prone, and inconvenient for those trying to reply to your messages.
<br><br>
This can easily be accomplished with the dot-qmail interface. For
example, if I wanted only <em>jason-tmda@mastaler.com</em> to be
processed by TMDA, I'd edit <b>.qmail-tmda</b> and make a link from
there to <b>.qmail-tmda-default</b>.<br><br>
<table border cellpadding=4 cellspacing=2>
<tr>
<th>dot-qmail file:</th>
<th>file contents:</th>
<th>action:</th>
</td>
<tr>
<td>.qmail-tmda</td>
<td><code>
|preline /path/to/bin/tmda-filter<br>
./Mailbox
</code>
</td>
<td>
Catches jason-tmda@. If the message is legitimate, it
will pass-through to the second line and get saved to "~/Mailbox",
otherwise it goes through the confirmation process.
</td>
</tr>
<tr>
<td>.qmail-tmda-default</td>
<td><code>symbolic link<br> ($ ln -s ~/.qmail-tmda ~/.qmail-tmda-default)</code></td>
<td>Catches jason-tmda-*@</td>
</tr>
</table>
</ol>
<br>
<hr>
<a name="courier"><h4>TMDA Server Configuration (Courier only)</h4></a>
<ol>
Given the similarily of the
<a href="http://www.courier-mta.org/dot-courier.html" TARGET="Resource Window">dot-courier</a>
interface to dot-qmail, you can simply follow the qmail configuration
instructions above, substituting <strong>.courier-foo</strong> for
<strong>.qmail-foo</strong>.
</ol>
<hr>
<a name="exim-postfix"><h4>TMDA Server Configuration (Exim and Postfix only)</h4></a>
<ol>
<li>Finish setting up your <b>~/.tmda/config</b> and optionally a
system-wide <b>/etc/tmdarc</b> by reading through the
included <b>sample.config</b> file. <b>MAIL_TRANSFER_AGENT</b>, <b>DELIVERY</b>, and
<b>RECIPIENT_DELIMITER</b> are required entries for non-qmail users.
<br><br>
<li>Modify <b>~/.forward</b> to send your mail through tmda-filter.
<blockquote><pre>
"| /path/to/bin/tmda-filter"
</blockquote></pre>
If this produces a bounce with an <em>env: python: No such file or
directory</em> error, you will need to add the full path to your Python
interpreter, e.g,:
<blockquote><pre>
"|/path/to/bin/python /path/to/bin/tmda-filter"
</blockquote></pre>
<li>If you already filter your mail with procmail and wish to continue
doing so, you can invoke tmda-filter from your <b>.procmailrc</b> instead.<br><br>
Make sure your <b>~/.forward</b> calls procmail with the <b>-p</b> option:
<blockquote><pre>
"|/path/to/bin/procmail -p"
</blockquote></pre>
Finally, add the following snippet to the end of your existing <b>.procmailrc</b>
to do final delivery:
<blockquote><pre>
# Run the message through tmda-filter.
:0 w
| /path/to/bin/tmda-filter
# Take the exit code from TMDA.
EXITCODE=$?
# TMDA takes care of final delivery
DEFAULT=/dev/null
</blockquote></pre>
<li>If you already filter your mail with maildrop and wish to continue
doing so, you can invoke tmda-filter from your <b>.mailfilter</b> instead.<br><br>
Add the following snippet to the end of your existing <b>.mailfilter</b>
to do final delivery:
<blockquote><pre>
import SENDER
import RECIPIENT
import EXTENSION
to "| /path/to/bin/tmda-filter"
</blockquote></pre>
</ol>
<hr>
<a name="sendmail"><h4>TMDA Server Configuration (Sendmail only)</h4></a>
These instructions assume you are running either procmail or maildrop as your local
mailer as described in the
<a href="config-pre.html#sendmail">Pre-Configuration</a> page.
<ol>
<li>
Finish setting up your <b>~/.tmda/config</b> and optionally a
system-wide <b>/etc/tmdarc</b> by reading through the
included <b>sample.config</b> file.
<b>MAIL_TRANSFER_AGENT</b>, <b>DELIVERY</b>, and
<b>RECIPIENT_DELIMITER</b> are required entries for non-qmail users.
<br><br>
<li>
<u>Procmail as the local mailer</u><br><br>
Set the SENDER, RECIPIENT, and EXTENSION variables, and then
invoke tmda-filter by adding the following snippet to the end of your
<b>~/.procmailrc</b>.
<blockquote><pre>
# Uncomment this for users without valid shells.
# SHELL=/bin/sh
# Set the necessary environment variables.
EXTENSION="$1"
:0
* EXTENSION ?? .
{
DELIMITER="+"
}
RECIPIENT="$LOGNAME$DELIMITER$EXTENSION@$HOST"
SENDER=`formail -x Return-Path | sed 's/[<>]//g;s/^[ ]*//'`
# Run the message through tmda-filter.
:0 w
| /path/to/bin/tmda-filter
# Take the exit code from TMDA.
EXITCODE=$?
# TMDA takes care of final delivery
DEFAULT=/dev/null
</blockquote></pre>
<u>Maildrop as the local mailer</u><br><br>
Set the SENDER, RECIPIENT, and EXTENSION variables, and then
invoke tmda-filter by adding the following snippet to the end of your
<b>~/.mailfilter</b>.
<blockquote><pre>
# Uncomment this for users without valid shells.
# SHELL=/bin/sh
# Set the necessary environment variables.
EXTENSION="$1"
HOST="$2"
SENDER="$3"
if ( "$EXTENSION" ne "" )
{
DELIMITER="+"
}
RECIPIENT="$LOGNAME$DELIMITER$EXTENSION@$HOST"
# "to" will deliver to message to tmda-filter. It will exit with the
# exit code of the program.
to "| /path/to/bin/tmda-filter"
</blockquote></pre>
</ol>
<hr>
</td><!-- end of body cell -->
</tr><!-- end of sidebar/body row -->
</table><!-- end of page table -->
</body></html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
4c2411a08c8df257138f687227a41525
>
files
>
68
