From 8fb5895c46282aa913d2cf3c31f3c526174b3f3b Mon Sep 17 00:00:00 2001
From: Kali Kaneko <kali@leap.se>
Date: Tue, 9 Apr 2013 23:08:33 +0900
Subject: Initial import

---
 src/leap/mail/smtp/README.rst | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 src/leap/mail/smtp/README.rst

(limited to 'src/leap/mail/smtp/README.rst')

diff --git a/src/leap/mail/smtp/README.rst b/src/leap/mail/smtp/README.rst
new file mode 100644
index 0000000..2b2a118
--- /dev/null
+++ b/src/leap/mail/smtp/README.rst
@@ -0,0 +1,43 @@
+Leap SMTP Relay
+===============
+
+Outgoing mail workflow:
+
+    * LEAP client runs a thin SMTP proxy on the user's device, bound to
+      localhost.
+    * User's MUA is configured outgoing SMTP to localhost
+    * When SMTP proxy receives an email from MUA
+        * SMTP proxy queries Key Manager for the user's private key and public
+          keys of all recipients
+        * Message is signed by sender and encrypted to recipients.
+        * If recipient's key is missing, email goes out in cleartext (unless
+          user has configured option to send only encrypted email)
+        * Finally, message is relayed to provider's SMTP relay
+
+
+Dependencies
+------------
+
+Leap SMTP Relay depends on the following python libraries:
+
+  * Twisted 12.3.0 [1]
+  * zope.interface 4.0.3 [2]
+
+[1] http://pypi.python.org/pypi/Twisted/12.3.0
+[2] http://pypi.python.org/pypi/zope.interface/4.0.3
+
+
+How to run
+----------
+
+To launch the SMTP relay, run the following command:
+
+  twistd -y smtprelay.tac
+
+
+Running tests
+-------------
+
+Tests are run using Twisted's Trial API, like this:
+
+  trial leap.email.smtp.tests
-- 
cgit v1.2.3