intelligent-smtp-responder | This is an intelligent email-based agent server

Clone this repo, and make sure you have [pycurl](http://pycurl.sourceforge.net/) and [lxml](http://lxml.de/) installed (using [pip](http://www.pip-installer.org/en/latest/) is recommended):.
Edit the [config.py](config.py) file in this folder and redefine these variables with your server’s domain instead of <tt>example.org</tt>:. Edit the <tt>action_mailboxes</tt> dict in the [config.py](config.py) file. (optional) Edit the <tt>pass_through_mailboxes</tt> list in the [config.py](config.py) file. (optional) For logging, set the <tt>smtp_server_debug variable</tt> to <tt>True</tt>. Redirect port 25 (smtp) traffic. Edit the [run_smtps.sh](run_smtps.sh) file. Start the server as root/sudo using the [run_smtps.sh](run_smtps.sh) file: ```sh sh ./run_smtps.sh.
Edit the [config.py](config.py) file in this folder and redefine these variables with your server’s domain instead of <tt>example.org</tt>:
Edit the <tt>action_mailboxes</tt> dict in the [config.py](config.py) file. Each key is the name of the inbox you want the server to auto-respond to, and the value is the name of the module.class which is instantiated to carry out the request. Each class needs to be implemented or referenced in the [agents](agents) folder. See the [notes there](agents/responders.py#L74) for the class and functional prototype requirements, and also look at the [time](agents/time_response_example.py) and [weather](agents/weather_response_example.py) response examples.
(optional) Edit the <tt>pass_through_mailboxes</tt> list in the [config.py](config.py) file. These are the inboxes which the server ignores, and just passes through to the email address defined by the <tt>pass_through_target</tt> variable.
(optional) For logging, set the <tt>smtp_server_debug variable</tt> to <tt>True</tt> This will record the ip address, timestamp, and all commands up to DATA sent to the server by each client.
Redirect port 25 (smtp) traffic <a href="https://en.wikipedia.org/wiki/IPv4" target="_blank">IPv4</a> servers Run the [set_iptables.sh](set_iptables.sh) script as root or sudo: ``` sh ./set_iptables.sh The default port for redirecting incoming traffic is 8888, but you can change that as necessary. Optionally, create an <tt>/etc/iptables.up.rules</tt> file, so that the redirect takes effect on reboots: ``` iptables-save > /etc/iptables.up.rules vi /etc/network/if-pre-up.d/iptables chmod +x /etc/network/if-pre-up.d/iptables Where the <tt>/etc/network/if-pre-up.d/iptables</tt> file contains: ```sh #!/bin/sh /sbin/iptables-restore < /etc/iptables.up.rules For more details on this option, read: [http://articles.slicehost.com/2011/2/21/introducing-iptables-part-3](http://articles.slicehost.com/2011/2/21/introducing-iptables-part-3) or [https://wiki.debian.org/iptables](https://wiki.debian.org/iptables) You can always undo the iptables setting by running the <tt>unset_iptables.sh</tt> script as root/sudo (remember to remove or edit <tt>/etc/iptables.up.rules</tt> as well, if you chose that option initially). <a href="https://en.wikipedia.org/wiki/IPv6" target="_blank">IPv6</a> servers *If the server you are running this software also accepts IPv6 traffic, then you will need to do the following steps as well, since some email senders, notably Google's [gmail](http://gmail.com), use IPv6 if available.* Run the [set_ip6tables.sh](set_ip6tables.sh) script as root or sudo: ``` sh ./set_ip6tables.sh As with [set_iptables.sh](set_iptables.sh), the default port for redirecting incoming traffic is 8888, but you can change that as necessary. *__Note:__ If you change the port in [set_iptables.sh](set_iptables.sh) it __must__ be the same as the one in the [set_ip6tables.sh](set_ip6tables.sh) script.* As as before, create an <tt>/etc/ip6tables.up.rules</tt> file, so that the redirect takes effect on reboots: ``` ip6tables-save > /etc/ip6tables.up.rules vi /etc/network/if-pre-up.d/iptables And update the <tt>/etc/network/if-pre-up.d/iptables</tt> file to contain a third line, like so: ```sh #!/bin/sh /sbin/iptables-restore < /etc/iptables.up.rules /sbin/ip6tables-restore < /etc/ip6tables.up.rules
Edit the [run_smtps.sh](run_smtps.sh) file. By default, the server runs as user <tt>daemon</tt>, but if your auto-responder agents need access to different resources/user groups, just change the user defined at the end of this line: ```sh su -c "export PYTHONPATH=$PYTHONPATH:$smtps:$smtps/server:$smtps/utils:$smtps/agents; python -c 'import smtp_server; smtp_server.start()' > /tmp/smtp_server_$logfile.log 2>&1" daemon The script is designed to restart in case of an error, and if you'd like to get the log by email when that happens, change the target email address in this line: ```sh mail -s "SMTP server error!" support@example.org < /tmp/smtp_server_$logfile.log Note that logfiles do not over-write each other, so you can remove that line altogether, if you'd rather not get the alert.
Start the server as root/sudo using the [run_smtps.sh](run_smtps.sh) file: ```sh sh ./run_smtps.sh