README 2.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970
  1. pam_tty_audit — Enable or disable TTY auditing for specified users
  2. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  3. DESCRIPTION
  4. The pam_tty_audit PAM module is used to enable or disable TTY auditing. By
  5. default, the kernel does not audit input on any TTY.
  6. OPTIONS
  7. disable=patterns
  8. For each user matching patterns, disable TTY auditing. This overrides any
  9. previous enable option matching the same user name on the command line. See
  10. NOTES for further description of patterns.
  11. enable=patterns
  12. For each user matching patterns, enable TTY auditing. This overrides any
  13. previous disable option matching the same user name on the command line.
  14. See NOTES for further description of patterns.
  15. open_only
  16. Set the TTY audit flag when opening the session, but do not restore it when
  17. closing the session. Using this option is necessary for some services that
  18. don't fork() to run the authenticated session, such as sudo.
  19. log_passwd
  20. Log keystrokes when ECHO mode is off but ICANON mode is active. This is the
  21. mode in which the tty is placed during password entry. By default,
  22. passwords are not logged. This option may not be available on older kernels
  23. (3.9?).
  24. NOTES
  25. When TTY auditing is enabled, it is inherited by all processes started by that
  26. user. In particular, daemons restarted by a user will still have TTY auditing
  27. enabled, and audit TTY input even by other users unless auditing for these
  28. users is explicitly disabled. Therefore, it is recommended to use disable=* as
  29. the first option for most daemons using PAM.
  30. To view the data that was logged by the kernel to audit use the command
  31. aureport --tty.
  32. The patterns are comma separated lists of glob patterns or ranges of uids. A
  33. range is specified as min_uid:max_uid where one of these values can be empty.
  34. If min_uid is empty only user with the uid max_uid will be matched. If max_uid
  35. is empty users with the uid greater than or equal to min_uid will be matched.
  36. Please note that passwords in some circumstances may be logged by TTY auditing
  37. even if the log_passwd is not used. For example, all input to an ssh session
  38. will be logged - even if there is a password being typed into some software
  39. running at the remote host because only the local TTY state affects the local
  40. TTY auditing.
  41. EXAMPLES
  42. Audit all administrative actions.
  43. session required pam_tty_audit.so disable=* enable=root
  44. AUTHOR
  45. pam_tty_audit was written by Miloslav Trmač <mitr@redhat.com>. The log_passwd
  46. option was added by Richard Guy Briggs <rgb@redhat.com>.