From 9adfe82a1785aa6a7baefb435072a0a81dfb13cb Mon Sep 17 00:00:00 2001 From: Günther Deschner Date: Thu, 18 Jul 2013 19:09:14 +0200 Subject: pam_winbind: update documentation for "DIR" krb5ccname pragma. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Guenther Signed-off-by: Günther Deschner Reviewed-by: Jeremy Allison Autobuild-User(master): Jeremy Allison Autobuild-Date(master): Wed Jul 24 02:43:10 CEST 2013 on sn-devel-104 --- docs-xml/manpages/pam_winbind.conf.5.xml | 39 ++++++++++++++++++++++++-------- examples/pam_winbind/pam_winbind.conf | 3 ++- 2 files changed, 31 insertions(+), 11 deletions(-) diff --git a/docs-xml/manpages/pam_winbind.conf.5.xml b/docs-xml/manpages/pam_winbind.conf.5.xml index 8c36719a8b..020cb674e7 100644 --- a/docs-xml/manpages/pam_winbind.conf.5.xml +++ b/docs-xml/manpages/pam_winbind.conf.5.xml @@ -106,16 +106,35 @@ krb5_ccache_type = [type] - When pam_winbind is configured to try kerberos authentication - by enabling the krb5_auth option, it can - store the retrieved Ticket Granting Ticket (TGT) in a - credential cache. The type of credential cache can be set with - this option. Currently the only supported value is: - FILE. In that case a credential cache in - the form of /tmp/krb5cc_UID will be created, where UID is - replaced with the numeric user id. Leave empty to just do - kerberos authentication without having a ticket cache after the - logon has succeeded. This setting is empty by default. + When pam_winbind is configured to try kerberos authentication by + enabling the krb5_auth option, it can + store the retrieved Ticket Granting Ticket (TGT) in a credential + cache. The type of credential cache can be controlled with this + option. The supported values are: FILE + and DIR (when the DIR type is supported + by the system's Kerberos library). In case of FILE a credential + cache in the form of /tmp/krb5cc_UID will be created - in case + of DIR it will be located under the /run/user/UID/krb5cc + directory. UID is replaced with the numeric user id. + + It is also possible to define custom filepaths and use the "%u" + pattern in order to substitue the numeric user id. + Examples: + + + + krb5_ccache_type = DIR:/run/user/%u/krb5cc + This will create a credential cache file in the specified directory. + + + krb5_ccache_type = FILE:/tmp/krb5cc_%u + This will create a credential cache file. + + + + Leave empty to just do kerberos authentication without + having a ticket cache after the logon has succeeded. + This setting is empty by default. diff --git a/examples/pam_winbind/pam_winbind.conf b/examples/pam_winbind/pam_winbind.conf index dd0b112f30..87bc388a45 100644 --- a/examples/pam_winbind/pam_winbind.conf +++ b/examples/pam_winbind/pam_winbind.conf @@ -3,6 +3,7 @@ # # /etc/security/pam_winbind.conf # +# For more details see man pam_winbind.conf(5) [global] @@ -19,7 +20,7 @@ # authenticate using kerberos ;krb5_auth = no -# when using kerberos, request a "FILE" krb5 credential cache type +# when using kerberos, request a "FILE" or "DIR" krb5 credential cache type # (leave empty to just do krb5 authentication but not have a ticket # afterwards) ;krb5_ccache_type = -- cgit