--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_secure_interfaces/README.markdown	Fri Aug 28 18:03:58 2015 +0200
@@ -0,0 +1,42 @@
+---
+labels:
+- 'Stage-Beta'
+summary: 'Mark some network interfaces (e.g. loopback/LAN) as always secure'
+...
+
+Introduction
+============
+
+Sometimes you might run clients without encryption on the same machine
+or LAN as Prosody - and you want Prosody to treat them as secure (e.g.
+allowing plaintext authentication) even though they are not encrypted.
+
+This module allows you to tell Prosody which of the current server's
+interfaces (IP addresses) that you consider to be on secure networks.
+
+Configuration
+=============
+
+Configuration is simple, just load the module like any other by adding
+it to your modules\_enabled list:
+
+        modules_enabled = {
+            ...
+            "secure_interfaces";
+            ...
+        }
+
+Then set the list of secure interfaces (just make sure it is set in the
+global section of your config file, and **not** under a VirtualHost or
+Component):
+
+        secure_interfaces = { "127.0.0.1", "::1", "192.168.1.54" }
+
+Compatibility
+=============
+
+  ------- ---------
+  0.9     Works
+  0.8     Unknown
+  trunk   Works
+  ------- ---------