Package:PAM base

Revision as of 10:58, December 22, 2014 by Mgorny (Talk | contribs)

sys-auth/pambase


Source Repository:Funtoo Overlay

Summary: Base configuration files for different PAM implementations

Use Flags

cracklib
Enable pam_cracklib module on system authentication stack. This produces warnings when changing password to something easily crackable. It requires the same USE flag to be enabled on sys-libs/pam or system login might be impossible.
consolekit
Enable pam_ck_connector module on local system logins. This allows for console logins to make use of ConsoleKit authorization.
gnome-keyring
Enable pam_gnome_keyring module on system login stack. This enables proper Gnome Keyring access to logins, whether they are done with the login shell, a Desktop Manager or a remote login systems such as SSH.
debug
Enable debug information logging on syslog(3) for all the modules supporting this in the system authentication and system login stacks.
passwdqc
Enable pam_passwdqc module on system auth stack for password quality validation. This is an alternative to pam_cracklib producing warnings, rejecting or providing example passwords when changing your system password. It is used by default by OpenWall GNU/*/Linux and by FreeBSD.
mktemp
Enable pam_mktemp module on system auth stack for session handling. This module creates a private temporary directory for the user, and sets TMP and TMPDIR accordingly.
ssh
Enable pam_ssh module on system auth stack for authentication and session handling. This module will accept as password the passphrase of a private SSH key (one of ~/.ssh/id_rsa, ~/.ssh/id_dsa or ~/.ssh/identity), and will spawn an ssh-agent instance to cache the open key.
sha512
Switch Linux-PAM's pam_unix module to use sha512 for passwords hashes rather than MD5. This option requires >=sys-libs/pam-1.0.1 built against >=sys-libs/glibc-2.7, if it's built against an earlier version, it will silently be ignored, and MD5 hashes will be used. All the passwords changed after this USE flag is enabled will be saved to the shadow file hashed using SHA512 function. The password previously saved will be left untouched. Please note that while SHA512-hashed passwords will still be recognised if the USE flag is removed, the shadow file will not be compatible with systems using an earlier glibc version.
kerberos
Enable pam_krb5 module on system auth stack, as an alternative to pam_unix. If Kerberos authentication succeed, only pam_unix will be ignore, and all the other modules will proceed as usual, including Gnome Keyring and other session modules. It requires sys-libs/pam as PAM implementation.
minimal
Disables the standard PAM modules that provide extra information to users on login; this includes pam_tally (and pam_tally2 for Linux PAM 1.1 and later), pam_lastlog, pam_motd and other similar modules. This might not be a good idea on a multi-user system but could reduce slightly the overhead on single-user non-networked systems.

PAM base

Current design

Installed files

Currently the following files are installed by pambase:

/etc/pam.d/login
/etc/pam.d/passwd
/etc/pam.d/su
/etc/pam.d/system-auth
/etc/pam.d/system-login
/etc/pam.d/system-local-login
/etc/pam.d/system-remote-login
/etc/pam.d/system-services
/etc/pam.d/other

The files starting with 'system' prefix are intended to be used by other PAM files. In particular:

  1. system-auth is used whenever user authentication is desired. It is included in PAM files for account manipulation tools (passwd, chsh, ...), authenticated daemons (imap, pop3), xscreensaver (for screen locking) and system-login.
  2. system-login is used whenever login is done. It is currently included only in system-local-login and system-remote-login.
  3. system-local-login is used whenever local system login is performed. It is used by login and display managers.
  4. system-remote-login is used whenever remote system login is performed. It is used by sshd.
  5. system-services is used whenever system daemons are started. It is used by start-stop-daemon and systemd.