PAM.txt 1.9 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849
  1. ngIRCd - Next Generation IRC Server
  2. http://ngircd.barton.de/
  3. (c)2001-2013 Alexander Barton and Contributors.
  4. ngIRCd is free software and published under the
  5. terms of the GNU General Public License.
  6. -- PAM.txt --
  7. ngIRCd can optionally be compiled to use PAM, the Pluggable Authentication
  8. Modules library, for user authentication. When compiled with PAM support,
  9. ngIRCd will authenticate all users connecting to the daemon using the
  10. configured PAM modules in an asynchronous child process.
  11. To enable PAM, you have to pass the command line parameter "--with-pam" to
  12. the "configure" script. Please see the PAM documentation ("man 7 pam") for
  13. details and information about configuring PAM and its individual modules.
  14. A very simple -- and quite useless ;-) -- example would be:
  15. /etc/pam.d/ngircd:
  16. auth required pam_debug.so
  17. Here the "pam_debug" module will be called each time a client connects to
  18. the ngIRCd and has sent its PASS, NICK, and USER commands.
  19. The PAM library used by the ngIRCd daemon must be able to access its
  20. configuration file, so don't forget to check permissions and run something
  21. like this: "chmod 644 /etc/pam.d/ngircd".
  22. Please note ONE VERY IMPORTANT THING:
  23. All the PAM modules are executed with the privileges of the user ngIRCd
  24. is running as. Therefore a lot of PAM modules aren't working as expected,
  25. because they need root privileges ("pam_unix", for example)!
  26. Only PAM modules not(!) requiring root privileges (such as "pam_pgsql",
  27. "pam_mysql", "pam_opendirectory" ...) can be used in conjunction with ngIRCd.
  28. More Examples:
  29. * Use an own "password file" for ngIRCd:
  30. Note: you can use the htpasswd(1) utility of Apache to manage password
  31. files used by pam_pwdfile, see "man htpasswd"!
  32. /etc/pam.d/ngircd:
  33. auth required pam_pwdfile.so pwdfile=/etc/ngircd/ngircd.passwd