1pam_keyring(8)              System Manager's Manual             pam_keyring(8)
2
3
4

NAME

6       pam_keyring - A PAM module that execute gnome-keyring-daemon and unlock
7       the default keyring
8

OVERVIEW

10       The pam_keyring module allows GNOME users to automatically unlock their
11       default  keyring  using  their  system password when they log in.  This
12       allows the data in the default keyring to be used  more  transparently.
13       Ideally,  users should only every have to enter one password (or physi‐
14       cal token, etc.): the password they use to authenticate  themselves  to
15       the system when they log in.
16
17

NASTY DETAILS

19       This module does the following:
20
21        1. Executes gnome-keyring-daemon
22
23        2.  Sets  the  GNOME_KEYRING_SOCKET  and GNOME_KEYRING_PID environment
24       variables
25
26        3. Unlocks the default GNOME keyring using the user's system password
27
28
29       PAM can be a difficult and dangerous beast to configure.   Misconfigur‐
30       ing  PAM  can  result in it being very difficult to log in to your com‐
31       puter.
32
33
34       Here is a portion of an example service configuration that demonstrates
35       the use of pam_keyring:
36
37
38              [...]
39              auth     sufficient  /lib/security/$ISA/pam_unix.so likeauth nullok
40              auth     optional    /lib/security/$ISA/pam_keyring.so try_first_pass
41              session  optional    /lib/security/$ISA/pam_keyring.so
42              [...]
43
44       PAM's service configuration files are generally found in /etc/pam.d.
45
46

AUTHORS

48       W. Michael Petullo <mike@flyn.org>
49
50
51
52                                                                pam_keyring(8)