view mod_auth_pam/README.markdown @ 2029:3e00cd4a02bc

mod_component_client: Pass a non-zero exit code on shutdown due to lost connection `prosody.shutdown` takes a code as of https://hg.prosody.im/0.10/rev/a22d6a46d2ed
author daurnimator <quae@daurnimator.com>
date Wed, 20 Jan 2016 13:10:50 +1100
parents 4d73a1a6ba68
children d407397d05ca
line wrap: on
line source

---
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