Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
Amazon Simple-Email-Service (SES) Transport for Exim ==================================================== What ---- This transport allows you use Exim to deliver mail through Amazon's SES service. This fork adds support for DKIM-signing the messages. (see http://docs.amazonwebservices.com/ses/latest/DeveloperGuide/index.html?DKIM.html) Why SES + Exim? --------------- 1. Maintenance Most legacy systems expect to be able to deliver via SMTP or one of the local delivery commands (/usr/bin/mail, /usr/sbin/sendmail, etc.). Using exim lifts the burden of having to maintian your own delivery framework if your application doesn't have native support for SES. 2. Flexibility Exim is capable of doing fairly sophisticated checks and processing messages. Should you have reason to not completely trust your messages, this opens up good integration with trusted tools like SpamAssassin, ClamAv, etc. 3. Incoming Mail Some applications need to receive mail, not just send it. Exim gives you a fully implemented receiving implemention if you so desire. This makes it easy to have one mail delivery system without giving up the benefits of SES. 4. Robustness Sometimes outages happen. Maybe you accidentally deployed the wrong credentials. Maybe there was a transient network outage. Maybe your server was running out of RAM. For whatever reason, Exim has facilities to queue messages that can't be immediately delivered. Managing your own mail queue is just something you don't need to do. 5. Debugging Exim provides a powerful way to get at your mail without tearing apart your code. The ability to freeze messages in the queue and then introspect them can be handled at a systems level instead of requiring invasive instrumentation of mail code. This is especially useful when you really need to see what your mail API is generating. Why not use ses-send-email.pl? ------------------------------ Using the Python Boto library provides more precise error handling and avoids some of the peculiarities of the Perl script provided by Amazon. Having this packaged as a Python egg also eases deployment onto multiple systems. How --- First, install the transport. This can be done easily with the pip or easy_install commands. To configure it, take a look at the example exim4.config.sample. It shows how to configure exim to use this transport program. This configuration listens only on the localhost. Only SES messages are sent, and only then if the username is present in the /etc/exim4/ses.senders file. Since SES senders have to be authorized, you should have this list. If you have a more complex installation, you can still use this router at the top to send only SES senders via SES and others via your normal configuration. The example configuration puts the transport in debugging mode. This drops a file in /tmp for each attempted delivery. To disable this, remove the DEBUG variable from the environment by modifying the exim configuration appropriately. Note that the DKIM functionality requires the use of pydkim 4.0 or greater, which is not available on PyPI - see https://launchpad.net/pydkim Adminstrivia ------------ This software was written by Jayson Vantuyl <email@example.com>, with generous support from AssetMap (http://www.assetmap.com). It is licensed under the LGPL version 3.0. DKIM functionality was added by Toby White <firstname.lastname@example.org>.