To authenticate users, this module does a POST request
to a configured URL with a JSON payload. It is not async so requests
block the server until answered.
VirtualHost "example.com"
authentication = "custom_http"
auth_custom_http = {
post_url = "http://api.example.com/auth";
}The JSON payload consists of an object with username and
password members:
{"username":"john","password":"secr1t"}
The module expects the response body to be exactly true
if the username and password are correct.
With the plugin installer in Prosody 0.12 you can use:
sudo prosodyctl install --server=https://modules.prosody.im/rocks/ mod_auth_custom_http
For earlier versions see the documentation for installing 3rd party modules