You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@apex.apache.org by da...@apache.org on 2016/07/29 20:14:35 UTC

[1/2] apex-core git commit: Documentation for secure impersonation

Repository: apex-core
Updated Branches:
  refs/heads/master cba9a6abd -> 49dd3c4c5


Documentation for secure impersonation


Project: http://git-wip-us.apache.org/repos/asf/apex-core/repo
Commit: http://git-wip-us.apache.org/repos/asf/apex-core/commit/ba6ffc2e
Tree: http://git-wip-us.apache.org/repos/asf/apex-core/tree/ba6ffc2e
Diff: http://git-wip-us.apache.org/repos/asf/apex-core/diff/ba6ffc2e

Branch: refs/heads/master
Commit: ba6ffc2e41ddb036d65f8b2fe65412dce9e97fa1
Parents: 7ca1ed1
Author: Pramod Immaneni <pr...@datatorrent.com>
Authored: Thu Jul 28 05:18:22 2016 -0700
Committer: Pramod Immaneni <pr...@datatorrent.com>
Committed: Thu Jul 28 12:59:37 2016 -0700

----------------------------------------------------------------------
 docs/security.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/apex-core/blob/ba6ffc2e/docs/security.md
----------------------------------------------------------------------
diff --git a/docs/security.md b/docs/security.md
index 89ed3c8..fb4a486 100644
--- a/docs/security.md
+++ b/docs/security.md
@@ -143,6 +143,34 @@ As explained earlier new tokens are obtained before the old ones expire. How ear
 </property>
 ```
 
+### Impersonation
+
+The CLI program `apex` supports Hadoop proxy user impersonation, in allowing applications to be launched and other operations to be performed as a different user than the one specified by the Kerberos credentials. The Kerberos credentials are still used for authentication. This is useful in scenarios where a system using `apex` has to support multiple users but only has a single set of Kerberos credentials, those of a system user.
+
+####Usage
+
+To use this feature, the following environment variable should be set to the user name of the user being impersonated, before running `apex` and the operations will be performed as that user. For example, if launching an application, the application will run as the specified user and not as the user specified by the Kerberos credentials.
+
+```
+HADOOP_USER_NAME=<username>
+```
+
+####Hadoop Configuration
+
+For this feature to work, additional configuration settings are needed in Hadoop. These settings would allow a specified user, such as a system user, to impersonate other users. The example snippet below shows these settings. In this example, the specified user can impersonate users belonging to any group and can do so running from any host. Note that the user specified here is different from the user specified above in usage, there it is the user that is being impersonated and here it is the impersonating user such as a system user.
+
+```xml
+<property>
+  <name>hadoop.proxyuser.<username>.groups</name>
+  <value>*</value>
+</property>
+
+<property>
+  <name>hadoop.proxyuser.<username>.hosts</name>
+  <value>*</value>
+</property>
+```
+
 Security architecture
 ----------------------
 


[2/2] apex-core git commit: Merge branch 'secure-impersonation' of github.com:PramodSSImmaneni/apex-core

Posted by da...@apache.org.
Merge branch 'secure-impersonation' of github.com:PramodSSImmaneni/apex-core


Project: http://git-wip-us.apache.org/repos/asf/apex-core/repo
Commit: http://git-wip-us.apache.org/repos/asf/apex-core/commit/49dd3c4c
Tree: http://git-wip-us.apache.org/repos/asf/apex-core/tree/49dd3c4c
Diff: http://git-wip-us.apache.org/repos/asf/apex-core/diff/49dd3c4c

Branch: refs/heads/master
Commit: 49dd3c4c58e0336fb97e5d95c02244fea0fdd9d7
Parents: cba9a6a ba6ffc2
Author: David Yan <da...@datatorrent.com>
Authored: Fri Jul 29 13:14:12 2016 -0700
Committer: David Yan <da...@datatorrent.com>
Committed: Fri Jul 29 13:14:12 2016 -0700

----------------------------------------------------------------------
 docs/security.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
----------------------------------------------------------------------