From 6c66f3c0bfc6c655c53e552ba8ef487700a6e0bc Mon Sep 17 00:00:00 2001 From: Guido Günther Date: Sun, 31 Mar 2013 16:24:35 +0200 Subject: New upstream version 3.8.0 --- README | 54 +++++++++++++++++++++++++++++++++++++++++++----------- 1 file changed, 43 insertions(+), 11 deletions(-) (limited to 'README') diff --git a/README b/README index 9eb5bae..8a2d036 100644 --- a/README +++ b/README @@ -4,22 +4,54 @@ it to be part of GNOME. Configuration ============= -Configuration settings are handled via gconf. +Configuration settings are handled via gsettings. You can set the principal that is used to acquire tickets via: -gconftool-2 --type=string --set /apps/krb5-auth-dialog/principal "principal@YOUR.REALM" - -You can hide the tray icon via: -gconftool-2 --type=bool --set /apps/krb5-auth-dialog/show_trayicon false +gsettings set org.gnome.KrbAuthDialog principal "principal@YOUR.REALM" You can set the time of the first password prompt via: -gconftool-2 --type=int --set /apps/krb5-auth-dialog/prompt_minutes 30 +gsettings set org.gnome.KrbAuthDialog prompt-minutes 30 You can set the principals pkinit identifier via: -gconftool-2 --type=string --set /apps/krb5-auth-dialog/pk_userid "FILE:/path/to/user.pem,/path/to/user.key" +gsettings set org.gnome.KrbAuthDialog pk-userid "FILE:/path/to/user.pem,/path/to/user.key" + or if you're using a smartcard: -gconftool-2 --type=string --set /apps/krb5-auth-dialog/pk_userid "PKCS11:/usr/lib/opensc/opensc-pkcs11.so" +gsettings set org.gnome.KrbAuthDialog pk-userid "PKCS11:/usr/lib/opensc/opensc-pkcs11.so" + +DBus API +======== +You can request a ticket granting ticket via DBus: + + dbus-send --print-reply --type=method_call \ + --dest=org.gnome.KrbAuthDialog \ + /org/gnome/KrbAuthDialog \ + org.gnome.KrbAuthDialog.acquireTgt \ + string:'principal' + +If the sent principal doesn't match the one currently in the ticket cache the +request fails. To request a TGT for the "default" principal use string:''. +See examples/tgt-signals.py for information about sent DBus signals. + + +Plugins +======= +Plugins are currently disabled by default. Individual plugins can be enabled via gsettings: + +Enable pam and dummy plugions: +. + +You can set the principal that is used to acquire tickets via: +gsettings set org.gnome.KrbAuthDialog principal "principal@YOUR.REALM" + +You can set the time of the first password prompt via: +gsettings set org.gnome.KrbAuthDialog prompt-minutes 30 + +You can set the principals pkinit identifier via: +gsettings set org.gnome.KrbAuthDialog pk-userid "FILE:/path/to/user.pem,/path/to/user.key" + +or if you're using a smartcard: +gsettings set org.gnome.KrbAuthDialog pk-userid "PKCS11:/usr/lib/opensc/opensc-pkcs11.so" DBus API ======== @@ -39,13 +71,13 @@ See examples/tgt-signals.py for information about sent DBus signals. Plugins ======= -Plugins are currently disabled by default. To enable them you have to set the gconf key: +Plugins are currently disabled by default. Individual plugins can be enabled via gsettings: Enable pam and dummy plugions: -gconftool-2 --set --list-type=string --type=list /apps/krb5-auth-dialog/plugins/enabled [pam,dummy] +gsettings set org.gnome.KrbAuthDialog.plugins enabled "['pam', 'dummy']" To list currently enabled plugins: -gconftool-2 --get --list-type=string /apps/krb5-auth-dialog/plugins/enabled +gsettings get org.gnome.KrbAuthDialog.plugins enabled A Note on Translations -- cgit