comparison mod_host_guard.wiki @ 240:8b15faa008e3

added wiki.
author Marco Cirillo <maranda@lightwitch.org>
date Sun, 04 Dec 2011 15:49:27 +0000
parents
children 012884e6ba5d
comparison
equal deleted inserted replaced
239:8b5492ea07d9 240:8b15faa008e3
1 #summary Granular remote host blacklisting plugin
2 #labels Stage-Stable
3
4 = Details =
5
6 As often it's undesiderable to employ whitelisting logics in public environments, this module let's you more selectively
7 restrict access to your hosts (component or server host) either disallowing access completely or blacklisting certain sources.
8
9 = Usage =
10
11 Copy the plugin into your prosody's modules directory.
12 And add it between your enabled modules into the global section (modules_enabled):
13
14 * The plugin can work either by blocking all remote access (s2s) to a certain resource (useful for components)
15 * Or by selectively blocking certain remote hosts through blacklisting (by using host_guard_selective and host_guard_blacklisting)
16
17 Syntax:
18 {{{
19 host_guard_blockall = { "no_access.yourhost.com", "no_access2.yourhost.com" }
20 host_guard_selective = { "no_access_from_blsted.myhost.com", "no_access_from_blsted.mycomponent.com" }
21 host_guard_blacklist = { "remoterogueserver.com", "remoterogueserver2.com" }
22 }}}
23
24 = Compatibility =
25
26 * Works with 0.8.x, successive versions and trunk.