From 2659e7430ff27adf324abad961bfe461599f1618 Mon Sep 17 00:00:00 2001
From: James Moger <james.moger@gitblit.com>
Date: Tue, 23 Jul 2013 17:48:55 -0400
Subject: [PATCH] Added PAMUserService for local Linux/Unix/MacOSX account authentication

---
 src/site/setup_authentication.mkd |    8 ++++++++
 1 files changed, 8 insertions(+), 0 deletions(-)

diff --git a/src/site/setup_authentication.mkd b/src/site/setup_authentication.mkd
index 7f60618..0ec07fa 100644
--- a/src/site/setup_authentication.mkd
+++ b/src/site/setup_authentication.mkd
@@ -6,6 +6,7 @@
 
 * LDAP authentication
 * Windows authentication
+* PAM authentication
 * Redmine auhentication
 * Salesforce.com authentication
 * Servlet container authentication
@@ -83,6 +84,13 @@
     realm.userService = com.gitblit.WindowsUserService
     realm.windows.defaultDomain =
 
+### PAM Authentication
+
+PAM authentication is based on the use of libpam4j and JNA.  To use this service, your Gitblit server must be installed on a Linux/Unix/MacOSX machine and the user that Gitblit runs-as must have root permissions.
+
+    realm.userService = com.gitblit.PAMUserService
+    realm.pam.serviceName = system-auth
+
 ### Redmine Authentication
 
 You may authenticate your users against a Redmine installation as long as your Redmine install has properly enabled [API authentication](http://www.redmine.org/projects/redmine/wiki/Rest_Api#Authentication).  This user service only supports user authentication; it does not support team creation based on Redmine groups.  Redmine administrators will also be Gitblit administrators.

--
Gitblit v1.9.1