\documentclass{article}
\usepackage{ulem}
\pagestyle{headings}
\begin{document}
\tableofcontents

signing-milterIntroductionDownloadDemoDocumentationMailing-ListLicenseAuthorContact

\part{signing-milter}
signing-milter enables you to s/mime sign an ordinary mail while passing a MTA. It is written in C and tested with the postfix MTA. It should work with any MTA implementing the milter protocol\footnote{https://sources.debian.org/data/main/s/sendmail/8.15.2-12/libmilter/docs/index.html}.

News 2016-07-07: We have written another version of this milter in C++14.

\section{Introduction}
Signing emails allows the receiver to trust the content much more then only relying on the senderaddress. So signing mails is a way to a increase your reputation. Sometimes you are unable to sign all mail as a person using an MUA. You may want to sign all mails generated by your trusted system. Here \textbf{signing-milter} may help.

There are two standards for signing mail: PGP and S/MIME. \textbf{signing-milter} supports S/MIME.

While you inject plain, wellformatted mail into your MTA, \textbf{signing-milter} capture the whole mail, extracts the envelope sender and consults a lookuptable to find a corresponding private key and certificate. If all matches, the MTA is instructed via the milter protocol to replace the whole mailbody with a signed one. The mailheaders are properly adjusted to reflect changed content-types and mime format.

\section{Download}
The current version of \textbf{signing-milter} is signing-milter-20210822.tar.gz\footnote{https://signing-milter.org/download/signing-milter-20210822.tar.gz}. Older Releases are available from https://signing-milter.org/download\footnote{https://signing-milter.org/download}.

The latest code is available at github.com/andreasschulze/signing-milter\footnote{https://github.com/andreasschulze/signing-milter}

You can download the C++ version named \textbf{sigh} on Github v1607.1.1.tar.gz\footnote{https://github.com/croessner/sigh/archive/v1607.1.1.tar.gz}.

\section{Demo}
Demonstrating signed mails is a little bit boring. Neverless we setup a autoresponder\footnote{mailto:echo\%REMOVE\_THIS@signing-milter.org} replying with a signed mail. The certificate used by the autoresponder is sponsored by DATEV eG, Germany\footnote{https://datev.com}. Ask for permission to use this service at regular intervals.

\section{Documentation}
Currently there is no more documentation then the manpage\footnote{https://signing-milter.org/download/manpage.html}, the code itself and this Wiki. Feel free to add content to this wiki!

Documentation for \textbf{sigh} is included in the source tree of the project. See the README.build file for required dependencies and how to create the binary. There is also a man page and two example configuration files that describe in detail how to get the milter up and running.

\begin{itemize}
\item{starting the milter\footnote{http://example.com/index.php?page=run}}
\end{itemize}
\section{Mailing-List}
There are lists for general discussion\footnote{https://signing-milter.org/listarchive/users@signing-milter.org} and announcements\footnote{https://signing-milter.org/listarchive/announce@signing-milter.org/}.

\begin{itemize}
\item{To subscribe, send an email to users+subscribe@signing-milter.org\footnote{mailto:users+subscribe@signing-milter.org}.}
\item{To unsubscribe, send an email to users+unsubscribe@signing-milter.org\footnote{mailto:users+unsubscribe@signing-milter.org}.}
\end{itemize}
\section{License}
\textbf{signing-milter} is licensed unter the terms of GNU General Public License as published by the Free Software Foundation. Only version 2 of the License is applicable.

\textbf{sigh} is licensed und the GNU General Public License version 3.

\section{Author}
\textbf{signing-milter} was written by Andreas Schulze. Portions of code are inspired or copied from postfix\footnote{http://www.postfix.org}. Many inspirations I also found in amavisd-milter\footnote{http://amavisd-milter.sourceforge.net} and opendkim\footnote{http://opendkim.org}.

\textbf{sigh} was written by Christian Roessner. Some ideas are based on the original code from Andreas Schulze. As the code is written in C++, the OpenSSL\footnote{http://example.com/index.php?page=OpenSSL} part is mostly done with smart-pointers to prevent memrory leaks. Coding this way was based on ideas given by people on stackoverflow\footnote{https://stackoverflow.com}.

\section{Contact}
You may contact the author per e-mail\footnote{mailto:schreiberling\%REMOVE\_THIS\_at\_signing-milter\_dot\_org} and the mailing lists.

\end{document}
