Mercurial > prosody-modules
annotate mod_cloud_notify_extensions/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 | 5f1120c284c5 |
children | fed5995180c5 |
rev | line source |
---|---|
4705
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
1 --- |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
2 summary: "Tigase custom push extensions for iOS" |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
3 labels: |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
4 - 'Stage-Beta' |
4708
25fd5e268f90
mod_cloud_notify_extensions: Add depends metadata for plugin installer
Kim Alvefur <zash@zash.se>
parents:
4705
diff
changeset
|
5 rockspec: |
25fd5e268f90
mod_cloud_notify_extensions: Add depends metadata for plugin installer
Kim Alvefur <zash@zash.se>
parents:
4705
diff
changeset
|
6 dependencies: |
25fd5e268f90
mod_cloud_notify_extensions: Add depends metadata for plugin installer
Kim Alvefur <zash@zash.se>
parents:
4705
diff
changeset
|
7 - mod_cloud_notify_encrypted |
25fd5e268f90
mod_cloud_notify_extensions: Add depends metadata for plugin installer
Kim Alvefur <zash@zash.se>
parents:
4705
diff
changeset
|
8 - mod_cloud_notify_priority_tag |
25fd5e268f90
mod_cloud_notify_extensions: Add depends metadata for plugin installer
Kim Alvefur <zash@zash.se>
parents:
4705
diff
changeset
|
9 - mod_cloud_notify_filters |
4705
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
10 ... |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
11 |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
12 Introduction |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
13 ============ |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
14 |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
15 This is a meta-module that simply enables all the modules required to support |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
16 Siskin or Snikket iOS on a Prosody server. |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
17 |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
18 These are currently: |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
19 |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
20 - mod_cloud_notify_encrypted |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
21 - mod_cloud_notify_priority_tag |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
22 - mod_cloud_notify_filters |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
23 |
5059
5f1120c284c5
mod_cloud_notify_extensions: Add note about dependency
Matthew Wild <mwild1@gmail.com>
parents:
4708
diff
changeset
|
24 See the individual module pages for more details. In particular, |
5f1120c284c5
mod_cloud_notify_extensions: Add note about dependency
Matthew Wild <mwild1@gmail.com>
parents:
4708
diff
changeset
|
25 mod_cloud_notify_encrypted depends on |
5f1120c284c5
mod_cloud_notify_extensions: Add note about dependency
Matthew Wild <mwild1@gmail.com>
parents:
4708
diff
changeset
|
26 [luaossl](http://25thandclement.com/~william/projects/luaossl.html), which |
5f1120c284c5
mod_cloud_notify_extensions: Add note about dependency
Matthew Wild <mwild1@gmail.com>
parents:
4708
diff
changeset
|
27 must be installed. It is available in Debian via apt as |
5f1120c284c5
mod_cloud_notify_extensions: Add note about dependency
Matthew Wild <mwild1@gmail.com>
parents:
4708
diff
changeset
|
28 [`lua-luaossl`](https://tracker.debian.org/pkg/lua-luaossl) or via |
5f1120c284c5
mod_cloud_notify_extensions: Add note about dependency
Matthew Wild <mwild1@gmail.com>
parents:
4708
diff
changeset
|
29 `luarocks install luaossl`. |
4705
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
30 |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
31 Note: On MUC services you should also load mod_muc_offline_delivery directly |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
32 under the MUC component in your config file, that is not handled by this |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
33 module. |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
34 |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
35 Configuration |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
36 ============= |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
37 |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
38 There is no configuration for this module, just add it to |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
39 modules\_enabled as normal. |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
40 |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
41 Compatibility |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
42 ============= |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
43 |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
44 ----- ------- |
5059
5f1120c284c5
mod_cloud_notify_extensions: Add note about dependency
Matthew Wild <mwild1@gmail.com>
parents:
4708
diff
changeset
|
45 0.12 Works |
5f1120c284c5
mod_cloud_notify_extensions: Add note about dependency
Matthew Wild <mwild1@gmail.com>
parents:
4708
diff
changeset
|
46 ----- ------- |
4705
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
47 0.11 Should work |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
48 ----- ------- |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
49 trunk Works |
ace4f251a64b
mod_cloud_notify_extensions: Convenience meta-module for Tigase push extensions
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
50 ----- ------- |