Mercurial > prosody-modules
annotate mod_block_outgoing/README.markdown @ 5193:2bb29ece216b
mod_http_oauth2: Implement stateless dynamic client registration
Replaces previous explicit registration that required either the
additional module mod_adhoc_oauth2_client or manually editing the
database. That method was enough to have something to test with, but
would not probably not scale easily.
Dynamic client registration allows creating clients on the fly, which
may be even easier in theory.
In order to not allow basically unauthenticated writes to the database,
we implement a stateless model here.
per_host_key := HMAC(config -> oauth2_registration_key, hostname)
client_id := JWT { client metadata } signed with per_host_key
client_secret := HMAC(per_host_key, client_id)
This should ensure everything we need to know is part of the client_id,
allowing redirects etc to be validated, and the client_secret can be
validated with only the client_id and the per_host_key.
A nonce injected into the client_id JWT should ensure nobody can submit
the same client metadata and retrieve the same client_secret
author | Kim Alvefur <zash@zash.se> |
---|---|
date | Fri, 03 Mar 2023 21:14:19 +0100 |
parents | 34fb3d239ac1 |
children |
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. |
5007
34fb3d239ac1
*/README: Update compatibility info of modules still using legacy is_admin API
Matthew Wild <mwild1@gmail.com>
parents:
2400
diff
changeset
|
29 |
34fb3d239ac1
*/README: Update compatibility info of modules still using legacy is_admin API
Matthew Wild <mwild1@gmail.com>
parents:
2400
diff
changeset
|
30 Compatibility |
34fb3d239ac1
*/README: Update compatibility info of modules still using legacy is_admin API
Matthew Wild <mwild1@gmail.com>
parents:
2400
diff
changeset
|
31 ============= |
34fb3d239ac1
*/README: Update compatibility info of modules still using legacy is_admin API
Matthew Wild <mwild1@gmail.com>
parents:
2400
diff
changeset
|
32 |
34fb3d239ac1
*/README: Update compatibility info of modules still using legacy is_admin API
Matthew Wild <mwild1@gmail.com>
parents:
2400
diff
changeset
|
33 ------- -------------- |
34fb3d239ac1
*/README: Update compatibility info of modules still using legacy is_admin API
Matthew Wild <mwild1@gmail.com>
parents:
2400
diff
changeset
|
34 trunk Doesn't work (uses is_admin) |
34fb3d239ac1
*/README: Update compatibility info of modules still using legacy is_admin API
Matthew Wild <mwild1@gmail.com>
parents:
2400
diff
changeset
|
35 0.12 Works |
34fb3d239ac1
*/README: Update compatibility info of modules still using legacy is_admin API
Matthew Wild <mwild1@gmail.com>
parents:
2400
diff
changeset
|
36 0.11 Works |
34fb3d239ac1
*/README: Update compatibility info of modules still using legacy is_admin API
Matthew Wild <mwild1@gmail.com>
parents:
2400
diff
changeset
|
37 ------- -------------- |
34fb3d239ac1
*/README: Update compatibility info of modules still using legacy is_admin API
Matthew Wild <mwild1@gmail.com>
parents:
2400
diff
changeset
|
38 |