annotate mod_secure_interfaces.wiki @ 432:26ac8c0e6ecf

and there too
author Kim Alvefur <zash@zash.se>
date Thu, 06 Mar 2014 01:39:57 +0100
parents f26be0f12027
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
407
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
1 #summary Mark some network interfaces (e.g. loopback/LAN) as always secure
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
2 #labels Stage-Beta
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
3
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
4 = Introduction =
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
5
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
6 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.
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
7
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
8 This module allows you to tell Prosody which of the current server's interfaces (IP addresses) that you consider to be on secure networks.
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
9
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
10
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
11 = Configuration =
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
12
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
13 Configuration is simple, just load the module like any other by adding it to your modules_enabled list:
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
14
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
15 {{{
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
16 modules_enabled = {
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
17 ...
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
18 "secure_interfaces";
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
19 ...
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
20 }
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
21 }}}
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
22
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
23 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):
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
24
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
25 {{{
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
26 secure_interfaces = { "127.0.0.1", "::1", "192.168.1.54" }
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
27 }}}
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
28
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
29 = Compatibility =
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
30 || 0.9 || Works ||
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
31 || 0.8 || Unknown ||
f26be0f12027 Created wiki page through web user interface.
MWild1@gmail.com
parents:
diff changeset
32 || trunk || Works ||