|
1934
|
1 ---
|
|
|
2 summary: HTTP Authentication using custom JSON protocol
|
|
|
3 ...
|
|
|
4
|
|
|
5 Introduction
|
|
|
6 ============
|
|
|
7
|
|
|
8 To authenticate users, this module does a `POST` request to a configured
|
|
|
9 URL with a JSON payload. It is not async so requests block the server
|
|
|
10 until answered.
|
|
|
11
|
|
|
12 Configuration
|
|
|
13 =============
|
|
|
14
|
|
|
15 ``` lua
|
|
|
16 VirtualHost "example.com"
|
|
|
17 authentication = "custom_http"
|
|
|
18 auth_custom_http = "http://api.example.com/auth"
|
|
|
19 ```
|
|
|
20
|
|
|
21 Protocol
|
|
|
22 ========
|
|
|
23
|
|
|
24 The JSON payload consists of an object with `username` and `password`
|
|
|
25 members:
|
|
|
26
|
|
|
27 {"username":"john","password":"secr1t"}
|
|
|
28
|
|
|
29 The module expects the response body to be exactly `true` if the
|
|
|
30 username and password are correct.
|
