knox-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From kmin...@apache.org
Subject svn commit: r1623855 - in /knox: site/ site/books/knox-0-4-0/ trunk/
Date Tue, 09 Sep 2014 16:14:55 GMT
Author: kminder
Date: Tue Sep  9 16:14:54 2014
New Revision: 1623855

URL: http://svn.apache.org/r1623855
Log:
Upgrade doxia-module-markdown to fix index.html generation issue.

Modified:
    knox/site/books/knox-0-4-0/deployment-overview.png
    knox/site/books/knox-0-4-0/deployment-provider.png
    knox/site/books/knox-0-4-0/deployment-service.png
    knox/site/books/knox-0-4-0/runtime-overview.png
    knox/site/books/knox-0-4-0/runtime-request-processing.png
    knox/site/index.html
    knox/site/issue-tracking.html
    knox/site/license.html
    knox/site/mail-lists.html
    knox/site/project-info.html
    knox/trunk/pom.xml

Modified: knox/site/books/knox-0-4-0/deployment-overview.png
URL: http://svn.apache.org/viewvc/knox/site/books/knox-0-4-0/deployment-overview.png?rev=1623855&r1=1623854&r2=1623855&view=diff
==============================================================================
Binary files - no diff available.

Modified: knox/site/books/knox-0-4-0/deployment-provider.png
URL: http://svn.apache.org/viewvc/knox/site/books/knox-0-4-0/deployment-provider.png?rev=1623855&r1=1623854&r2=1623855&view=diff
==============================================================================
Binary files - no diff available.

Modified: knox/site/books/knox-0-4-0/deployment-service.png
URL: http://svn.apache.org/viewvc/knox/site/books/knox-0-4-0/deployment-service.png?rev=1623855&r1=1623854&r2=1623855&view=diff
==============================================================================
Binary files - no diff available.

Modified: knox/site/books/knox-0-4-0/runtime-overview.png
URL: http://svn.apache.org/viewvc/knox/site/books/knox-0-4-0/runtime-overview.png?rev=1623855&r1=1623854&r2=1623855&view=diff
==============================================================================
Binary files - no diff available.

Modified: knox/site/books/knox-0-4-0/runtime-request-processing.png
URL: http://svn.apache.org/viewvc/knox/site/books/knox-0-4-0/runtime-request-processing.png?rev=1623855&r1=1623854&r2=1623855&view=diff
==============================================================================
Binary files - no diff available.

Modified: knox/site/index.html
URL: http://svn.apache.org/viewvc/knox/site/index.html?rev=1623855&r1=1623854&r2=1623855&view=diff
==============================================================================
--- knox/site/index.html (original)
+++ knox/site/index.html Tue Sep  9 16:14:54 2014
@@ -1,17 +1,17 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.3 at Jun 13, 2014 -->
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
-    <title>Knox Gateway - </title>
-    <style type="text/css" media="all">
-      @import url("./css/maven-base.css");
-      @import url("./css/maven-theme.css");
-      @import url("./css/site.css");
-    </style>
-    <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20140613" />
-    <meta http-equiv="Content-Language" content="en" />
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2014-09-09 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+    <title>Knox Gateway &#x2013; Introduction</title>
+    <style type="text/css" media="all">
+      @import url("./css/maven-base.css");
+      @import url("./css/maven-theme.css");
+      @import url("./css/site.css");
+    </style>
+    <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
+    <meta name="Date-Revision-yyyymmdd" content="20140909" />
+    <meta http-equiv="Content-Language" content="en" />
                                                     
 <script type="text/javascript">var _gaq = _gaq || [];
                 _gaq.push(['_setAccount', 'UA-27188762-1']);
@@ -25,148 +25,148 @@
                 '.google-analytics.com/ga.js';
                 var s = document.getElementsByTagName('script')[0];
                 s.parentNode.insertBefore(ga, s);
-                })();</script>
-                      
-        </head>
-  <body class="composite">
-    <div id="banner">
-                                      <a href="./" id="bannerLeft">
-                                                <img src="images/knox-logo.gif" alt="Knox
Gateway" />
-                </a>
-                                            <a href="./" id="bannerRight">
-                                                <img src="images/apache-logo.gif" alt="Apache
Incubator" />
-                </a>
-            <div class="clear">
-        <hr/>
-      </div>
-    </div>
-    <div id="breadcrumbs">
-            
-                    
-                <div class="xleft">
-                                  <a href="index.html" title="Knox">Knox</a>
-        &gt;
-    
-      </div>
-            <div class="xright">                    <a href="https://git-wip-us.apache.org/repos/asf/knox.git"
class="externalLink" title="Git">Git</a>
-            |
-                        <a href="https://svn.apache.org/repos/asf/knox" class="externalLink"
title="Svn">Svn</a>
-            |
-                        <a href="https://issues.apache.org/jira/browse/KNOX" class="externalLink"
title="Jira">Jira</a>
-            |
-                        <a href="https://cwiki.apache.org/confluence/display/KNOX/Index"
class="externalLink" title="Wiki">Wiki</a>
-              
-                    
-                &nbsp;| <span id="publishDate">Last Published: 2014-06-13</span>
-              &nbsp;| <span id="projectVersion">Version: 0.0.0-SNAPSHOT</span>
-            </div>
-      <div class="clear">
-        <hr/>
-      </div>
-    </div>
-    <div id="leftColumn">
-      <div id="navcolumn">
-             
-                    
-                                <h5>Knox</h5>
-                  <ul>
-                  <li class="none">
-            <strong>Home</strong>
-          </li>
-                  <li class="none">
-                          <a href="https://cwiki.apache.org/confluence/display/KNOX/News"
class="externalLink" title="News">News</a>
-            </li>
-                  <li class="none">
-                          <a href="license.html" title="License">License</a>
-            </li>
-          </ul>
-                       <h5>Documentation</h5>
-                  <ul>
-                  <li class="none">
-                          <a href="books/knox-0-4-0/knox-0-4-0.html" title="User's Guide">User's
Guide</a>
-            </li>
-                  <li class="none">
-                          <a href="books/knox-0-4-0/knox-0-4-0.html#Quick+Start" title="Quick
Start">Quick Start</a>
-            </li>
-                  <li class="none">
-                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Dependencies"
class="externalLink" title="Dependencies">Dependencies</a>
-            </li>
-                  <li class="none">
-                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Index"
class="externalLink" title="Wiki">Wiki</a>
-            </li>
-          </ul>
-                       <h5>Releases</h5>
-                  <ul>
-                  <li class="none">
-                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Release+0.4.0"
class="externalLink" title="0.4.0">0.4.0</a>
-            </li>
-                  <li class="none">
-                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Release+0.3.0"
class="externalLink" title="0.3.0">0.3.0</a>
-            </li>
-                  <li class="none">
-                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Release+0.2.0"
class="externalLink" title="0.2.0">0.2.0</a>
-            </li>
-                  <li class="none">
-                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Roadmap"
class="externalLink" title="Roadmap">Roadmap</a>
-            </li>
-          </ul>
-                       <h5>Processes</h5>
-                  <ul>
-                  <li class="none">
-                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Build+Process"
class="externalLink" title="Build">Build</a>
-            </li>
-                  <li class="none">
-                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Release+Process"
class="externalLink" title="Release">Release</a>
-            </li>
-                  <li class="none">
-                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Contribution+Process"
class="externalLink" title="Contribute">Contribute</a>
-            </li>
-                  <li class="none">
-                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Site+Maintenance"
class="externalLink" title="Site Maintenance">Site Maintenance</a>
-            </li>
-          </ul>
-                       <h5>Resources</h5>
-                  <ul>
-                  <li class="none">
-                          <a href="https://git-wip-us.apache.org/repos/asf/knox.git" class="externalLink"
title="Product Source">Product Source</a>
-            </li>
-                  <li class="none">
-                          <a href="https://svn.apache.org/repos/asf/knox" class="externalLink"
title="Site Source">Site Source</a>
-            </li>
-                  <li class="none">
-                          <a href="team-list.html" title="Project Team">Project Team</a>
-            </li>
-                  <li class="none">
-                          <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a>
-            </li>
-                  <li class="none">
-                          <a href="issue-tracking.html" title="Issue Tracking">Issue
Tracking</a>
-            </li>
-          </ul>
-                       <h5>ASF</h5>
-                  <ul>
-                  <li class="none">
-                          <a href="http://www.apache.org/foundation/how-it-works.html"
class="externalLink" title="How Apache Works">How Apache Works</a>
-            </li>
-                  <li class="none">
-                          <a href="http://www.apache.org/foundation/" class="externalLink"
title="Foundation">Foundation</a>
-            </li>
-                  <li class="none">
-                          <a href="http://www.apache.org/foundation/sponsorship.html"
class="externalLink" title="Sponsoring Apache">Sponsoring Apache</a>
-            </li>
-                  <li class="none">
-                          <a href="http://www.apache.org/foundation/thanks.html" class="externalLink"
title="Thanks">Thanks</a>
-            </li>
-          </ul>
-                             <a href="http://maven.apache.org/" title="Built by Maven"
class="poweredBy">
-        <img class="poweredBy" alt="Built by Maven" src="./images/logos/maven-feather.png"
/>
-      </a>
-                   
-                    
-            </div>
-    </div>
-    <div id="bodyColumn">
-      <div id="contentBox">
+                })();</script>
+                      
+        </head>
+  <body class="composite">
+    <div id="banner">
+                                      <a href="./" id="bannerLeft">
+                                                <img src="images/knox-logo.gif" alt="Knox
Gateway" />
+                </a>
+                                            <a href="./" id="bannerRight">
+                                                <img src="images/apache-logo.gif" alt="Apache
Incubator" />
+                </a>
+            <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="breadcrumbs">
+            
+                    
+                <div class="xleft">
+                                  <a href="index.html" title="Knox">Knox</a>
+        &gt;
+    Introduction
+      </div>
+            <div class="xright">                    <a href="https://git-wip-us.apache.org/repos/asf/knox.git"
class="externalLink" title="Git">Git</a>
+            |
+                        <a href="https://svn.apache.org/repos/asf/knox" class="externalLink"
title="Svn">Svn</a>
+            |
+                        <a href="https://issues.apache.org/jira/browse/KNOX" class="externalLink"
title="Jira">Jira</a>
+            |
+                        <a href="https://cwiki.apache.org/confluence/display/KNOX/Index"
class="externalLink" title="Wiki">Wiki</a>
+              
+                    
+                &nbsp;| <span id="publishDate">Last Published: 2014-09-09</span>
+              &nbsp;| <span id="projectVersion">Version: 0.0.0-SNAPSHOT</span>
+            </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="leftColumn">
+      <div id="navcolumn">
+             
+                    
+                                <h5>Knox</h5>
+                  <ul>
+                  <li class="none">
+            <strong>Home</strong>
+          </li>
+                  <li class="none">
+                          <a href="https://cwiki.apache.org/confluence/display/KNOX/News"
class="externalLink" title="News">News</a>
+            </li>
+                  <li class="none">
+                          <a href="license.html" title="License">License</a>
+            </li>
+          </ul>
+                       <h5>Documentation</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="books/knox-0-4-0/knox-0-4-0.html" title="User's Guide">User's
Guide</a>
+            </li>
+                  <li class="none">
+                          <a href="books/knox-0-4-0/knox-0-4-0.html#Quick+Start" title="Quick
Start">Quick Start</a>
+            </li>
+                  <li class="none">
+                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Dependencies"
class="externalLink" title="Dependencies">Dependencies</a>
+            </li>
+                  <li class="none">
+                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Index"
class="externalLink" title="Wiki">Wiki</a>
+            </li>
+          </ul>
+                       <h5>Releases</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Release+0.4.0"
class="externalLink" title="0.4.0">0.4.0</a>
+            </li>
+                  <li class="none">
+                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Release+0.3.0"
class="externalLink" title="0.3.0">0.3.0</a>
+            </li>
+                  <li class="none">
+                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Release+0.2.0"
class="externalLink" title="0.2.0">0.2.0</a>
+            </li>
+                  <li class="none">
+                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Roadmap"
class="externalLink" title="Roadmap">Roadmap</a>
+            </li>
+          </ul>
+                       <h5>Processes</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Build+Process"
class="externalLink" title="Build">Build</a>
+            </li>
+                  <li class="none">
+                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Release+Process"
class="externalLink" title="Release">Release</a>
+            </li>
+                  <li class="none">
+                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Contribution+Process"
class="externalLink" title="Contribute">Contribute</a>
+            </li>
+                  <li class="none">
+                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Site+Maintenance"
class="externalLink" title="Site Maintenance">Site Maintenance</a>
+            </li>
+          </ul>
+                       <h5>Resources</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="https://git-wip-us.apache.org/repos/asf/knox.git" class="externalLink"
title="Product Source">Product Source</a>
+            </li>
+                  <li class="none">
+                          <a href="https://svn.apache.org/repos/asf/knox" class="externalLink"
title="Site Source">Site Source</a>
+            </li>
+                  <li class="none">
+                          <a href="team-list.html" title="Project Team">Project Team</a>
+            </li>
+                  <li class="none">
+                          <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+            </li>
+                  <li class="none">
+                          <a href="issue-tracking.html" title="Issue Tracking">Issue
Tracking</a>
+            </li>
+          </ul>
+                       <h5>ASF</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/how-it-works.html"
class="externalLink" title="How Apache Works">How Apache Works</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/" class="externalLink"
title="Foundation">Foundation</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/sponsorship.html"
class="externalLink" title="Sponsoring Apache">Sponsoring Apache</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/thanks.html" class="externalLink"
title="Thanks">Thanks</a>
+            </li>
+          </ul>
+                             <a href="http://maven.apache.org/" title="Built by Maven"
class="poweredBy">
+        <img class="poweredBy" alt="Built by Maven" src="./images/logos/maven-feather.png"
/>
+      </a>
+                   
+                    
+            </div>
+    </div>
+    <div id="bodyColumn">
+      <div id="contentBox">
         <!-- -
 Licensed to the Apache Software Foundation (ASF) under one or more
 contributor license agreements.  See the NOTICE file distributed with
@@ -181,25 +181,65 @@ Unless required by applicable law or agr
 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. --><div class="section"><h2>Introduction<a
name="Introduction"></a></h2><p>The Apache Knox Gateway is a REST API
Gateway for interacting with Hadoop clusters.</p><p>The Knox Gateway provides
a single access point for all REST interactions with Hadoop clusters.</p><p>In
this capacity, the Knox Gateway is able to provide valuable functionality to aid in the control,<br
/> integration, monitoring and automation of critical administrative and analytical needs
of the enterprise.</p>
+limitations under the License. --><div class="section">
+<h2><a name="Introduction"></a>Introduction</h2>
+<p>The Apache Knox Gateway is a REST API Gateway for interacting with Hadoop clusters.</p>
+<p>The Knox Gateway provides a single access point for all REST interactions with Hadoop
clusters.</p>
+<p>In this capacity, the Knox Gateway is able to provide valuable functionality to
aid in the control,<br /> integration, monitoring and automation of critical administrative
and analytical needs of the enterprise.</p>
+
 <ul>
-  <li>Authentication (LDAP and Active Directory Authentication Provider)</li>
-  <li>Federation/SSO (HTTP Header Based Identity Federation)</li>
-  <li>Authorization (Service Level Authorization)</li>
-  <li>Auditing</li>
-</ul><p>While there are a number of benefits for unsecured Hadoop clusters,<br
/> the Knox Gateway also complements the kerberos secured cluster quite nicely.</p><p>Coupled
with proper network isolation of a Kerberos secured Hadoop cluster,<br /> the Knox Gateway
provides the enterprise with a solution that:</p>
+  
+<li>Authentication (LDAP and Active Directory Authentication Provider)</li>
+  
+<li>Federation/SSO (HTTP Header Based Identity Federation)</li>
+  
+<li>Authorization (Service Level Authorization)</li>
+  
+<li>Auditing</li>
+</ul>
+<p>While there are a number of benefits for unsecured Hadoop clusters,<br />
the Knox Gateway also complements the kerberos secured cluster quite nicely.</p>
+<p>Coupled with proper network isolation of a Kerberos secured Hadoop cluster,<br
/> the Knox Gateway provides the enterprise with a solution that:</p>
+
 <ul>
-  <li>Integrates well with enterprise identity management solutions</li>
-  <li>Protects the details of the Hadoop cluster deployment (hosts and ports are hidden
from endusers)</li>
-  <li>Simplifies the number of services that clients need to interact with</li>
-</ul><p><img src="http://knox.apache.org/images/knox-overview.gif" alt="alt
text" /></p></div><div class="section"><h2>Overview<a name="Overview"></a></h2><p>The
Knox API Gateway is designed as a reverse proxy with consideration for pluggability in the
areas of<br /> policy enforcement, through providers and the backend services for which
it proxies requests.</p><p>Policy enforcement ranges from authentication/federation,
authorization, audit, dispatch, hostmapping<br /> and content rewrite rules. Policy
is enforced through a chain of providers that are defined within the topology<br />
deployment descriptor for each Hadoop cluster gated by Knox. The cluster definition is also
defined<br /> within the topology deployment descriptor and provides the Knox Gateway
with the layout of the Hadoop<br /> cluster for purposes of routing and translation
between user facing URLs and Hadoop cluster internals.</p><p>Each Hadoop cluster
that is protected by Knox has its set of REST APIs represent
 ed by a single cluster specific<br /> application context path. This allows the Knox
Gateway to both protect multiple Hadoop clusters and present<br /> the REST API consumer
with a single endpoint for access to all of the Hadoop services required, across the<br
/> multiple clusters.</p><p>Simply by writing a topology deployment descriptor
to the topologies directory of the Knox installation, a<br /> new Hadoop cluster definition
is processed, the policy enforcement providers are configured and the application<br />
context path is made available for use by API consumers.</p></div><div class="section"><h2>Supported
Hadoop Services<a name="Supported_Hadoop_Services"></a></h2><p>The
following Hadoop services have integrations with the Knox Gateway:</p><p>WebHDFS
(HDFS)<br /> Templeton (HCatalog)<br /> Stargate (HBase)<br /> Oozie<br
/> Hive/JDBC<br /></p></div><div class="section"><h2>Authentication<a
name="Authentication"></a></h2><p>Providers with the role of authentication
are respo
 nsible for collecting credentials presented by the API<br /> consumer, validating them
and communicating the successful or failed authentication to the client or the<br />
rest of the provider chain.</p><p>Out of the box, the Knox Gateway provides the
Shiro authentication provider. This is a provider that leverages<br /> the Apache Shiro
project for authenticating BASIC credentials against an LDAP user store. There is support
for<br /> OpenLDAP, ApacheDS and Microsoft Active Directory.</p></div><div
class="section"><h2>Federation/SSO<a name="FederationSSO"></a></h2><p>For
customers that require credentials to be presented to a limited set of trusted entities within
the enterprise,<br /> the Knox Gateway may be configured to federate the authenticated
identity from an external authentication event.<br /> This is done through providers
with the role of federation. The out of the box federation provider is a simple<br />
mechanism for propagating the identity through HTTP Headers that 
 specify the username and group for the authenticated<br /> user. This has been built
with vendor usecases such as SiteMinder and IBM Tivoli Access Manager.</p></div><div
class="section"><h2>Authorization<a name="Authorization"></a></h2><p>The
authorization role is used by providers that make access decisions for the requested resources
based on the<br /> effective user identity context. This identity context is determined
by the authentication provider and the identity<br /> assertion provider mapping rules.
Evaluation of the identity contexts user and group principals against a set of<br />
access policies is done by the authorization provider in order to determine whether access
should be granted to<br /> the effective user for the requested resource.</p><p>Out
of the box, the Knox Gateway provides an ACL based authorization provider that evaluates rules
that comprise<br /> of username, groups and ip addresses. These ACLs are bound to and
protect resources at the service level.<br
  /> That is, they protect access to the Hadoop services themselves based on user, group
and remote ip address.</p></div><div class="section"><h2>Audit<a
name="Audit"></a></h2><p>The ability to determine what actions were taken
by whom during some period of time is provided by the auditing<br /> capabilities of
the Knox Gateway. The facility is built on an extension of the Log4j framework and may be
extended<br /> by replacing the out of the box implementation with another.</p></div>
-      </div>
-    </div>
-    <div class="clear">
-      <hr/>
-    </div>
-    <div id="footer">
-      <div class="xright">
+  
+<li>Integrates well with enterprise identity management solutions</li>
+  
+<li>Protects the details of the Hadoop cluster deployment (hosts and ports are hidden
from endusers)</li>
+  
+<li>Simplifies the number of services that clients need to interact with</li>
+</ul>
+<p><img src="http://knox.apache.org/images/knox-overview.gif" alt="alt text" /></p></div>
+<div class="section">
+<h2><a name="Overview"></a>Overview</h2>
+<p>The Knox API Gateway is designed as a reverse proxy with consideration for pluggability
in the areas of<br /> policy enforcement, through providers and the backend services
for which it proxies requests.</p>
+<p>Policy enforcement ranges from authentication/federation, authorization, audit,
dispatch, hostmapping<br /> and content rewrite rules. Policy is enforced through a
chain of providers that are defined within the topology<br /> deployment descriptor
for each Hadoop cluster gated by Knox. The cluster definition is also defined<br />
within the topology deployment descriptor and provides the Knox Gateway with the layout of
the Hadoop<br /> cluster for purposes of routing and translation between user facing
URLs and Hadoop cluster internals.</p>
+<p>Each Hadoop cluster that is protected by Knox has its set of REST APIs represented
by a single cluster specific<br /> application context path. This allows the Knox Gateway
to both protect multiple Hadoop clusters and present<br /> the REST API consumer with
a single endpoint for access to all of the Hadoop services required, across the<br />
multiple clusters.</p>
+<p>Simply by writing a topology deployment descriptor to the topologies directory of
the Knox installation, a<br /> new Hadoop cluster definition is processed, the policy
enforcement providers are configured and the application<br /> context path is made
available for use by API consumers.</p></div>
+<div class="section">
+<h2><a name="Supported_Hadoop_Services"></a>Supported Hadoop Services</h2>
+<p>The following Hadoop services have integrations with the Knox Gateway:</p>
+<p>WebHDFS (HDFS)<br /> Templeton (HCatalog)<br /> Stargate (HBase)<br
/> Oozie<br /> Hive/JDBC<br /></p></div>
+<div class="section">
+<h2><a name="Authentication"></a>Authentication</h2>
+<p>Providers with the role of authentication are responsible for collecting credentials
presented by the API<br /> consumer, validating them and communicating the successful
or failed authentication to the client or the<br /> rest of the provider chain.</p>
+<p>Out of the box, the Knox Gateway provides the Shiro authentication provider. This
is a provider that leverages<br /> the Apache Shiro project for authenticating BASIC
credentials against an LDAP user store. There is support for<br /> OpenLDAP, ApacheDS
and Microsoft Active Directory.</p></div>
+<div class="section">
+<h2><a name="FederationSSO"></a>Federation/SSO</h2>
+<p>For customers that require credentials to be presented to a limited set of trusted
entities within the enterprise,<br /> the Knox Gateway may be configured to federate
the authenticated identity from an external authentication event.<br /> This is done
through providers with the role of federation. The out of the box federation provider is a
simple<br /> mechanism for propagating the identity through HTTP Headers that specify
the username and group for the authenticated<br /> user. This has been built with vendor
usecases such as SiteMinder and IBM Tivoli Access Manager.</p></div>
+<div class="section">
+<h2><a name="Authorization"></a>Authorization</h2>
+<p>The authorization role is used by providers that make access decisions for the requested
resources based on the<br /> effective user identity context. This identity context
is determined by the authentication provider and the identity<br /> assertion provider
mapping rules. Evaluation of the identity context&#x2019;s user and group principals against
a set of<br /> access policies is done by the authorization provider in order to determine
whether access should be granted to<br /> the effective user for the requested resource.</p>
+<p>Out of the box, the Knox Gateway provides an ACL based authorization provider that
evaluates rules that comprise<br /> of username, groups and ip addresses. These ACLs
are bound to and protect resources at the service level.<br /> That is, they protect
access to the Hadoop services themselves based on user, group and remote ip address.</p></div>
+<div class="section">
+<h2><a name="Audit"></a>Audit</h2>
+<p>The ability to determine what actions were taken by whom during some period of time
is provided by the auditing<br /> capabilities of the Knox Gateway. The facility is
built on an extension of the Log4j framework and may be extended<br /> by replacing
the out of the box implementation with another.</p></div>
+      </div>
+    </div>
+    <div class="clear">
+      <hr/>
+    </div>
+    <div id="footer">
+      <div class="xright">
               <?xml version="1.0" encoding="UTF-8"?>
 <footer>
   <div class="row span12">Apache Knox Gateway, Apache, the Apache feather logo and
the Apache Knox Gateway project logos
@@ -208,11 +248,11 @@ limitations under the License. --><div c
   <div class="row span12">
     <a href="https://cwiki.apache.org/confluence/display/KNOX/Privacy+Policy">Privacy
Policy</a>
   </div>
-</footer>
-            </div>
-      <div class="clear">
-        <hr/>
-      </div>
-    </div>
-  </body>
-</html>
+</footer>
+            </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+  </body>
+</html>

Modified: knox/site/issue-tracking.html
URL: http://svn.apache.org/viewvc/knox/site/issue-tracking.html?rev=1623855&r1=1623854&r2=1623855&view=diff
==============================================================================
--- knox/site/issue-tracking.html (original)
+++ knox/site/issue-tracking.html Tue Sep  9 16:14:54 2014
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2014-08-07 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2014-09-09 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
       @import url("./css/site.css");
     </style>
     <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20140807" />
+    <meta name="Date-Revision-yyyymmdd" content="20140909" />
     <meta http-equiv="Content-Language" content="en" />
                                                     
 <script type="text/javascript">var _gaq = _gaq || [];
@@ -57,7 +57,7 @@
                         <a href="https://cwiki.apache.org/confluence/display/KNOX/Index"
class="externalLink" title="Wiki">Wiki</a>
               
                     
-                &nbsp;| <span id="publishDate">Last Published: 2014-08-07</span>
+                &nbsp;| <span id="publishDate">Last Published: 2014-09-09</span>
               &nbsp;| <span id="projectVersion">Version: 0.0.0-SNAPSHOT</span>
             </div>
       <div class="clear">

Modified: knox/site/license.html
URL: http://svn.apache.org/viewvc/knox/site/license.html?rev=1623855&r1=1623854&r2=1623855&view=diff
==============================================================================
--- knox/site/license.html (original)
+++ knox/site/license.html Tue Sep  9 16:14:54 2014
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2014-08-07 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2014-09-09 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
       @import url("./css/site.css");
     </style>
     <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20140807" />
+    <meta name="Date-Revision-yyyymmdd" content="20140909" />
     <meta http-equiv="Content-Language" content="en" />
                                                     
 <script type="text/javascript">var _gaq = _gaq || [];
@@ -57,7 +57,7 @@
                         <a href="https://cwiki.apache.org/confluence/display/KNOX/Index"
class="externalLink" title="Wiki">Wiki</a>
               
                     
-                &nbsp;| <span id="publishDate">Last Published: 2014-08-07</span>
+                &nbsp;| <span id="publishDate">Last Published: 2014-09-09</span>
               &nbsp;| <span id="projectVersion">Version: 0.0.0-SNAPSHOT</span>
             </div>
       <div class="clear">

Modified: knox/site/mail-lists.html
URL: http://svn.apache.org/viewvc/knox/site/mail-lists.html?rev=1623855&r1=1623854&r2=1623855&view=diff
==============================================================================
--- knox/site/mail-lists.html (original)
+++ knox/site/mail-lists.html Tue Sep  9 16:14:54 2014
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2014-08-07 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2014-09-09 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
       @import url("./css/site.css");
     </style>
     <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20140807" />
+    <meta name="Date-Revision-yyyymmdd" content="20140909" />
     <meta http-equiv="Content-Language" content="en" />
                                                     
 <script type="text/javascript">var _gaq = _gaq || [];
@@ -57,7 +57,7 @@
                         <a href="https://cwiki.apache.org/confluence/display/KNOX/Index"
class="externalLink" title="Wiki">Wiki</a>
               
                     
-                &nbsp;| <span id="publishDate">Last Published: 2014-08-07</span>
+                &nbsp;| <span id="publishDate">Last Published: 2014-09-09</span>
               &nbsp;| <span id="projectVersion">Version: 0.0.0-SNAPSHOT</span>
             </div>
       <div class="clear">

Modified: knox/site/project-info.html
URL: http://svn.apache.org/viewvc/knox/site/project-info.html?rev=1623855&r1=1623854&r2=1623855&view=diff
==============================================================================
--- knox/site/project-info.html (original)
+++ knox/site/project-info.html Tue Sep  9 16:14:54 2014
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2014-08-07 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2014-09-09 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
       @import url("./css/site.css");
     </style>
     <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20140807" />
+    <meta name="Date-Revision-yyyymmdd" content="20140909" />
     <meta http-equiv="Content-Language" content="en" />
                                                     
 <script type="text/javascript">var _gaq = _gaq || [];
@@ -57,7 +57,7 @@
                         <a href="https://cwiki.apache.org/confluence/display/KNOX/Index"
class="externalLink" title="Wiki">Wiki</a>
               
                     
-                &nbsp;| <span id="publishDate">Last Published: 2014-08-07</span>
+                &nbsp;| <span id="publishDate">Last Published: 2014-09-09</span>
               &nbsp;| <span id="projectVersion">Version: 0.0.0-SNAPSHOT</span>
             </div>
       <div class="clear">

Modified: knox/trunk/pom.xml
URL: http://svn.apache.org/viewvc/knox/trunk/pom.xml?rev=1623855&r1=1623854&r2=1623855&view=diff
==============================================================================
--- knox/trunk/pom.xml (original)
+++ knox/trunk/pom.xml Tue Sep  9 16:14:54 2014
@@ -242,7 +242,7 @@
                         <dependency>
                             <groupId>org.apache.maven.doxia</groupId>
                             <artifactId>doxia-module-markdown</artifactId>
-                            <version>1.3</version>
+                            <version>1.6</version>
                         </dependency>
                     </dependencies>
                     <configuration>



Mime
View raw message