mod_auth_http_async

Introduction

This is an authentication module that does an asynchronous HTTP call to verify username and password.

Details

When a user attempts to authenticate to Prosody, this module takes the username and password and does a HTTP GET request with Basic authentication to the configured http_auth_url.

Configuration

After installing, enable the module by setting authentication to "http_async".

The only setting is http_auth_url which should contain the URL endpoint where the authentication query is sent to. It can contain $host and $user which are substituted for the current VirtualHost and the authenticating username, respectively.

VirtualHost "example.com"
authentication = "http_async"
http_auth_url = "http://example.com/auth"

Compatibility

Should work with Prosody 0.10.x and later.


Installation

With the plugin installer in Prosody 0.12 you can use:

sudo prosodyctl install --server=https://modules.prosody.im/rocks/ mod_auth_http_async

For earlier versions see the documentation for installing 3rd party modules