add doc

docs/_includes/themes/zeppelin/_navigation.html

@@ -45,6 +45,7 @@
                 <li><a href="{{BASE_PATH}}/manual/interpreterinstallation.html">Interpreter Installation</a></li>
                 <!--<li><a href="{{BASE_PATH}}/manual/dynamicinterpreterload.html">Dynamic Interpreter Loading</a></li>-->
                 <li><a href="{{BASE_PATH}}/manual/dependencymanagement.html">Interpreter Dependency Management</a></li>
+                <li><a href="{{BASE_PATH}}/manual/userimpersonation.html">Interpreter User Impersonation</a></li>
                 <li role="separator" class="divider"></li>
                 <li class="title"><span><b>Available Interpreters</b><span></li>
                 <li><a href="{{BASE_PATH}}/interpreter/alluxio.html">Alluxio</a></li>

docs/index.md

@@ -141,6 +141,7 @@ Join to our [Mailing list](https://zeppelin.apache.org/community.html) and repor
 * Usage
   * [Interpreter Installation](./manual/interpreterinstallation.html): Install not only community managed interpreters but also 3rd party interpreters
   * [Interpreter Dependency Management](./manual/dependencymanagement.html) when you include external libraries to interpreter
+  * [Interpreter User Impersonation](./manual/userimpersonation.html) when you want to run interpreter as end user
 * Available Interpreters: currently, about 20 interpreters are available in Apache Zeppelin.
 
 ####Display System

docs/manual/processenduser.md

@@ -0,0 +1,66 @@
+---
+layout: page
+title: "Run zeppelin interpreter process as web front end user"
+description: "Set up zeppelin interpreter process as web front end user."
+group: manual
+---
+<!--
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+{% include JB/setup %}
+
+## Run zeppelin interpreter process as web front end user
+
+ * Enable shiro auth in shiro.ini
+
+```
+[users]
+user1 = password1, role1
+user2 = password2, role2
+```
+
+ * Enable password-less ssh for the user you want to impersonate (say user1).
+
+```
+adduser user1
+#ssh-keygen (optional if you don't already have generated ssh-key.
+ssh user1@localhost mkdir -p .ssh
+cat ~/.ssh/id_rsa.pub | ssh user1@localhost 'cat >> .ssh/authorized_keys'
+```
+
+ * Start zeppelin server.
+ 
+<hr>
+<div class="row">
+  <div class="col-md-12">
+         <b> Screenshot </b>
+         <br /><br />
+  </div>
+  <div class="col-md-12" >
+      <a data-lightbox="compiler" href="../assets/themes/zeppelin/img/screenshots/user-impersonation.gif">
+        <img class="img-responsive" src="../assets/themes/zeppelin/img/screenshots/user-impersonation.gif" />
+      </a>
+    
+  </div>
+</div>
+<hr>
+ 
+ * Go to interpreter setting page, and enable "User Impersonate" in any of the interpreter (in my example its shell interpreter)
+ 
+ * Test with a simple paragraph
+
+```
+%sh
+whoami
+```
+