Download

linuxpamauth.zip - A zip file containing all the necessary files.
linuxpamauth_src.zip - The source code.

Installation

WARNING - This might get ugly.

1. Unzip the linuxpamauth.zip file.
• >unzip linuxpamauth.zip
2. Install the validate executable in usr/bin.
• >cp linuxpamauth/usr/bin/validate /usr/bin/
• >chmod 755 /usr/bin/validate
• >chmod u+s /usr/bin/validate
3. Install the pam.d config file.
• It is assumed that pam is already running properly on the server. If not, then ask yourself why you want to use this plugin.
• >cp linuxpamauth/etc/pam.d/fitnesse /etc/pam.d/
• Edit this fitnesse config file to your desire. By default it uses system authentication.
4. Test the validate program.
• If you're logged in as root, su to non-root user.
• >validate <username>
• The validate program will now wait for the password to be entered into standard input.
• ><password>
• If you used valid credentials and all is well, validate will respond with OK. Otherwise it will respond with an appropriote error code.
5. Test the LinuxPamAuthenticator java program.
• >java -cp linuxpam.jar:path/to/fitnesse.jar com.objectmentor.fitnesse.LinuxPamAuthenticator <username> <password>
• Valid username/password combinations should result in a Authenticated message. Bad credentials get a Not Authenticated message.
6. Install the LinuxPamAuthenticator
• Create/Edit the plugins.properties in your Fitnesse directory. Add the following line.
• Authenticator = com.objectmentor.fitnesse.LinuxPamAuthenticator
• Restart FitNesse making sure that linuxpam.jar is in the classpath.
• FitNesse's startup message will indicate that the plugin was loaded:
• authenticator: com.objectmentor.fitnesse.LinuxPamAuthenticator