prosody-modules
c539334dd01a
mod_block_outgoing/README.markdown

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

Software / code / prosody-modules

Annotate

mod_block_outgoing/README.markdown @ 4260:c539334dd01a

mod_http_oauth2: Rescope oauth client config into users' storage This produces client_id of the form owner@host/random and prevents clients from being deleted by registering an account with the same name and then deleting the account, as well as having the client automatically be deleted when the owner account is removed. On one hand, this leaks the bare JID of the creator to users. On the other hand, it makes it obvious who made the oauth application. This module is experimental and only for developers, so this can be changed if a better method comes up.
author Kim Alvefur <zash@zash.se>
date Sat, 21 Nov 2020 23:55:10 +0100
parent 2400:bd3a1df128a4
child 5007:34fb3d239ac1
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2400
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
1 ---
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
2 summary: 'Block outgoing stanzas from users'
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
3 ...
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
4
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
5 Introduction
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
6 ============
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
7
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
8 This module blocks all outgoing stanzas from a list of users.
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
9
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
10 Using
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
11 =====
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
12
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
13 Add mod_block_outgoing to the enabled modules in your config file:
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
14 ``` {.lua}
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
15 modules_enabled = {
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
16 -- ...
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
17 "block_outgoing",
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
18 -- ...
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
19 }
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
20 ```
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
21
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
22 Either in a section for a certain host or the global section define which users and what stanzas to block:
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
23 ``` {.lua}
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
24 block_outgoing_users = { "romeo@example.com", "juliet@example.com" }
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
25 block_outgoing_stanzas = { "message", "iq", "presence" }
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
26 ```
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
27
bd3a1df128a4 Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff changeset
28 block_outgoing_stanzas defaults to "message" if not specified.