Mercurial > prosody-wiki

comparison mod_muc_ban_ip.wiki @ 349:f11f8c63384b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Created wiki page through web user interface.
author MWild1@gmail.com
date Thu, 09 May 2013 10:36:10 +0000
parents
children 0e0883870058
comparison
equal deleted inserted replaced
348:b229ce111aa2 349:f11f8c63384b
1 #summary Ban users from chatrooms by their IP address
2 #labels Stage-Alpha
3
4 = Introduction =
5
6 One frequent complaint about XMPP chatrooms (MUCs) compared to IRC is the inability for a room admin to ban a user based on their IP address. This is because an XMPP user is not identified on the network by their IP address, only their JID.
7
8 This means that it is possible to create a new account (often quite easy), and rejoin the room that you were banned from.
9
10 This module allows the *user's* server to enforce IP-bans, which is very desirable for server admins who want to prevent their server being used for spamming and abusive behaviour.
11
12 = Details =
13
14 An important point to note is that this module enforces the IP ban on the banned user's server, not on the MUC server. This means that:
15
16 * The user's server MUST have this module loaded, however -
17 * The module works even when the MUC is on a different server to the user
18 * The module works for banning [http://prosody.im/doc/anonymous_logins anonymous users]
19
20 Also note that IP bans are not saved permanently, and are reset upon a server restart.
21
22 = Configuration =
23
24 There is no extra configuration for this module except for loading it. Remember... do not load it on the MUC host, simply add it to your global `modules_enabled` list, or under a specific host like:
25
26 {{{
27 VirtualHost "anon.example.com"
28 authentication = "anonymous"
29 modules_enabled = { "muc_ban_ip" }
30 }}}
31
32 = Compatibility =
33 || 0.9 || Works ||
34 || 0.8 || Doesn't work ||