author | Matthew Wild <mwild1@gmail.com> |
Sun, 03 Mar 2024 16:03:27 +0000 | |
changeset 5858 | fcfe490de8a4 |
parent 5494 | 91564b57e595 |
permissions | -rw-r--r-- |
5493 | 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 |
``` |
|
5494
91564b57e595
mod_http_debug: Handle more HTTP methods
Kim Alvefur <zash@zash.se>
parents:
5493
diff
changeset
|
32 |
|
91564b57e595
mod_http_debug: Handle more HTTP methods
Kim Alvefur <zash@zash.se>
parents:
5493
diff
changeset
|
33 |
# Configuration |
91564b57e595
mod_http_debug: Handle more HTTP methods
Kim Alvefur <zash@zash.se>
parents:
5493
diff
changeset
|
34 |
|
91564b57e595
mod_http_debug: Handle more HTTP methods
Kim Alvefur <zash@zash.se>
parents:
5493
diff
changeset
|
35 |
HTTP Methods handled can be configured via the `http_debug_methods` |
91564b57e595
mod_http_debug: Handle more HTTP methods
Kim Alvefur <zash@zash.se>
parents:
5493
diff
changeset
|
36 |
setting. By default, the most common methods are already enabled. |
91564b57e595
mod_http_debug: Handle more HTTP methods
Kim Alvefur <zash@zash.se>
parents:
5493
diff
changeset
|
37 |
|
91564b57e595
mod_http_debug: Handle more HTTP methods
Kim Alvefur <zash@zash.se>
parents:
5493
diff
changeset
|
38 |
```lua |
91564b57e595
mod_http_debug: Handle more HTTP methods
Kim Alvefur <zash@zash.se>
parents:
5493
diff
changeset
|
39 |
http_debug_methods = { "GET"; "HEAD"; "DELETE"; "OPTIONS"; "PATCH"; "POST"; "PUT" }; |
91564b57e595
mod_http_debug: Handle more HTTP methods
Kim Alvefur <zash@zash.se>
parents:
5493
diff
changeset
|
40 |
``` |