mod_auth_custom_http

Introduction

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.

Configuration

VirtualHost "example.com"
authentication = "custom_http"
auth_custom_http = {
  post_url = "http://api.example.com/auth";
}

Protocol

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.


Installation

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