Mercurial > prosody-modules

comparison mod_http_oauth2/README.markdown @ 5197:164a9875935b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
mod_http_oauth2/README: Document config options
author Kim Alvefur <zash@zash.se>
date Fri, 03 Mar 2023 22:48:14 +0100
parents df3d521e3c39
children 3235b8bd1e55
comparison
equal deleted inserted replaced
5196:6b63af56c8ac 5197:164a9875935b
10 This module is a work-in-progress intended for developers only! 10 This module is a work-in-progress intended for developers only!
11 11
12 Configuration 12 Configuration
13 ============= 13 =============
14 14
15 None currently. 15 Dynamic client registration enabled by configuring a JWT key. Algorithm
16 defaults to *HS256*.
17
18 ```lua
19 oauth2_registration_key = "securely generated JWT key here"
20 oauth2_registration_algorithm = "HS256"
21 oauth2_registration_options = { default_ttl = 60 * 60 * 24 * 90 }
22 ```
23
24 Various flows can be disabled and enabled with
25 `allowed_oauth2_grant_types` and `allowed_oauth2_response_types`:
26
27 ```lua
28 allowed_oauth2_grant_types = {
29 "authorization_code"; -- authorization code grant
30 "password"; -- resource owner password grant
31 }
32
33 allowed_oauth2_response_types = {
34 "code"; -- authorization code flow
35 -- "token"; -- implicit flow disabled by default
36 }
37 ```
38
16 39
17 Compatibility 40 Compatibility
18 ============= 41 =============
19 42
20 Requires Prosody 0.12+ or trunk. 43 Requires Prosody 0.12+ or trunk.