mod_auth_pam/README.markdown

   1 ---
   2 labels:
   3 - 'Stage-Alpha'
   4 - 'Type-Auth'
   5 summary: PAM authentication module
   6 ---
   7
   8 Introduction
   9 ============
  10
  11 This module makes Prosody authenticate users against PAM (Linux
  12 Pluggable Authentication Modules)
  13
  14 Dependencies
  15 ============
  16
  17 The module depends on [lua-pam](https://github.com/devurandom/lua-pam)
  18 and [LuaPosix](https://github.com/luaposix/luaposix).
  19
  20 Setup
  21 =====
  22
  23 Create a `/etc/pam.d/xmpp` with something like this:
  24
  25     auth    [success=1 default=ignore]  pam_unix.so obscure sha512 nodelay
  26     auth    requisite           pam_deny.so
  27     auth    required            pam_permit.so
  28
  29 And switch authentication provider in the Prosody config:
  30
  31     authentication = "pam"
  32
  33 Compatibility
  34 =============
  35
  36 Compatible with 0.9 and up