prosody-modules
d611ed13df7e
mod_muc_ban_ip/README.md

Find changesets by keywords by author, files, the commit message, revision number or hash, or revset expression.

Software / code / prosody-modules

Comparison

mod_muc_ban_ip/README.md @ 6209:d611ed13df7e draft

Merge
author Trần H. Trung <xmpp:trần.h.trung@trung.fun>
date Tue, 18 Mar 2025 00:16:25 +0700 (10 days ago)
parent 1820:mod_muc_ban_ip/README.markdown@8de50be756e5
comparison
equal deleted inserted replaced
6208:e20901443eae 6209:d611ed13df7e
1 ---
2 labels:
3 - 'Stage-Alpha'
4 summary: Ban users from chatrooms by their IP address
5 ...
6
7 Introduction
8 ============
9
10 One frequent complaint about XMPP chatrooms (MUCs) compared to IRC is
11 the inability for a room admin to ban a user based on their IP address.
12 This is because an XMPP user is not identified on the network by their
13 IP address, only their JID.
14
15 This means that it is possible to create a new account (usually quite
16 easily), and rejoin the room that you were banned from.
17
18 This module allows the **user's** server to enforce bans by IP address,
19 which is very desirable for server admins who want to prevent their
20 server being used for spamming and abusive behaviour.
21
22 Details
23 =======
24
25 An important point to note is that this module enforces the IP ban on
26 the banned user's server, not on the MUC server. This means that:
27
28 - The user's server MUST have this module loaded, however -
29 - The module works even when the MUC is on a different server to the
30 user
31 - The MUC server does not need this module (it only needs to support
32 the [standard ban
33 protocol](http://xmpp.org/extensions/xep-0045.html#ban))
34 - The module works for effectively banning [anonymous
35 users](http://prosody.im/doc/anonymous_logins)
36
37 Also note that IP bans are not saved permanently, and are reset upon a
38 server restart.
39
40 Configuration
41 =============
42
43 There is no extra configuration for this module except for loading it.
44 Remember... do not load it on the MUC host, simply add it to your global
45 `modules_enabled` list, or under a specific host like:
46
47 ``` lua
48 VirtualHost "anon.example.com"
49 authentication = "anonymous"
50 modules_enabled = { "muc_ban_ip" }
51 ```
52
53 Compatibility
54 =============
55
56 ----- --------------
57 0.9 Works
58 0.8 Doesn't work
59 ----- --------------