Mercurial > prosody-modules

comparison mod_s2s_blackwhitelist/README.wiki @ 1782:29f3d6b7ad16

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import wiki pages
author Kim Alvefur <zash@zash.se>
date Mon, 24 Aug 2015 16:43:56 +0200
parents
children
comparison
equal deleted inserted replaced
1781:12ac88940fe3 1782:29f3d6b7ad16
1 #summary Module for setting blacklist and whitelist on new server to server connections
2 #labels Deprecated
3
4 = Introduction =
5
6 This module adds the functionality of blacklist and whitelist for new server to server connections (federation).
7
8
9 = Details =
10
11 If the configuration is changed then you can use console to issue "config:reload()" and this plugin will automatically reload the black/whitelists.
12
13 You can either choose whitelist or blacklist functionality (both can't co-exist).
14
15 Note: If a host with existing connections is blacklisted then this module will not tear down existing connection since that was created when the connection agreement was valid. You will need to use "s2s:close" command on console to manually close those connections.
16
17 = Configuration =
18
19 First define whether you need blacklist or whitelist,
20
21 {{{
22 s2s_enable_blackwhitelist = "whitelist" -- enable whitelist. use blacklist to use blacklists
23 }}}
24
25 Now create populate an array of domains in those lists
26
27 For whitelist,
28
29 {{{
30 s2s_whitelist = { "abc.net", "gmail.com", "xyz.net" }
31 }}}
32
33 For blacklist,
34
35 {{{
36 s2s_blacklist = { "gmail.com", "xyz.com" }
37 }}}
38
39 You can change configuration at runtime but need to use console plugin to reload configuration via "config:reload" command.
40
41 = Compatibility =
42
43 || 0.9 || Doesn't work ||
44 || 0.8 || Unknown ||
45 || 0.7 || tested to work with dialbacks ||