annotate mod_admin_blocklist/README.md @ 6167:886c985ece61

mod_lastlog2: Skip initializing internal API (and storage) in prosodyctl Initializing storage in the global context under prosodyctl causes the module.command to fail to execute because the storage module has already been loaded. Introduced in 7b722955c59b
author Kim Alvefur <zash@zash.se>
date Sat, 08 Feb 2025 14:12:18 +0100
parents 0e0c6618e154
children 1661f6a74141
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1855
7eef1a3a2a17 mod_admin_blocklist: Add README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
1 ---
6075
0e0c6618e154 mod_admin_blocklist: fix typo
Menel <menel@snikket.de>
parents: 5976
diff changeset
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
7eef1a3a2a17 mod_admin_blocklist: Add README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
5 ...
7eef1a3a2a17 mod_admin_blocklist: Add README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
6
7eef1a3a2a17 mod_admin_blocklist: Add README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
7 This module uses the blocklists set by admins for blocking s2s
7eef1a3a2a17 mod_admin_blocklist: Add README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
8 connections.
7eef1a3a2a17 mod_admin_blocklist: Add README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
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
0e0c6618e154 mod_admin_blocklist: fix typo
Menel <menel@snikket.de>
parents: 5976
diff changeset
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
0e0c6618e154 mod_admin_blocklist: fix typo
Menel <menel@snikket.de>
parents: 5976
diff changeset
26 Prosody-Version Status
0e0c6618e154 mod_admin_blocklist: fix typo
Menel <menel@snikket.de>
parents: 5976
diff changeset
27 --------------- ------
0e0c6618e154 mod_admin_blocklist: fix typo
Menel <menel@snikket.de>
parents: 5976
diff changeset
28 trunk* Works
0e0c6618e154 mod_admin_blocklist: fix typo
Menel <menel@snikket.de>
parents: 5976
diff changeset
29 0.12 Works
5976
bd0b4d8aa94e mod_admin_blocklist: Update README Compability Section
Menel <menel@snikket.de>
parents: 5975
diff changeset
30
6075
0e0c6618e154 mod_admin_blocklist: fix typo
Menel <menel@snikket.de>
parents: 5976
diff changeset
31 *as of 2024-12-21