mod_auth_http_async/README.markdown
author Kim Alvefur <zash@zash.se>
Thu, 01 Oct 2015 20:43:14 +0200
changeset 1892 3483381c5e46
child 1937 afba0821f058
permissions -rw-r--r--
mod_auth_http_async: Add README

Introduction
============

This is an experimental 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][rfc7617] to the configured `http_auth_url`.

Configuration
=============

``` {.lua}
VirtualHost "example.com"
authentication = "http_async"
http_auth_url = "http://example.com/auth"
```