README 2.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152
  1. pam_group — PAM module for group access
  2. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  3. DESCRIPTION
  4. The pam_group PAM module does not authenticate the user, but instead it grants
  5. group memberships (in the credential setting phase of the authentication
  6. module) to the user. Such memberships are based on the service they are
  7. applying for.
  8. By default rules for group memberships are taken from config file /etc/security
  9. /group.conf.
  10. This module's usefulness relies on the file-systems accessible to the user. The
  11. point being that once granted the membership of a group, the user may attempt
  12. to create a setgid binary with a restricted group ownership. Later, when the
  13. user is not given membership to this group, they can recover group membership
  14. with the precompiled binary. The reason that the file-systems that the user has
  15. access to are so significant, is the fact that when a system is mounted nosuid
  16. the user is unable to create or execute such a binary file. For this module to
  17. provide any level of security, all file-systems that the user has write access
  18. to should be mounted nosuid.
  19. The pam_group module functions in parallel with the /etc/group file. If the
  20. user is granted any groups based on the behavior of this module, they are
  21. granted in addition to those entries /etc/group (or equivalent).
  22. EXAMPLES
  23. These are some example lines which might be specified in /etc/security/
  24. group.conf.
  25. Running 'xsh' on tty* (any ttyXXX device), the user 'us' is given access to the
  26. floppy (through membership of the floppy group)
  27. xsh;tty*&!ttyp*;us;Al0000-2400;floppy
  28. Running 'xsh' on tty* (any ttyXXX device), the users 'sword', 'pike' and
  29. 'shield' are given access to games (through membership of the floppy group)
  30. after work hours.
  31. xsh; tty* ;sword|pike|shield;!Wk0900-1800;games, sound
  32. xsh; tty* ;*;Al0900-1800;floppy
  33. Any member of the group 'admin' running 'xsh' on tty*, is granted access (at
  34. any time) to the group 'plugdev'
  35. xsh; tty* ;%admin;Al0000-2400;plugdev