From eb804d4cb37189c2127a10b446ef412930a032bd Mon Sep 17 00:00:00 2001 From: Jr Aquino Date: Tue, 23 Aug 2011 10:33:15 -0700 Subject: Improve sudorule documentation Added brief explanations for the various Sudo components in the top level doc. Added doc entries for RunAs User and RunAs Group. https://fedorahosted.org/freeipa/ticket/1657 --- ipalib/plugins/sudorule.py | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/ipalib/plugins/sudorule.py b/ipalib/plugins/sudorule.py index 17859472c..55affa653 100644 --- a/ipalib/plugins/sudorule.py +++ b/ipalib/plugins/sudorule.py @@ -22,6 +22,15 @@ give certain users (or groups of users) the ability to run some (or all) commands as root or another user while providing an audit trail of the commands and their arguments. +FreeIPA provides a means to configure the various aspects of Sudo: + Users: The user(s)/group(s) allowed to envoke Sudo. + Hosts: The host(s)/hostgroup(s) which the user is allowed to to invoke Sudo. + Allow Command: The specific command(s) permited to be run via Sudo. + Deny Command: The specific command(s) prohibited to be run via Sudo. + RunAsUser: The user(s) or group(s) of users whose rights Sudo will be invoked with. + RunAsGroup: The group(s) whose gid rights Sudo will be invoked with. + Options: The various Sudoers Options that can modify Sudo's behavior. + FreeIPA provides a designated binddn to use with Sudo located at: uid=sudo,cn=sysaccounts,cn=etc,dc=example,dc=com @@ -158,10 +167,12 @@ class sudorule(LDAPObject): ), Str('ipasudorunas_user?', label=_('RunAs User'), + doc=_('Run as a user or any user within a specified group'), flags=['no_create', 'no_update', 'no_search'], ), Str('ipasudorunas_group?', label=_('RunAs Group'), + doc=_('Run with the gid of a specified POSIX group '), flags=['no_create', 'no_update', 'no_search'], ), Str('externaluser?', validate_externaluser, -- cgit