From: James Moger <james.moger@gitblit.com>
Date: Fri, 22 May 2015 15:39:59 +0000 (-0400)
Subject: Improve PAM documentation
X-Git-Tag: v1.7.0~1^2~67^2
X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=e4c2447099c0476f8de3b684aa68c1496218e0f2;p=gitblit.git

Improve PAM documentation
---

diff --git a/src/site/setup_authentication.mkd b/src/site/setup_authentication.mkd
index 87b67497..a3bf4451 100644
--- a/src/site/setup_authentication.mkd
+++ b/src/site/setup_authentication.mkd
@@ -83,10 +83,16 @@ Windows authentication is based on the use of Waffle and JNA.  It is known to wo
 
 ### 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.
+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.
 
     realm.authenticationProviders = pam
-    realm.pam.serviceName = system-auth
+    realm.pam.serviceName = gitblit
+    
+Then define a gitblit authentication policy in `/etc/pam.d/gitblit`
+
+    # PAM configuration for the gitblit service
+    # Standard Un*x authentication.
+    @include common-auth
 
 ### Htpasswd Authentication