6.17. pam_localuser - require users to be listed in /etc/passwd

pam_localuser.so [ debug ] [ file= /path/passwd ]

6.17.1. DESCRIPTION

pam_localuser is a PAM module to help implementing site-wide login policies, where they typically include a subset of the network's users and a few accounts that are local to a particular workstation. Using pam_localuser and pam_wheel or pam_listfile is an effective way to restrict access to either local users and/or a subset of the network's users.

This could also be implemented using pam_listfile.so and a very short awk script invoked by cron, but it's common enough to have been separated out.

6.17.2. OPTIONS

  • debug

    • Print debug information.
  • file=/path/passwd

    • Use a file other than /etc/passwd .

6.17.3. MODULE TYPES PROVIDED

All module types ( account , auth , password and session ) are provided.

6.17.4. RETURN VALUES

  • PAM_SUCCESS

    • The new localuser was set successfully.
  • PAM_BUF_ERR

    • Memory buffer error.
  • PAM_CONV_ERR

    • The conversation method supplied by the application failed to obtain the username.
  • PAM_INCOMPLETE

    • The conversation method supplied by the application returned PAM_CONV_AGAIN.
  • PAM_SERVICE_ERR

    • The user name is not valid or the passwd file is unavailable.
  • PAM_PERM_DENIED

    • The user is not listed in the passwd file.

6.17.5. EXAMPLES

Add the following lines to /etc/pam.d/su to allow only local users or group wheel to use su.

account sufficient pam_localuser.so
account required pam_wheel.so

6.17.6. AUTHOR

pam_localuser was written by Nalin Dahyabhai <nalin@redhat.com>.