Mercurial > prosody-modules
annotate mod_admin_blocklist/README.md @ 6092:bd3ff802d883
mod_anti_spam: Fix another traceback for origin sessions without an IP
This is likely to be the case for stanzas originating from local hosts, for
example (so not true s2s). It should be safe to bypass the IP check for those.
| author | Matthew Wild <mwild1@gmail.com> |
|---|---|
| date | Sat, 28 Dec 2024 21:02:08 +0000 |
| parents | 0e0c6618e154 |
| children | 1661f6a74141 |
| rev | line source |
|---|---|
| 1855 | 1 --- |
| 6075 | 2 summary: Block s2s connections based on admin blocklist |
|
5976
bd0b4d8aa94e
mod_admin_blocklist: Update README Compability Section
Menel <menel@snikket.de>
parents:
5975
diff
changeset
|
3 labels: |
|
bd0b4d8aa94e
mod_admin_blocklist: Update README Compability Section
Menel <menel@snikket.de>
parents:
5975
diff
changeset
|
4 - 'Stage-Beta' |
| 1855 | 5 ... |
| 6 | |
| 7 This module uses the blocklists set by admins for blocking s2s | |
| 8 connections. | |
| 9 | |
|
2315
212564152060
mod_admin_blocklist/README: Autolinks!
Kim Alvefur <zash@zash.se>
parents:
2314
diff
changeset
|
10 So if an admin blocks a bare domain using [Blocking Command][xep191] |
|
2316
2a2de19413e7
mod_admin_blocklist/README: Turns out autolink.lua doesn't know about official modules
Kim Alvefur <zash@zash.se>
parents:
2315
diff
changeset
|
11 via [mod\_blocklist][doc:modules:mod_blocklist] then no s2s connections |
|
2a2de19413e7
mod_admin_blocklist/README: Turns out autolink.lua doesn't know about official modules
Kim Alvefur <zash@zash.se>
parents:
2315
diff
changeset
|
12 will be allowed to or from that domain. |
|
5017
96e83b4a93f7
mod_admin_blocklist: Add config option for which role(s) to consider (0.12+)
Kim Alvefur <zash@zash.se>
parents:
2316
diff
changeset
|
13 |
|
96e83b4a93f7
mod_admin_blocklist: Add config option for which role(s) to consider (0.12+)
Kim Alvefur <zash@zash.se>
parents:
2316
diff
changeset
|
14 # Configuring |
|
96e83b4a93f7
mod_admin_blocklist: Add config option for which role(s) to consider (0.12+)
Kim Alvefur <zash@zash.se>
parents:
2316
diff
changeset
|
15 |
|
5976
bd0b4d8aa94e
mod_admin_blocklist: Update README Compability Section
Menel <menel@snikket.de>
parents:
5975
diff
changeset
|
16 The role or roles that determine whether a |
|
5017
96e83b4a93f7
mod_admin_blocklist: Add config option for which role(s) to consider (0.12+)
Kim Alvefur <zash@zash.se>
parents:
2316
diff
changeset
|
17 particular users blocklist is used can be configured: |
|
96e83b4a93f7
mod_admin_blocklist: Add config option for which role(s) to consider (0.12+)
Kim Alvefur <zash@zash.se>
parents:
2316
diff
changeset
|
18 |
|
96e83b4a93f7
mod_admin_blocklist: Add config option for which role(s) to consider (0.12+)
Kim Alvefur <zash@zash.se>
parents:
2316
diff
changeset
|
19 ```lua |
|
96e83b4a93f7
mod_admin_blocklist: Add config option for which role(s) to consider (0.12+)
Kim Alvefur <zash@zash.se>
parents:
2316
diff
changeset
|
20 -- This is the default: |
|
96e83b4a93f7
mod_admin_blocklist: Add config option for which role(s) to consider (0.12+)
Kim Alvefur <zash@zash.se>
parents:
2316
diff
changeset
|
21 admin_blocklist_roles = { "prosody:operator", "prosody:admin" } |
|
96e83b4a93f7
mod_admin_blocklist: Add config option for which role(s) to consider (0.12+)
Kim Alvefur <zash@zash.se>
parents:
2316
diff
changeset
|
22 ``` |
|
96e83b4a93f7
mod_admin_blocklist: Add config option for which role(s) to consider (0.12+)
Kim Alvefur <zash@zash.se>
parents:
2316
diff
changeset
|
23 |
| 6075 | 24 # Compatibility |
|
5017
96e83b4a93f7
mod_admin_blocklist: Add config option for which role(s) to consider (0.12+)
Kim Alvefur <zash@zash.se>
parents:
2316
diff
changeset
|
25 |
| 6075 | 26 Prosody-Version Status |
| 27 --------------- ------ | |
| 28 trunk* Works | |
| 29 0.12 Works | |
|
5976
bd0b4d8aa94e
mod_admin_blocklist: Update README Compability Section
Menel <menel@snikket.de>
parents:
5975
diff
changeset
|
30 |
| 6075 | 31 *as of 2024-12-21 |