Comparison

mod_http_debug/README.md @ 5676:62c6e17a5e9d

Merge
author Stephen Paul Weber <singpolyma@singpolyma.net>
date Mon, 18 Sep 2023 08:24:19 -0500
parent 5490:91564b57e595
comparison
equal deleted inserted replaced
5675:eade7ff9f52c 5676:62c6e17a5e9d
1 ---
2 summary: HTTP module returning info about requests for debugging
3 ---
4
5 This module returns some info about HTTP requests as Prosody sees them
6 from an endpoint like `http://xmpp.example.net:5281/debug`. This can be
7 used to validate [reverse-proxy configuration][doc:http] and similar use
8 cases.
9
10 # Example
11
12 ```
13 $ curl -sSf https://xmpp.example.net:5281/debug | json_pp
14 {
15 "body" : "",
16 "headers" : {
17 "accept" : "*/*",
18 "host" : "xmpp.example.net:5281",
19 "user_agent" : "curl/7.74.0"
20 },
21 "httpversion" : "1.1",
22 "id" : "jmFROQKoduU3",
23 "ip" : "127.0.0.1",
24 "method" : "GET",
25 "path" : "/debug",
26 "secure" : true,
27 "url" : {
28 "path" : "/debug"
29 }
30 }
31 ```
32
33 # Configuration
34
35 HTTP Methods handled can be configured via the `http_debug_methods`
36 setting. By default, the most common methods are already enabled.
37
38 ```lua
39 http_debug_methods = { "GET"; "HEAD"; "DELETE"; "OPTIONS"; "PATCH"; "POST"; "PUT" };
40 ```