--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_auth_pam/README.markdown Fri Aug 28 18:03:58 2015 +0200
@@ -0,0 +1,30 @@
+---
+labels:
+- 'Stage-Alpha'
+- 'Type-Auth'
+summary: PAM authentication module
+...
+
+Introduction
+============
+
+This module makes Prosody authenticate users against PAM (Linux
+Pluggable Authentication Modules)
+
+Setup
+=====
+
+Create a `/etc/pam.d/xmpp` with something like this:
+
+ auth [success=1 default=ignore] pam_unix.so obscure sha512 nodelay
+ auth requisite pam_deny.so
+ auth required pam_permit.so
+
+And switch authentication provider in the Prosody config:
+
+ authentication = "pam"
+
+Compatibility
+=============
+
+Compatible with 0.9 and up