Add enums to hacking too.
[citadel.git] / citadel / techdoc / PAM.txt
1         The citadel.pam configuration file has been updated for Red Hat 7.1.
2 If you have such a system, it should Just Work; if you don't, you're going to
3 have to tweak it, preferably BEFORE you do a make install.  See below.  Even
4 if you have Red Hat 7.1, you should look at the file anyway and understand how
5 it affects your system security.  The original PAM.txt is included below:
6  
7  
8         Citadel 5.53 and later include support for Pluggable Authentication
9 Modules (PAM.) However, we don't recommend enabling this feature (./configure
10 --with-pam) unless you understand exactly how it will affect your system's
11 security. Specifically, the system administrator must supply a configuration
12 for every authentication service which uses PAM. We have automated this process
13 for Linux by supplying a file which is placed in /etc/pam.d during the
14 installation process, but not on other systems, for 2 reasons:
15  
16         1) Other systems don't have /etc/pam.d; instead they use one big
17 configuration file, usually /etc/pam.conf. It's not quite as trivial to
18 automatically modify this file in a safe and secure fashion.
19  
20         2) Other systems have a different set of available authentication
21 modules; they are likely to lack all three of the ones we use in the Linux
22 configuration. We don't have enough information about the features of the
23 authentication modules on other platforms to be able to provide secure
24 configurations.
25  
26         That said, the configuration we've provided should work on at least
27 Red Hat Linux 4.2-5.2, (although we don't recommend building Citadel on Red
28 Hat 4.x due to libc thread-safety issues) and if you understand PAM
29 configuration on your system, feel free to build Citadel with PAM support,
30 as long as you realize that YOU'RE ON YOUR OWN.