# HG changeset patch
# User Kim Alvefur <zash@zash.se>
# Date 1442230589 -7200
# Node ID 5daabb5fe24a7370d740ed47469e043be920b853
# Parent  5a19ccd8457aebb8adf4e6abf1cfa8b52470c79d
mod_limit_auth: Add README

diff -r 5a19ccd8457a -r 5daabb5fe24a mod_limit_auth/README.markdown
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_limit_auth/README.markdown	Mon Sep 14 13:36:29 2015 +0200
@@ -0,0 +1,36 @@
+---
+summary: Throttle authentication attempts with optional tarpit
+...
+
+Introduction
+============
+
+This module lets you put a per-IP limit on the number of failed
+authentication attempts.
+
+It features an optioanal
+[tarpit](https://en.wikipedia.org/wiki/Tarpit_%28networking%29), i.e.
+waiting some time before returning an "authentication failed" response.
+
+Configuration
+=============
+
+``` {.lua}
+modules_enabled = {
+  -- your other modules
+  "limit_auth";
+}
+
+limit_auth_period = 30 -- over 30 seconds
+
+limit_auth_max = 5 -- tolerate no more than 5 failed attempts
+
+ -- Will only work with Prosody 0.10:
+limit_auth_tarpit_delay = 10 -- delay answer this long
+```
+
+Compatibility
+=============
+
+Requires 0.9 or later. The tarpit feature requires Prosody 0.10 or
+later.