[jira] [Created] (HADOOP-12879) Web authentication documentation is contradicting

["Wei-Chiu Chuang (JIRA)" <ji...@apache.org>]

Wei-Chiu Chuang created HADOOP-12879:
----------------------------------------

             Summary: Web authentication documentation is contradicting
                 Key: HADOOP-12879
                 URL: https://issues.apache.org/jira/browse/HADOOP-12879
             Project: Hadoop Common
          Issue Type: Bug
    Affects Versions: 3.0.0
            Reporter: Wei-Chiu Chuang


Hi, I noticed recently folks are really focusing on documentation. (Kudos to +[~ajisakaa], +[~brahmareddy], +[~iwasakims], +[~daisuke.kobayashi], +[~jzhuge] and more). 

I've been following Hadoop documentation to set up web UI authentication, but it seems to be contradicting between docs, for example, for web UI Kerberos keytab settings:

* in _Hadoop in Secure Mode_ (SecureMode.md), HDFS daemons have distinct web UI authentication configs, for example, for name node that's {{dfs.web.authentication.kerberos.keytab}},
* but in _Authentication for Hadoop HTTP web-consoles_ (HttpAuthentication.md), it mentions a Hadoop-wide config: {{hadoop.http.authentication.kerberos.keytab}}; 
* finally, in _Hadoop Auth, Java HTTP SPNEGO - Server Side Configuration_(Configuration.md), it says{{\[PREFIX.\]kerberos.principal}} should be used.

They all seem to mean one thing, but different configuration names. So it's a bit of confusing, or even contradicting to each other. Can we improve it?



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)