PAM Authentication tab
- Tiki can authenticate users using a PAM server
- To Access
- From the Login Admin page, click the PAM tab.
AuthPAMAuthPAM provides PAM authentication to Tikiwiki just as Pear Auth does with LDAP.
It's mainly intended for those tiki admins who have integrated their Linux boxes onto their network's authentication using PAM;
For example, admins might have their Linux boxes authenticate through PAM to their Windows 2000 Active Directory Domain (via winbind and kerberos 5) so with AuthPAM
then, they can authenticate their networked users against tiki without adding them by hand
Admin DocumentationAuthPAMOld configuration is very simple once you've met all the requirements (only a few). Once met you just have to go to the Login section of TikiAdmin.
There will be a nice option onto 'Method' called 'Tiki and PAM' (which you should select if you plan to use it!). Then at the bottom of the screen there are a few options for AuthPAM. You can see:
- Create user if not in Tiki?: Check this if you want Tiki to add users authenticated through PAM but who are not onto it's internal database.
- Use tiki for admin only?: That's to make tiki authenticate the user 'admin' with its internal system, not PAM. If you don't select this option you'll have to add a system user called 'admin'.
- PAM Service (currently unused): Here you should specify which pam service should Tiki authenticate against but these is now disabled due a lack of the auth_pam php module.
Requirements for AuthPAMAuthPAMOld has a small requirement that must be met in order to work; you need pam_auth php module. I've seen it's on some Linux distributions but not on all.
On the main page AuthPAM Link's section you can get the link to the author's home to get the module and compile it if your distribution doesn't include a binary package.
After compiling and installing the module as stated in its documentation you have to create a PAM service for Tiki (normally at /etc/pam.d).
Then just jump onto Tikiwiki and setup PAM there.
Permissions!Take care of file permissions; remember that php runs with apache privileges, normally a normal user account like www-data or so. If you plan to use PAM against your system's users and your system uses shadowed password you should remember that /etc/shadow is only readable by root, so php won't be able to read it
(the PAM library runs with the calling user privileges), so you'll have to workaround it, maybe letting your web server's user read shadow file or so.
Security IssuesWith a default PAM service any account will be granted (try user: nobody ) so here are a few things to take care about that:
It is recommended that you make use of pam_require module to require a specific group to be in for the user. Also you can take a look at PAM Modules at kernel.org to refine a bit more your pam service for tiki.
Also take note that pam only receives a user/pass pair and checks it; it relays on your web server settings to handle a secure transaction of that pair from the browser to the server. SSL is recommended.