changeset 1858:5daabb5fe24a

mod_limit_auth: Add README
author Kim Alvefur <zash@zash.se>
date Mon, 14 Sep 2015 13:36:29 +0200
parents 5a19ccd8457a
children 4b838e61c68e
files mod_limit_auth/README.markdown
diffstat 1 files changed, 36 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- /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.