From: bugreport%peshkin.net <>
Date: Fri, 4 Apr 2008 11:47:43 +0000 (+0000)
Subject: Bug 204498 Add su (setuser) function
X-Git-Tag: bugzilla-3.1.3~49
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=bc0925fb0b9beeced6b806ffeb73c397af00d526;p=thirdparty%2Fbugzilla.git

Bug 204498 Add su (setuser) function
Patch by A. Karl Kornel <karl@kornel.name>
r=joel, a=justdave
---

diff --git a/docs/en/xml/administration.xml b/docs/en/xml/administration.xml
index 16223ce1ee..8c79e6fb77 100644
--- a/docs/en/xml/administration.xml
+++ b/docs/en/xml/administration.xml
@@ -520,6 +520,43 @@
           </listitem>
         </itemizedlist>
       </section>
+      
+      <section id="impersonatingusers">
+        <title>Impersonating Users</title>
+        
+        <para>
+        There may be times when an administrator would like to do something as
+        another user.  The <command>sudo</command> feature may be used to do 
+        this.
+        </para>
+        
+        <note>
+          <para>
+          To use the sudo feature, you must be in the
+          <emphasis>bz_sudoers</emphasis> group.  By default, all
+          administrators are in this group.</para>
+        </note>
+        
+        <para>
+        If you have access to use this feature, you should notice a link
+        next to your login name (in the footer) titled "sudo".  Click on the 
+        link.  This will take you to a page where you will see a description of 
+        the feature and instructions on how to use it.  After reading the text, 
+        simply enter the login of the user you would like to impersonate and 
+        press the button.</para>
+        
+        <para>
+        As long as you are using this feature, everything you do will be done 
+        as if you were logged in as the user you are impersonating.</para>
+        
+        <warning>
+          <para>
+          The user you are impersonating will not be told about what you are 
+          doing.  If you do anything that results in mail being sent, that 
+          mail will appear to be from the user you are impersonating.  You 
+          should be extremely careful while using this feature.</para>
+        </warning>
+      </section>
     </section>
   </section>