Author: lmccay
Date: Tue Jul 23 21:27:15 2019
New Revision: 1863668
URL: http://svn.apache.org/viewvc?rev=1863668&view=rev
Log:
Update for 1.3.0 Release
Added:
knox/trunk/books/1.4.0/
knox/trunk/books/1.4.0/admin_api.md
knox/trunk/books/1.4.0/admin_ui.md
knox/trunk/books/1.4.0/book.md
knox/trunk/books/1.4.0/book_client-details.md
knox/trunk/books/1.4.0/book_gateway-details.md
knox/trunk/books/1.4.0/book_getting-started.md
knox/trunk/books/1.4.0/book_knox-samples.md
knox/trunk/books/1.4.0/book_limitations.md
knox/trunk/books/1.4.0/book_service-details.md
knox/trunk/books/1.4.0/book_topology_port_mapping.md
knox/trunk/books/1.4.0/book_troubleshooting.md
knox/trunk/books/1.4.0/book_ui_service_details.md
knox/trunk/books/1.4.0/config.md
knox/trunk/books/1.4.0/config_advanced_ldap.md
knox/trunk/books/1.4.0/config_audit.md
knox/trunk/books/1.4.0/config_authn.md
knox/trunk/books/1.4.0/config_authz.md
knox/trunk/books/1.4.0/config_ha.md
knox/trunk/books/1.4.0/config_hadoop_auth_provider.md
knox/trunk/books/1.4.0/config_id_assertion.md
knox/trunk/books/1.4.0/config_kerberos.md
knox/trunk/books/1.4.0/config_knox_sso.md
knox/trunk/books/1.4.0/config_knox_token.md
knox/trunk/books/1.4.0/config_ldap_authc_cache.md
knox/trunk/books/1.4.0/config_ldap_group_lookup.md
knox/trunk/books/1.4.0/config_metrics.md
knox/trunk/books/1.4.0/config_mutual_authentication_ssl.md
knox/trunk/books/1.4.0/config_pac4j_provider.md
knox/trunk/books/1.4.0/config_pam_authn.md
knox/trunk/books/1.4.0/config_preauth_sso_provider.md
knox/trunk/books/1.4.0/config_sandbox.md
knox/trunk/books/1.4.0/config_sso_cookie_provider.md
knox/trunk/books/1.4.0/config_tls_client_certificate_authentication_provider.md
knox/trunk/books/1.4.0/config_webappsec_provider.md
knox/trunk/books/1.4.0/dev-guide/
knox/trunk/books/1.4.0/dev-guide/admin-ui.md
knox/trunk/books/1.4.0/dev-guide/book.md
knox/trunk/books/1.4.0/dev-guide/deployment-overview.puml
knox/trunk/books/1.4.0/dev-guide/deployment-provider-simple.puml
knox/trunk/books/1.4.0/dev-guide/deployment-provider.puml
knox/trunk/books/1.4.0/dev-guide/deployment-service-simple.puml
knox/trunk/books/1.4.0/dev-guide/deployment-service.puml
knox/trunk/books/1.4.0/dev-guide/general_saml_flow.puml
knox/trunk/books/1.4.0/dev-guide/knox_monitoring_api.md
knox/trunk/books/1.4.0/dev-guide/knoxsso_integration.md
knox/trunk/books/1.4.0/dev-guide/runtime-overview.puml
knox/trunk/books/1.4.0/dev-guide/runtime-request-processing.puml
knox/trunk/books/1.4.0/img/
knox/trunk/books/1.4.0/img/adminui/
knox/trunk/books/1.4.0/img/adminui/image1.png (with props)
knox/trunk/books/1.4.0/img/adminui/image10.png (with props)
knox/trunk/books/1.4.0/img/adminui/image11.png (with props)
knox/trunk/books/1.4.0/img/adminui/image12.png (with props)
knox/trunk/books/1.4.0/img/adminui/image13.png (with props)
knox/trunk/books/1.4.0/img/adminui/image14.png (with props)
knox/trunk/books/1.4.0/img/adminui/image15.png (with props)
knox/trunk/books/1.4.0/img/adminui/image16.png (with props)
knox/trunk/books/1.4.0/img/adminui/image17.png (with props)
knox/trunk/books/1.4.0/img/adminui/image18.png (with props)
knox/trunk/books/1.4.0/img/adminui/image19.png (with props)
knox/trunk/books/1.4.0/img/adminui/image2.png (with props)
knox/trunk/books/1.4.0/img/adminui/image20.png (with props)
knox/trunk/books/1.4.0/img/adminui/image21.png (with props)
knox/trunk/books/1.4.0/img/adminui/image3.png (with props)
knox/trunk/books/1.4.0/img/adminui/image4.png (with props)
knox/trunk/books/1.4.0/img/adminui/image5.png (with props)
knox/trunk/books/1.4.0/img/adminui/image6.png (with props)
knox/trunk/books/1.4.0/img/adminui/image7.png (with props)
knox/trunk/books/1.4.0/img/adminui/image8.png (with props)
knox/trunk/books/1.4.0/img/adminui/image9.png (with props)
knox/trunk/books/1.4.0/img/adminui/plus-icon.png (with props)
knox/trunk/books/1.4.0/img/adminui/x-icon.png (with props)
knox/trunk/books/1.4.0/knox_cli.md
knox/trunk/books/1.4.0/likeised
knox/trunk/books/1.4.0/quick_start.md
knox/trunk/books/1.4.0/service_avatica.md
knox/trunk/books/1.4.0/service_config.md
knox/trunk/books/1.4.0/service_default_ha.md
knox/trunk/books/1.4.0/service_elasticsearch.md
knox/trunk/books/1.4.0/service_hbase.md
knox/trunk/books/1.4.0/service_hive.md
knox/trunk/books/1.4.0/service_kafka.md
knox/trunk/books/1.4.0/service_livy.md
knox/trunk/books/1.4.0/service_oozie.md
knox/trunk/books/1.4.0/service_service_test.md
knox/trunk/books/1.4.0/service_solr.md
knox/trunk/books/1.4.0/service_ssl_certificate_trust.md
knox/trunk/books/1.4.0/service_storm.md
knox/trunk/books/1.4.0/service_webhcat.md
knox/trunk/books/1.4.0/service_webhdfs.md
knox/trunk/books/1.4.0/service_yarn.md
knox/trunk/books/1.4.0/websocket-support.md
knox/trunk/books/1.4.0/x-forwarded-headers.md
Modified:
knox/site/books/knox-0-12-0/deployment-overview.png
knox/site/books/knox-0-12-0/deployment-provider.png
knox/site/books/knox-0-12-0/deployment-service.png
knox/site/books/knox-0-12-0/general_saml_flow.png
knox/site/books/knox-0-12-0/runtime-overview.png
knox/site/books/knox-0-12-0/runtime-request-processing.png
knox/site/books/knox-0-13-0/deployment-overview.png
knox/site/books/knox-0-13-0/deployment-provider.png
knox/site/books/knox-0-13-0/deployment-service.png
knox/site/books/knox-0-13-0/general_saml_flow.png
knox/site/books/knox-0-13-0/runtime-overview.png
knox/site/books/knox-0-13-0/runtime-request-processing.png
knox/site/books/knox-0-14-0/deployment-overview.png
knox/site/books/knox-0-14-0/deployment-provider.png
knox/site/books/knox-0-14-0/deployment-service.png
knox/site/books/knox-0-14-0/general_saml_flow.png
knox/site/books/knox-0-14-0/runtime-overview.png
knox/site/books/knox-0-14-0/runtime-request-processing.png
knox/site/books/knox-1-0-0/deployment-overview.png
knox/site/books/knox-1-0-0/deployment-provider.png
knox/site/books/knox-1-0-0/deployment-service.png
knox/site/books/knox-1-0-0/general_saml_flow.png
knox/site/books/knox-1-0-0/runtime-overview.png
knox/site/books/knox-1-0-0/runtime-request-processing.png
knox/site/books/knox-1-1-0/deployment-overview.png
knox/site/books/knox-1-1-0/deployment-provider.png
knox/site/books/knox-1-1-0/deployment-service.png
knox/site/books/knox-1-1-0/general_saml_flow.png
knox/site/books/knox-1-1-0/runtime-overview.png
knox/site/books/knox-1-1-0/runtime-request-processing.png
knox/site/books/knox-1-2-0/deployment-overview.png
knox/site/books/knox-1-2-0/deployment-provider.png
knox/site/books/knox-1-2-0/deployment-service.png
knox/site/books/knox-1-2-0/general_saml_flow.png
knox/site/books/knox-1-2-0/runtime-overview.png
knox/site/books/knox-1-2-0/runtime-request-processing.png
knox/site/books/knox-1-3-0/deployment-overview.png
knox/site/books/knox-1-3-0/deployment-provider.png
knox/site/books/knox-1-3-0/deployment-service.png
knox/site/books/knox-1-3-0/general_saml_flow.png
knox/site/books/knox-1-3-0/runtime-overview.png
knox/site/books/knox-1-3-0/runtime-request-processing.png
knox/site/index.html
knox/site/issue-management.html
knox/site/licenses.html
knox/site/mailing-lists.html
knox/site/project-info.html
knox/site/team.html
knox/trunk/build.xml
knox/trunk/src/site/markdown/index.md
knox/trunk/src/site/site.xml
Modified: knox/site/books/knox-0-12-0/deployment-overview.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-12-0/deployment-overview.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-12-0/deployment-provider.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-12-0/deployment-provider.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-12-0/deployment-service.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-12-0/deployment-service.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-12-0/general_saml_flow.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-12-0/general_saml_flow.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-12-0/runtime-overview.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-12-0/runtime-overview.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-12-0/runtime-request-processing.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-12-0/runtime-request-processing.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-13-0/deployment-overview.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-13-0/deployment-overview.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-13-0/deployment-provider.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-13-0/deployment-provider.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-13-0/deployment-service.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-13-0/deployment-service.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-13-0/general_saml_flow.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-13-0/general_saml_flow.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-13-0/runtime-overview.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-13-0/runtime-overview.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-13-0/runtime-request-processing.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-13-0/runtime-request-processing.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-14-0/deployment-overview.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-14-0/deployment-overview.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-14-0/deployment-provider.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-14-0/deployment-provider.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-14-0/deployment-service.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-14-0/deployment-service.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-14-0/general_saml_flow.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-14-0/general_saml_flow.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-14-0/runtime-overview.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-14-0/runtime-overview.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-14-0/runtime-request-processing.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-14-0/runtime-request-processing.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-0-0/deployment-overview.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-0-0/deployment-overview.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-0-0/deployment-provider.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-0-0/deployment-provider.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-0-0/deployment-service.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-0-0/deployment-service.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-0-0/general_saml_flow.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-0-0/general_saml_flow.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-0-0/runtime-overview.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-0-0/runtime-overview.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-0-0/runtime-request-processing.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-0-0/runtime-request-processing.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-1-0/deployment-overview.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-1-0/deployment-overview.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-1-0/deployment-provider.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-1-0/deployment-provider.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-1-0/deployment-service.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-1-0/deployment-service.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-1-0/general_saml_flow.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-1-0/general_saml_flow.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-1-0/runtime-overview.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-1-0/runtime-overview.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-1-0/runtime-request-processing.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-1-0/runtime-request-processing.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-2-0/deployment-overview.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-2-0/deployment-overview.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-2-0/deployment-provider.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-2-0/deployment-provider.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-2-0/deployment-service.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-2-0/deployment-service.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-2-0/general_saml_flow.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-2-0/general_saml_flow.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-2-0/runtime-overview.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-2-0/runtime-overview.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-2-0/runtime-request-processing.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-2-0/runtime-request-processing.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-3-0/deployment-overview.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-3-0/deployment-overview.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-3-0/deployment-provider.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-3-0/deployment-provider.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-3-0/deployment-service.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-3-0/deployment-service.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-3-0/general_saml_flow.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-3-0/general_saml_flow.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-3-0/runtime-overview.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-3-0/runtime-overview.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-1-3-0/runtime-request-processing.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-1-3-0/runtime-request-processing.png?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/index.html
URL:
http://svn.apache.org/viewvc/knox/site/index.html?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
--- knox/site/index.html (original)
+++ knox/site/index.html Tue Jul 23 21:27:15 2019
@@ -1,15 +1,15 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.8.1 from
src/site/markdown/index.md at 2019-06-23
+ | Generated by Apache Maven Doxia Site Renderer 1.8.1 from
src/site/markdown/index.md at 2019-07-23
| Rendered using Apache Maven Fluido Skin 1.7
-->
<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Revision-yyyymmdd" content="20190623" />
+ <meta name="Date-Revision-yyyymmdd" content="20190723" />
<meta http-equiv="Content-Language" content="en" />
- <title>Knox Gateway – Announcing Apache Knox 1.2.0!</title>
+ <title>Knox Gateway – Announcing Apache Knox 1.3.0!</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.7.min.css" />
<link rel="stylesheet" href="./css/site.css" />
<link rel="stylesheet" href="./css/print.css" media="print" />
@@ -40,7 +40,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2019-06-23</li>
+ <li id="publishDate">Last Published: 2019-07-23</li>
</ul>
</div>
<div class="row-fluid">
@@ -52,9 +52,9 @@
<li><a href="https://cwiki.apache.org/confluence/display/KNOX/News";
class="externalLink" title="News"><span class="none"></span>News</a></li>
<li><a href="licenses.html" title="License"><span
class="none"></span>License</a></li>
<li class="nav-header">Documentation</li>
- <li><a href="books/knox-1-2-0/user-guide.html" title="User's Guide"><span
class="none"></span>User's Guide</a></li>
- <li><a href="books/knox-1-2-0/dev-guide.html" title="Developer's
Guide"><span class="none"></span>Developer's Guide</a></li>
- <li><a href="books/knox-1-2-0/user-guide.html#Quick+Start" title="Quick
Start"><span class="none"></span>Quick Start</a></li>
+ <li><a href="books/knox-1-3-0/user-guide.html" title="User's Guide"><span
class="none"></span>User's Guide</a></li>
+ <li><a href="books/knox-1-3-0/dev-guide.html" title="Developer's
Guide"><span class="none"></span>Developer's Guide</a></li>
+ <li><a href="books/knox-1-3-0/user-guide.html#Quick+Start" title="Quick
Start"><span class="none"></span>Quick Start</a></li>
<li><a href="https://cwiki.apache.org/confluence/display/KNOX/Index";
class="externalLink" title="Wiki"><span class="none"></span>Wiki</a></li>
<li class="nav-header">Releases</li>
<li><a
href="https://cwiki.apache.org/confluence/display/KNOX/Apache+Knox+Releases";
class="externalLink" title="Releases"><span
class="none"></span>Releases</a></li>
@@ -105,7 +105,7 @@ See the License for the specific languag
limitations under the License.
-->
<div class="section">
-<h2><a name="Announcing_Apache_Knox_1.2.0.21"></a>Announcing Apache Knox
1.2.0!</h2></div>
+<h2><a name="Announcing_Apache_Knox_1.3.0.21"></a>Announcing Apache Knox
1.3.0!</h2></div>
<div class="section">
<h2><a
name="REST_API_and_Application_Gateway_for_the_Apache_Hadoop_Ecosystem"></a>REST
API and Application Gateway for the Apache Hadoop Ecosystem</h2>
<p>The Apache Knox™ Gateway is an Application Gateway for interacting
with the REST APIs and UIs of Apache Hadoop deployments.</p>
@@ -148,7 +148,7 @@ limitations under the License.
<p>Ambari<br /> WebHDFS (HDFS)<br /> Yarn RM<br /> Stargate (Apache HBase)<br
/> Apache Oozie<br /> Apache Hive/JDBC<br /> Apache Hive WebHCat (Templeton)<br
/> Apache Storm<br /> Apache Tinkerpop - Gremlin<br /> Apache
Avatica/Phoenix<br /> Apache SOLR<br /> Apache Livy (Spark REST Service)<br />
Kafka REST Proxy<br /></p></div>
<div class="section">
<h2><a name="Supported_Apache_Hadoop_ecosystem_UIs"></a>Supported Apache
Hadoop ecosystem UIs</h2>
-<p>Name Node UI<br /> Job History UI<br /> Yarn UI<br /> Apache Oozie UI<br />
Apache HBase UI<br /> Apache Spark UI<br /> Apache Ambari UI<br /> Apache
Ranger Admin Console<br /> Apache Zeppelin<br /> Apache NiFi<br /></p></div>
+<p>Name Node UI<br /> Job History UI<br /> Yarn UI<br /> Apache Oozie UI<br />
Apache HBase UI<br /> Apache Spark UI<br /> Apache Ambari UI<br /> Apache
Ranger Admin Console<br /> Apache Zeppelin<br /> Apache NiFi<br /> Hue<br />
Livy<br /></p></div>
<div class="section">
<h2><a name="Configuring_Support_for_new_services_and_UIs"></a>Configuring
Support for new services and UIs</h2>
<p>Apache Knox provides a configuration driven method of adding new routing
services.<br /> This enables for new Apache Hadoop REST APIs to come on board
very quickly and easily. It also enables<br /> users and developers to add
support for custom REST APIs to the Knox gateway as well.<br /> This capability
was added in release 0.6.0 and furthers the Knox commitment to extensibility
and integration.</p></div>
Modified: knox/site/issue-management.html
URL:
http://svn.apache.org/viewvc/knox/site/issue-management.html?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
--- knox/site/issue-management.html (original)
+++ knox/site/issue-management.html Tue Jul 23 21:27:15 2019
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.8.1 from
org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0:issue-management
at 2019-06-23
+ | Generated by Apache Maven Doxia Site Renderer 1.8.1 from
org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0:issue-management
at 2019-07-23
| Rendered using Apache Maven Fluido Skin 1.7
-->
<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Revision-yyyymmdd" content="20190623" />
+ <meta name="Date-Revision-yyyymmdd" content="20190723" />
<meta http-equiv="Content-Language" content="en" />
<title>Knox Gateway – Issue Management</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.7.min.css" />
@@ -40,7 +40,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2019-06-23</li>
+ <li id="publishDate">Last Published: 2019-07-23</li>
</ul>
</div>
<div class="row-fluid">
@@ -52,9 +52,9 @@
<li><a href="https://cwiki.apache.org/confluence/display/KNOX/News";
class="externalLink" title="News"><span class="none"></span>News</a></li>
<li><a href="licenses.html" title="License"><span
class="none"></span>License</a></li>
<li class="nav-header">Documentation</li>
- <li><a href="books/knox-1-2-0/user-guide.html" title="User's Guide"><span
class="none"></span>User's Guide</a></li>
- <li><a href="books/knox-1-2-0/dev-guide.html" title="Developer's
Guide"><span class="none"></span>Developer's Guide</a></li>
- <li><a href="books/knox-1-2-0/user-guide.html#Quick+Start" title="Quick
Start"><span class="none"></span>Quick Start</a></li>
+ <li><a href="books/knox-1-3-0/user-guide.html" title="User's Guide"><span
class="none"></span>User's Guide</a></li>
+ <li><a href="books/knox-1-3-0/dev-guide.html" title="Developer's
Guide"><span class="none"></span>Developer's Guide</a></li>
+ <li><a href="books/knox-1-3-0/user-guide.html#Quick+Start" title="Quick
Start"><span class="none"></span>Quick Start</a></li>
<li><a href="https://cwiki.apache.org/confluence/display/KNOX/Index";
class="externalLink" title="Wiki"><span class="none"></span>Wiki</a></li>
<li class="nav-header">Releases</li>
<li><a
href="https://cwiki.apache.org/confluence/display/KNOX/Apache+Knox+Releases";
class="externalLink" title="Releases"><span
class="none"></span>Releases</a></li>
Modified: knox/site/licenses.html
URL:
http://svn.apache.org/viewvc/knox/site/licenses.html?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
--- knox/site/licenses.html (original)
+++ knox/site/licenses.html Tue Jul 23 21:27:15 2019
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.8.1 from
org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0:licenses at
2019-06-23
+ | Generated by Apache Maven Doxia Site Renderer 1.8.1 from
org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0:licenses at
2019-07-23
| Rendered using Apache Maven Fluido Skin 1.7
-->
<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Revision-yyyymmdd" content="20190623" />
+ <meta name="Date-Revision-yyyymmdd" content="20190723" />
<meta http-equiv="Content-Language" content="en" />
<title>Knox Gateway – Project Licenses</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.7.min.css" />
@@ -40,7 +40,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2019-06-23</li>
+ <li id="publishDate">Last Published: 2019-07-23</li>
</ul>
</div>
<div class="row-fluid">
@@ -52,9 +52,9 @@
<li><a href="https://cwiki.apache.org/confluence/display/KNOX/News";
class="externalLink" title="News"><span class="none"></span>News</a></li>
<li class="active"><a href="#"><span class="none"></span>License</a></li>
<li class="nav-header">Documentation</li>
- <li><a href="books/knox-1-2-0/user-guide.html" title="User's Guide"><span
class="none"></span>User's Guide</a></li>
- <li><a href="books/knox-1-2-0/dev-guide.html" title="Developer's
Guide"><span class="none"></span>Developer's Guide</a></li>
- <li><a href="books/knox-1-2-0/user-guide.html#Quick+Start" title="Quick
Start"><span class="none"></span>Quick Start</a></li>
+ <li><a href="books/knox-1-3-0/user-guide.html" title="User's Guide"><span
class="none"></span>User's Guide</a></li>
+ <li><a href="books/knox-1-3-0/dev-guide.html" title="Developer's
Guide"><span class="none"></span>Developer's Guide</a></li>
+ <li><a href="books/knox-1-3-0/user-guide.html#Quick+Start" title="Quick
Start"><span class="none"></span>Quick Start</a></li>
<li><a href="https://cwiki.apache.org/confluence/display/KNOX/Index";
class="externalLink" title="Wiki"><span class="none"></span>Wiki</a></li>
<li class="nav-header">Releases</li>
<li><a
href="https://cwiki.apache.org/confluence/display/KNOX/Apache+Knox+Releases";
class="externalLink" title="Releases"><span
class="none"></span>Releases</a></li>
Modified: knox/site/mailing-lists.html
URL:
http://svn.apache.org/viewvc/knox/site/mailing-lists.html?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
--- knox/site/mailing-lists.html (original)
+++ knox/site/mailing-lists.html Tue Jul 23 21:27:15 2019
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.8.1 from
org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0:mailing-lists
at 2019-06-23
+ | Generated by Apache Maven Doxia Site Renderer 1.8.1 from
org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0:mailing-lists
at 2019-07-23
| Rendered using Apache Maven Fluido Skin 1.7
-->
<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Revision-yyyymmdd" content="20190623" />
+ <meta name="Date-Revision-yyyymmdd" content="20190723" />
<meta http-equiv="Content-Language" content="en" />
<title>Knox Gateway – Project Mailing Lists</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.7.min.css" />
@@ -40,7 +40,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2019-06-23</li>
+ <li id="publishDate">Last Published: 2019-07-23</li>
</ul>
</div>
<div class="row-fluid">
@@ -52,9 +52,9 @@
<li><a href="https://cwiki.apache.org/confluence/display/KNOX/News";
class="externalLink" title="News"><span class="none"></span>News</a></li>
<li><a href="licenses.html" title="License"><span
class="none"></span>License</a></li>
<li class="nav-header">Documentation</li>
- <li><a href="books/knox-1-2-0/user-guide.html" title="User's Guide"><span
class="none"></span>User's Guide</a></li>
- <li><a href="books/knox-1-2-0/dev-guide.html" title="Developer's
Guide"><span class="none"></span>Developer's Guide</a></li>
- <li><a href="books/knox-1-2-0/user-guide.html#Quick+Start" title="Quick
Start"><span class="none"></span>Quick Start</a></li>
+ <li><a href="books/knox-1-3-0/user-guide.html" title="User's Guide"><span
class="none"></span>User's Guide</a></li>
+ <li><a href="books/knox-1-3-0/dev-guide.html" title="Developer's
Guide"><span class="none"></span>Developer's Guide</a></li>
+ <li><a href="books/knox-1-3-0/user-guide.html#Quick+Start" title="Quick
Start"><span class="none"></span>Quick Start</a></li>
<li><a href="https://cwiki.apache.org/confluence/display/KNOX/Index";
class="externalLink" title="Wiki"><span class="none"></span>Wiki</a></li>
<li class="nav-header">Releases</li>
<li><a
href="https://cwiki.apache.org/confluence/display/KNOX/Apache+Knox+Releases";
class="externalLink" title="Releases"><span
class="none"></span>Releases</a></li>
Modified: knox/site/project-info.html
URL:
http://svn.apache.org/viewvc/knox/site/project-info.html?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
--- knox/site/project-info.html (original)
+++ knox/site/project-info.html Tue Jul 23 21:27:15 2019
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.8.1 from
org.apache.maven.plugins:maven-site-plugin:3.7.1:CategorySummaryDocumentRenderer
at 2019-06-23
+ | Generated by Apache Maven Doxia Site Renderer 1.8.1 from
org.apache.maven.plugins:maven-site-plugin:3.7.1:CategorySummaryDocumentRenderer
at 2019-07-23
| Rendered using Apache Maven Fluido Skin 1.7
-->
<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Revision-yyyymmdd" content="20190623" />
+ <meta name="Date-Revision-yyyymmdd" content="20190723" />
<meta http-equiv="Content-Language" content="en" />
<title>Knox Gateway – Project Information</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.7.min.css" />
@@ -40,7 +40,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2019-06-23</li>
+ <li id="publishDate">Last Published: 2019-07-23</li>
</ul>
</div>
<div class="row-fluid">
@@ -52,9 +52,9 @@
<li><a href="https://cwiki.apache.org/confluence/display/KNOX/News";
class="externalLink" title="News"><span class="none"></span>News</a></li>
<li><a href="licenses.html" title="License"><span
class="none"></span>License</a></li>
<li class="nav-header">Documentation</li>
- <li><a href="books/knox-1-2-0/user-guide.html" title="User's Guide"><span
class="none"></span>User's Guide</a></li>
- <li><a href="books/knox-1-2-0/dev-guide.html" title="Developer's
Guide"><span class="none"></span>Developer's Guide</a></li>
- <li><a href="books/knox-1-2-0/user-guide.html#Quick+Start" title="Quick
Start"><span class="none"></span>Quick Start</a></li>
+ <li><a href="books/knox-1-3-0/user-guide.html" title="User's Guide"><span
class="none"></span>User's Guide</a></li>
+ <li><a href="books/knox-1-3-0/dev-guide.html" title="Developer's
Guide"><span class="none"></span>Developer's Guide</a></li>
+ <li><a href="books/knox-1-3-0/user-guide.html#Quick+Start" title="Quick
Start"><span class="none"></span>Quick Start</a></li>
<li><a href="https://cwiki.apache.org/confluence/display/KNOX/Index";
class="externalLink" title="Wiki"><span class="none"></span>Wiki</a></li>
<li class="nav-header">Releases</li>
<li><a
href="https://cwiki.apache.org/confluence/display/KNOX/Apache+Knox+Releases";
class="externalLink" title="Releases"><span
class="none"></span>Releases</a></li>
Modified: knox/site/team.html
URL:
http://svn.apache.org/viewvc/knox/site/team.html?rev=1863668&r1=1863667&r2=1863668&view=diff
==============================================================================
--- knox/site/team.html (original)
+++ knox/site/team.html Tue Jul 23 21:27:15 2019
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.8.1 from
org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0:team at
2019-06-23
+ | Generated by Apache Maven Doxia Site Renderer 1.8.1 from
org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0:team at
2019-07-23
| Rendered using Apache Maven Fluido Skin 1.7
-->
<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Revision-yyyymmdd" content="20190623" />
+ <meta name="Date-Revision-yyyymmdd" content="20190723" />
<meta http-equiv="Content-Language" content="en" />
<title>Knox Gateway – Project Team</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.7.min.css" />
@@ -40,7 +40,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2019-06-23</li>
+ <li id="publishDate">Last Published: 2019-07-23</li>
</ul>
</div>
<div class="row-fluid">
@@ -52,9 +52,9 @@
<li><a href="https://cwiki.apache.org/confluence/display/KNOX/News";
class="externalLink" title="News"><span class="none"></span>News</a></li>
<li><a href="licenses.html" title="License"><span
class="none"></span>License</a></li>
<li class="nav-header">Documentation</li>
- <li><a href="books/knox-1-2-0/user-guide.html" title="User's Guide"><span
class="none"></span>User's Guide</a></li>
- <li><a href="books/knox-1-2-0/dev-guide.html" title="Developer's
Guide"><span class="none"></span>Developer's Guide</a></li>
- <li><a href="books/knox-1-2-0/user-guide.html#Quick+Start" title="Quick
Start"><span class="none"></span>Quick Start</a></li>
+ <li><a href="books/knox-1-3-0/user-guide.html" title="User's Guide"><span
class="none"></span>User's Guide</a></li>
+ <li><a href="books/knox-1-3-0/dev-guide.html" title="Developer's
Guide"><span class="none"></span>Developer's Guide</a></li>
+ <li><a href="books/knox-1-3-0/user-guide.html#Quick+Start" title="Quick
Start"><span class="none"></span>Quick Start</a></li>
<li><a href="https://cwiki.apache.org/confluence/display/KNOX/Index";
class="externalLink" title="Wiki"><span class="none"></span>Wiki</a></li>
<li class="nav-header">Releases</li>
<li><a
href="https://cwiki.apache.org/confluence/display/KNOX/Apache+Knox+Releases";
class="externalLink" title="Releases"><span
class="none"></span>Releases</a></li>
Added: knox/trunk/books/1.4.0/admin_api.md
URL:
http://svn.apache.org/viewvc/knox/trunk/books/1.4.0/admin_api.md?rev=1863668&view=auto
==============================================================================
--- knox/trunk/books/1.4.0/admin_api.md (added)
+++ knox/trunk/books/1.4.0/admin_api.md Tue Jul 23 21:27:15 2019
@@ -0,0 +1,538 @@
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You 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.
+--->
+
+### Admin API
+
+Access to the administrator functions of Knox are provided by the Admin REST
API.
+
+#### Admin API URL
+
+The URL mapping for the Knox Admin API is:
+
+| ------- |
-----------------------------------------------------------------------------
|
+| GatewayAPI |
`https://{gateway-host}:{gateway-port}/{gateway-path}/admin/api/v1`
|
+
+Please note that to access this API, the user attempting to connect must have
admin credentials configured on the LDAP Server
+
+
+##### API Documentation
+
+<table>
+ <thead>
+ <th>Resource</th>
+ <th>Operation</th>
+ <th>Description</th>
+ </thead>
+ <tr>
+ <td>version</td>
+ <td>GET</td>
+ <td>Get the gateway version and the associated version hash</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Request</td>
+ <td><pre>curl -iku admin:admin-password {GatewayAPI}/version -H
Accept:application/json</pre></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Response</td>
+ <td>
+ <pre>
+{
+ "ServerVersion" : {
+ "version" : "VERSION_ID",
+ "hash" : "VERSION_HASH"
+ }
+} </pre>
+ </td>
+ </tr>
+
+ <tr>
+ <td>topologies</td>
+ <td>GET</td>
+ <td>Get an enumeration of the topologies currently deployed in the
gateway.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Request</td>
+ <td><pre>curl -iku admin:admin-password {GatewayAPI}/topologies -H
Accept:application/json</pre></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Response</td>
+ <td>
+ <pre>
+{
+ "topologies" : {
+ "topology" : [ {
+ "name" : "admin",
+ "timestamp" : "1501508536000",
+ "uri" : "https://localhost:8443/gateway/admin";,
+ "href" :
"https://localhost:8443/gateway/admin/api/v1/topologies/admin";
+ }, {
+ "name" : "sandbox",
+ "timestamp" : "1501508536000",
+ "uri" : "https://localhost:8443/gateway/sandbox";,
+ "href" :
"https://localhost:8443/gateway/admin/api/v1/topologies/sandbox";
+ } ]
+ }
+} </pre>
+ </td>
+ </tr>
+
+ <tr>
+ <td>topologies/{id}</td>
+ <td>GET</td>
+ <td>Get a JSON representation of the specified topology</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Request</td>
+ <td><pre>curl -iku admin:admin-password {GatewayAPI}/topologies/admin -H
Accept:application/json</pre></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Response</td>
+ <td>
+ <pre>
+{
+ "name": "admin",
+ "providers": [{
+ "enabled": true,
+ "name": "ShiroProvider",
+ "params": {
+ "sessionTimeout": "30",
+ "main.ldapRealm": "org.apache.knox.gateway.shirorealm.KnoxLdapRealm",
+ "main.ldapRealm.userDnTemplate":
"uid={0},ou=people,dc=hadoop,dc=apache,dc=org",
+ "main.ldapRealm.contextFactory.url": "ldap://localhost:33389";,
+ "main.ldapRealm.contextFactory.authenticationMechanism": "simple",
+ "urls./**": "authcBasic"
+ },
+ "role": "authentication"
+ }, {
+ "enabled": true,
+ "name": "AclsAuthz",
+ "params": {
+ "knox.acl": "admin;*;*"
+ },
+ "role": "authorization"
+ }, {
+ "enabled": true,
+ "name": "Default",
+ "params": {},
+ "role": "identity-assertion"
+ }, {
+ "enabled": true,
+ "name": "static",
+ "params": {
+ "localhost": "sandbox,sandbox.hortonworks.com"
+ },
+ "role": "hostmap"
+ }],
+ "services": [{
+ "name": null,
+ "params": {},
+ "role": "KNOX",
+ "url": null
+ }],
+ "timestamp": 1406672646000,
+ "uri": "https://localhost:8443/gateway/admin";
+} </pre>
+ </td>
+ </tr>
+
+ <tr>
+ <td> </td>
+ <td>PUT</td>
+ <td>Add (and deploy) a topology</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Request</td>
+ <td><pre>curl -iku admin:admin-password {GatewayAPI}/topologies/mytopology
\
+ -X PUT \
+ -H Content-Type:application/xml
+ -d "@mytopology.xml"</pre></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Response</td>
+ <td>
+ <pre>
+<?xml version="1.0" encoding="UTF-8"?>
+<topology>
+ <uri>https://localhost:8443/gateway/mytopology</uri>
+ <name>mytopology</name>
+ <timestamp>1509720338000</timestamp>
+ <gateway>
+ <provider>
+ <role>authentication</role>
+ <name>ShiroProvider</name>
+ <enabled>true</enabled>
+ <param>
+ <name>sessionTimeout</name>
+ <value>30</value>
+ </param>
+ <param>
+ <name>main.ldapRealm</name>
+
<value>org.apache.knox.gateway.shirorealm.KnoxLdapRealm</value>
+ </param>
+ <param>
+ <name>main.ldapContextFactory</name>
+
<value>org.apache.knox.gateway.shirorealm.KnoxLdapContextFactory</value>
+ </param>
+ <param>
+ <name>main.ldapRealm.contextFactory</name>
+ <value>$ldapContextFactory</value>
+ </param>
+ <param>
+ <name>main.ldapRealm.userDnTemplate</name>
+
<value>uid={0},ou=people,dc=hadoop,dc=apache,dc=org</value>
+ </param>
+ <param>
+ <name>main.ldapRealm.contextFactory.url</name>
+ <value>ldap://localhost:33389</value>
+ </param>
+ <param>
+
<name>main.ldapRealm.contextFactory.authenticationMechanism</name>
+ <value>simple</value>
+ </param>
+ <param>
+ <name>urls./**</name>
+ <value>authcBasic</value>
+ </param>
+ </provider>
+ <provider>
+ <role>identity-assertion</role>
+ <name>Default</name>
+ <enabled>true</enabled>
+ </provider>
+ <provider>
+ <role>hostmap</role>
+ <name>static</name>
+ <enabled>true</enabled>
+ <param>
+ <name>localhost</name>
+ <value>sandbox,sandbox.hortonworks.com</value>
+ </param>
+ </provider>
+ </gateway>
+ <service>
+ <role>NAMENODE</role>
+ <url>hdfs://localhost:8020</url>
+ </service>
+ <service>
+ <role>JOBTRACKER</role>
+ <url>rpc://localhost:8050</url>
+ </service>
+ <service>
+ <role>WEBHDFS</role>
+ <url>http://localhost:50070/webhdfs</url>
+ </service>
+ <service>
+ <role>WEBHCAT</role>
+ <url>http://localhost:50111/templeton</url>
+ </service>
+ <service>
+ <role>OOZIE</role>
+ <url>http://localhost:11000/oozie</url>
+ </service>
+ <service>
+ <role>WEBHBASE</role>
+ <url>http://localhost:60080</url>
+ </service>
+ <service>
+ <role>HIVE</role>
+ <url>http://localhost:10001/cliservice</url>
+ </service>
+ <service>
+ <role>RESOURCEMANAGER</role>
+ <url>http://localhost:8088/ws</url>
+ </service>
+</topology></pre>
+ </td>
+ </tr>
+
+ <tr>
+ <td> </td>
+ <td>DELETE</td>
+ <td>Delete (and undeploy) a topology</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Request</td>
+ <td><pre>curl -iku admin:admin-password {GatewayAPI}/topologies/mytopology
-X DELETE</pre></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Response</td>
+ <td><pre>{ "deleted" : true }</pre></td>
+ </tr>
+
+ <tr>
+ <td>providerconfig</td>
+ <td>GET</td>
+ <td>Get an enumeration of the shared provider configurations currently
deployed to the gateway.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Request</td>
+ <td><pre>curl -iku admin:admin-password
{GatewayAPI}/providerconfig</pre></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Response</td>
+ <td>
+ <pre>
+{
+ "href" : "https://localhost:8443/gateway/admin/api/v1/providerconfig";,
+ "items" : [ {
+ "href" :
"https://localhost:8443/gateway/admin/api/v1/providerconfig/myproviders";,
+ "name" : "myproviders.xml"
+ },{
+ "href" :
"https://localhost:8443/gateway/admin/api/v1/providerconfig/sandbox-providers";,
+ "name" : "sandbox-providers.xml"
+ } ]
+} </pre>
+ </td>
+ </tr>
+
+ <tr>
+ <td>providerconfig/{id}</td>
+ <td>GET</td>
+ <td>Get the XML content of the specified shared provider
configuration.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Request</td>
+ <td><pre>curl -iku admin:admin-password
{GatewayAPI}/providerconfig/sandbox-providers \
+ -H Accept:application/xml</pre></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Response</td>
+ <td>
+ <pre>
+<gateway>
+ <provider>
+ <role>authentication</role>
+ <name>ShiroProvider</name>
+ <enabled>true</enabled>
+ <param>
+ <name>sessionTimeout</name>
+ <value>30</value>
+ </param>
+ <param>
+ <name>main.ldapRealm</name>
+
<value>org.apache.knox.gateway.shirorealm.KnoxLdapRealm</value>
+ </param>
+ <param>
+ <name>main.ldapContextFactory</name>
+
<value>org.apache.knox.gateway.shirorealm.KnoxLdapContextFactory</value>
+ </param>
+ <param>
+ <name>main.ldapRealm.contextFactory</name>
+ <value>$ldapContextFactory</value>
+ </param>
+ <param>
+ <name>main.ldapRealm.userDnTemplate</name>
+
<value>uid={0},ou=people,dc=hadoop,dc=apache,dc=org</value>
+ </param>
+ <param>
+ <name>main.ldapRealm.contextFactory.url</name>
+ <value>ldap://localhost:33389</value>
+ </param>
+ <param>
+
<name>main.ldapRealm.contextFactory.authenticationMechanism</name>
+ <value>simple</value>
+ </param>
+ <param>
+ <name>urls./**</name>
+ <value>authcBasic</value>
+ </param>
+ </provider>
+
+ <provider>
+ <role>identity-assertion</role>
+ <name>Default</name>
+ <enabled>true</enabled>
+ </provider>
+
+ <provider>
+ <role>hostmap</role>
+ <name>static</name>
+ <enabled>true</enabled>
+ <param>
+ <name>localhost</name>
+ <value>sandbox,sandbox.hortonworks.com</value>
+ </param>
+ </provider>
+</gateway></pre>
+ </td>
+ </tr>
+ </tr>
+ <td> </td>
+ <td>PUT</td>
+ <td>Add a shared provider configuration.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Request</td>
+ <td><pre>curl -iku admin:admin-password
{GatewayAPI}/providerconfig/sandbox-providers \
+ -X PUT \
+ -H Content-Type:application/xml \
+ -d "@sandbox-providers.xml"</pre></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Response</td>
+ <td><pre>HTTP 201 Created</pre></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>DELETE</td>
+ <td>Delete a shared provider configuration</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Request</td>
+ <td><pre>curl -iku admin:admin-password
{GatewayAPI}/providerconfig/sandbox-providers -X DELETE</pre></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Response</td>
+ <td>
+ <pre>{ "deleted" : "provider config sandbox-providers" }</pre>
+ </td>
+ </tr>
+
+ <tr>
+ <td>descriptors</td>
+ <td>GET</td>
+ <td>Get an enumeration of the simple descriptors currently deployed to the
gateway.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Request</td>
+ <td><pre>curl -iku admin:admin-password {GatewayAPI}/descriptors -H
Accept:application/json</pre></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Response</td>
+ <td>
+ <pre>
+{
+ "href" : "https://localhost:8443/gateway/admin/api/v1/descriptors";,
+ "items" : [ {
+ "href" :
"https://localhost:8443/gateway/admin/api/v1/descriptors/docker-sandbox";,
+ "name" : "docker-sandbox.json"
+ }, {
+ "href" :
"https://localhost:8443/gateway/admin/api/v1/descriptors/mytopology";,
+ "name" : "mytopology.yml"
+ } ]
+} </pre>
+ </td>
+ </tr>
+
+ <tr>
+ <td>descriptors/{id}</td>
+ <td>GET</td>
+ <td>Get the content of the specified descriptor.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Request</td>
+ <td><pre>curl -iku admin:admin-password
{GatewayAPI}/descriptors/docker-sandbox \
+ -H Accept:application/json</pre></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Response</td>
+ <td>
+ <pre>
+{
+ "discovery-type":"AMBARI",
+ "discovery-address":"http://sandbox.hortonworks.com:8080";,
+ "provider-config-ref":"sandbox-providers",
+ "cluster":"Sandbox",
+ "services":[
+ {"name":"NAMENODE"},
+ {"name":"JOBTRACKER"},
+ {"name":"WEBHDFS"},
+ {"name":"WEBHCAT"},
+ {"name":"OOZIE"},
+ {"name":"WEBHBASE"},
+ {"name":"HIVE"},
+ {"name":"RESOURCEMANAGER"} ]
+} </pre>
+ </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>PUT</td>
+ <td>Add a simple descriptor (and generate and deploy a full topology
descriptor).</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Request</td>
+ <td><pre>curl -iku admin:admin-password
{GatewayAPI}/descriptors/docker-sandbox \
+ -X PUT \
+ -H Content-Type:application/json \
+ -d "@docker-sandbox.json"</pre></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Response</td>
+ <td><pre>HTTP 201 Created</pre></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>DELETE</td>
+ <td>Delete a simple descriptor (and undeploy the associated topology)</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>Example Request</td>
+ <td><pre>curl -iku admin:admin-password
{GatewayAPI}/descriptors/docker-sandbox -X DELETE</pre></td>
+ <tr>
+ </tr>
+ <td> </td>
+ <td>Example Response</td>
+ <td>
+ <pre>{ "deleted" : "descriptor docker-sandbox" }</pre>
+ </td>
+ </tr>
+
+</table>
+
+Resource | Operation | Description
+---------|-----------|------------
+aliases/{topology}/{alias} | PUT | Add alias for a given topology
+ | Example Request | `curl -ik -u admin:admin-password -H "Content-Type:
application/json" -d "value=mysecret" -X PUT
'{GatewayAPI}/aliases/sandbox/myalias'`
+ | Example Response | `{ "created" : { "topology": "sandbox", "alias":
"putalias" } }`
+aliases/{topology}/{alias} | POST | Add alias for a given topology
+ | Example Request | `curl -ik -u admin:admin-password -d "value=mysecret"
-X POST '{GatewayAPI}/aliases/sandbox/myalias'`
+ | Example Response | `{ "created" : { "topology": "sandbox", "alias":
"putalias" } }`
+aliases/{topology} | GET | Get all aliases for a given topology
+ | Example Request | `curl -ik -u admin:admin-password -X GET
'{GatewayAPI}/aliases/sandbox'`
+ | Example Response |
`{"topology":"sandbox","aliases":["myalias","encryptquerystring"]}`
+aliases/{topology}/{alias} | DELETE | Delete alias for a given topology
+ | Example Request | `curl -ik -u admin:admin-password -X DELETE
'{GatewayAPI}/aliases/sandbox/myalias'`
+ | Example Response | `{ "deleted" : { "topology": "sandbox", "alias":
"myalias" } }`
+
+
+
Added: knox/trunk/books/1.4.0/admin_ui.md
URL:
http://svn.apache.org/viewvc/knox/trunk/books/1.4.0/admin_ui.md?rev=1863668&view=auto
==============================================================================
--- knox/trunk/books/1.4.0/admin_ui.md (added)
+++ knox/trunk/books/1.4.0/admin_ui.md Tue Jul 23 21:27:15 2019
@@ -0,0 +1,210 @@
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You 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.
+--->
+
+### Admin UI ###
+
+The Admin UI is a web application hosted by Knox, which provides the ability
to manage provider configurations, descriptors, and topologies.
+
+As an authoring facility, it eliminates the need for ssh/scp access to the
Knox host(s) to effect topology changes.<br>
+Furthermore, using the Admin UI simplifies the management of topologies in
Knox HA deployments by eliminating the need to copy files to multiple Knox
hosts.
+
+
+#### Admin UI URL ####
+
+The URL mapping for the Knox Admin UI is:
+
+| ------- |
----------------------------------------------------------------------------------------------
|
+| Gateway |
`https://{gateway-host}:{gateway-port}/{gateway-path}/manager/admin-ui/` |
+
+
+##### Authentication
+
+The admin UI is deployed using the __manager__ topology. The out-of-box
authentication mechanism is KNOXSSO, backed by the demo LDAP server.
+ Only someone in the __admin__ role can access the UI functionality.
+
+##### Basic Navigation
+Initially, the Admin UI presents the types of resources which can be managed:
[__Provider Configurations__](#Provider+Configurations),
[__Descriptors__](#Descriptors), and [__Topologies__](#Topologies).
+
+<img src="adminui/image1.png" style="width:6.5in;height:3.28403in" />
+
+Selecting a resource type yields a listing of the existing resources of that
type in the adjacent column, and selecting an individual resource
+presents the details of that selected resource.
+
+For the provider configuration and descriptor resources types, the <img
src="adminui/plus-icon.png"
style="width:20px;height:20px;vertical-align:bottom"/>
+icon next to the resource list header is the trigger for the respective
facility for creating a new resource of that type.<br>
+Modification options, including deletion, are available from the detail view
for an individual resource.
+
+
+##### Provider Configurations
+
+The Admin UI lists the provider configurations currently deployed to Knox.
+
+By choosing a particular provider configuration from the list, its details can
be viewed and edited.<br>
+The provider configuration can also be deleted (as long as there are no
referencing descriptors).
+
+By default, there is a provider configuration named __*default-providers*__.
+
+<img src="adminui/image2.png" style="width:6.5in;height:3.76597in" />
+
+###### Editing Provider Configurations
+For each provider in a given provider configuration, the attributes can be
modified:
+
+* The provider can be enabled/disabled
+* Parameters can be added (<img src="adminui/plus-icon.png"
style="width:20px;height:20px;vertical-align:bottom"/>) or removed (<img
src="adminui/x-icon.png" style="height:12px;vertical-align:middle"/>)
+* Parameter values can be modified (by clicking on the value)
+ <img src="adminui/image21.png"/>
+
+<br>
+To persist changes, the <img src="adminui//save-icon.png"
style="height:32px;vertical-align:bottom"> button must be clicked. To revert
*unsaved* changes, click the <img src="adminui//undo-icon.png"
style="height:32px;vertical-align:bottom"> button or simply choose another
resource.
+<br>
+
+###### Create Provider Configurations
+
+The Admin UI provides the ability to define new provider configurations, which
can subsequently be referenced by one or more descriptors.
+
+These provider configurations can be created based on the functionality
needed, rather than requiring intimate knowledge of the various provider names
+and their respective parameter names.
+
+A provider configuration is a named set of providers. The wizard allows an
administrator to specify the name, and add providers to it.
+
+<img src="adminui/image3.png" style="width:6.5in;height:3.11319in" />
+
+To add a provider, first a category must be chosen.
+
+<img src="adminui/image4.png" style="width:6.5in;height:2.27917in" />
+
+After choosing a category, the type within that category must be selected.
+
+<img src="adminui/image5.png" style="width:6.5in;height:3.19097in" />
+
+Finally, for the selected type, the type-specific parameter values can be
specified.
+
+<img src="adminui/image6.png" style="width:6.5in;height:2.74167in" />
+
+After adding a provider, others can be added similarly by way of the __Add
Provider__ button.
+
+<img src="adminui/image7.png" style="width:6.5in;height:1.99792in" />
+
+###### Composite Provider Types
+
+The wizard for some provider types, such as the HA provider, behave a little
differently than the other provider types.
+
+For example, when you choose the HA provider category, you subsequently choose
a service role (e.g., WEBHDFS), and specify the parameter values for that
service role's entry in the HA provider.
+
+<img src="adminui/image8.png" style="width:6.5in;height:1.34028in" />
+
+<img src="adminui/image9.png" style="width:6.5in;height:3.36458in" />
+
+If multiple services are configured in this way, the result is still a single
HA provider, which contains all of the service role configurations.
+
+<img src="adminui/image10.png" style="width:6.5in;height:2.20208in" />
+
+###### Persisting the New Provider Configuration
+
+After adding all the desired providers to the new configuration, choosing <img
src="adminui/ok-button.png" style="height:24px;vertical-align:bottom"/>
persists it.
+
+<img src="adminui/image11.png" style="width:6.25in;height:6.95833in" />
+
+
+##### Descriptors
+
+A descriptor is essentially a named set of service roles to be proxied with a
provider configuration reference.
+The Admin UI lists the descriptors currently deployed to Knox.
+
+By choosing a particular descriptor from the list, its details can be viewed
and edited. The provider configuration can also be deleted.
+
+Modifications to descriptors will result in topology changes. When a
descriptor is saved or deleted, the corresponding topology is \[re\]generated
or deleted/undeployed respectively.
+
+<img src="adminui/image12.png" style="width:6.5in;height:2.06319in" />
+
+<img src="adminui/image13.png" style="width:6.5in;height:2.81181in" />
+
+<img src="adminui/image14.png" style="width:6.5in;height:3.50556in" />
+
+###### Create Descriptors
+
+The Admin UI provides the ability to define new descriptors, which result in
the generation and deployment of corresponding topologies.
+
+The __new descriptor__ dialog provides the ability to specify the name, which
will also be the name of the resulting topology. It also
+allows one or more supported service roles to be selected for inclusion.
+
+<img src="adminui/image15.png" style="width:6.5in;height:3.82361in" />
+
+The provider configuration reference can entered manually, or the provider
configuration selector can be used, to specify the name of an
+existing provider configuration.
+
+<img src="adminui/image16.png" style="width:6.5in;height:3.88125in" />
+
+Optionally, discovery details can also be specified to direct Knox to discover
the endpoints for the declared service roles from the Ambari-managed
+target cluster.
+
+<img src="adminui/image17.png" style="width:6.5in;height:5.24167in" />
+
+Choosing <img src="adminui/ok-button.png"
style="height:24px;vertical-align:bottom"/> results in the persistence of the
descriptor, and subsequently, the generation and deployment of the associated
topology.
+
+###### Service Discovery
+
+Descriptors are a means to *declaratively* specify which services should be
proxied by a particular topology, allowing Knox to interrogate Ambari
+to determine the endpoint URLs for those declared services. The Service
Discovery options tell Knox how to connect to the desired Ambari cluster
+to perform this endpoint discovery.
+
+*Address*
+
+This property specifies the address of the Ambari instance managing the
cluster hosting the services whose endpoints are to be discovered.
+
+*Cluster*
+
+This property specifies from which of the clusters, among those being managed
by the specified Ambari instance, the service endpoints should be determined.
+
+*Username*
+
+This is the identity of the Ambari user (assigned at least the *Cluster User*
role), which will be used to get service configuration details from Ambari.
+
+*Password Alias*
+
+This is the Knox alias whose value is the password associated with the
specified username.
+
+This alias must have been defined prior to specifying it in a descriptor, or
else the service discovery will fail for authentication reasons.
+
+<img src="adminui/image18.png" style="width:6.5in;height:3.04097in" />
+
+##### Topologies
+
+The Admin UI allows an administrator to view, modify, duplicate and delete
topologies which are currently deployed to the Knox instance.
+Changes to a topology results in the [re]deployment of that topology, and
deleting a topology results in its undeployment.
+
+<img src="adminui/image19.png" style="width:6.5in;height:3.1625in" />
+
+<img src="adminui/image20.png" style="width:6.5in;height:3.38889in" />
+
+###### Read-Only Protections
+
+Topologies which are generated from descriptors are treated as read-only in
the Admin UI. This is to avoid the potential confusion resulting from an
administrator directly editing
+a generated topology only to have those changes overwritten by a regeneration
of that same topology because the source descriptor or provider configuration
changed.
+
+
+##### Knox HA Considerations
+
+If the Knox instance which is hosting the Admin UI is configured for [remote
configuration monitoring](#Remote+Configuration+Monitor), then provider
configuration and descriptor changes will
+be persisted in the configured ZooKeeper ensemble. Then, every Knox instance
which is also configured to monitor configuration in this same ZooKeeper will
apply
+those changes, and [re]generate/[re]deploy the affected topologies. In this
way, Knox HA deployments can be managed by making changes once, and from any of
the
+Knox instances.
+
+
+
+<br>
+
Added: knox/trunk/books/1.4.0/book.md
URL:
http://svn.apache.org/viewvc/knox/trunk/books/1.4.0/book.md?rev=1863668&view=auto
==============================================================================
--- knox/trunk/books/1.4.0/book.md (added)
+++ knox/trunk/books/1.4.0/book.md Tue Jul 23 21:27:15 2019
@@ -0,0 +1,165 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You 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.
+-->
+
+<<../common/header.md>>
+
+<img src="knox-logo.gif" alt="Knox"/>
+<!-- <img src="apache-logo.gif" alt="Apache"/> -->
+<img src="apache-logo.gif" align="right" alt="Apache"/>
+
+# Apache Knox Gateway 1.3.x User's Guide #
+
+## Table Of Contents ##
+
+* #[Introduction]
+* #[Quick Start]
+* #[Gateway Samples]
+* #[Apache Knox Details]
+ * #[Apache Knox Directory Layout]
+ * #[Supported Services]
+* #[Gateway Details]
+ * #[URL Mapping]
+ * #[Default Topology URLs]
+ * #[Fully Qualified URLs]
+ * #[Topology Port Mapping]
+ * #[Configuration]
+ * #[Gateway Server Configuration]
+ * #[Simplified Topology Descriptors]
+ * #[Externalized Provider Configurations]
+ * #[Sharing HA Providers]
+ * #[Simplified Descriptor Files]
+ * #[Cluster Configuration Monitoring]
+ * #[Remote Configuration Monitor]
+ * #[Remote Configuration Registry Clients]
+ * #[Topology Descriptors]
+ * #[Hostmap Provider]
+ * #[Remote Alias Service]
+ * #[Knox CLI]
+ * #[Admin API]
+ * #[X-Forwarded-* Headers Support]
+ * #[Metrics]
+* #[Authentication]
+ * #[Advanced LDAP Authentication]
+ * #[LDAP Authentication Caching]
+ * #[LDAP Group Lookup]
+ * #[PAM based Authentication]
+ * #[HadoopAuth Authentication Provider]
+ * #[Preauthenticated SSO Provider]
+ * #[SSO Cookie Provider]
+ * #[JWT Provider]
+ * #[Pac4j Provider - CAS / OAuth / SAML / OpenID Connect]
+ * #[KnoxSSO Setup and Configuration]
+ * #[KnoxToken Configuration]
+ * #[Mutual Authentication with SSL]
+ * #[TLS Client Certificate Provider]
+* #[Authorization]
+* #[Identity Assertion]
+ * #[Default Identity Assertion Provider]
+ * #[Concat Identity Assertion Provider]
+ * #[SwitchCase Identity Assertion Provider]
+ * #[Regular Expression Identity Assertion Provider]
+ * #[Hadoop Group Lookup Provider]
+* #[Secure Clusters]
+* #[High Availability]
+* #[Web App Security Provider]
+ * #[CSRF]
+ * #[CORS]
+ * #[X-Frame-Options]
+ * #[X-Content-Type-Options]
+ * #[HTTP Strict-Transport-Security - HSTS]
+* #[Websocket Support]
+* #[Audit]
+* #[Client Details]
+ * #[Client Quickstart]
+ * #[Client Token Sessions]
+ * #[Server Setup]
+ * #[Client DSL and SDK Details]
+* #[Service Details]
+ * #[WebHDFS]
+ * #[WebHCat]
+ * #[Oozie]
+ * #[HBase]
+ * #[Hive]
+ * #[Yarn]
+ * #[Kafka]
+ * #[Storm]
+ * #[Solr]
+ * #[Avatica]
+ * #[Livy Server]
+ * #[Elasticsearch]
+ * #[Common Service Config]
+ * #[Default Service HA support]
+ * #[TLS/SSL Certificate Trust]
+* #[UI Service Details]
+* #[Admin UI]
+* #[Limitations]
+* #[Troubleshooting]
+* #[Export Controls]
+
+
+## Introduction ##
+
+The Apache Knox Gateway is a system that provides a single point of
authentication and access for Apache Hadoop services in a cluster.
+The goal is to simplify Hadoop security for both users (i.e. who access the
cluster data and execute jobs) and operators (i.e. who control access and
manage the cluster).
+The gateway runs as a server (or cluster of servers) that provide centralized
access to one or more Hadoop clusters.
+In general the goals of the gateway are as follows:
+
+* Provide perimeter security for Hadoop REST APIs to make Hadoop security
easier to setup and use
+ * Provide authentication and token verification at the perimeter
+ * Enable authentication integration with enterprise and cloud identity
management systems
+ * Provide service level authorization at the perimeter
+* Expose a single URL hierarchy that aggregates REST APIs of a Hadoop cluster
+ * Limit the network endpoints (and therefore firewall holes) required to
access a Hadoop cluster
+ * Hide the internal Hadoop cluster topology from potential attackers
+
+<<quick_start.md>>
+<<book_getting-started.md>>
+<<book_knox-samples.md>>
+<<book_gateway-details.md>>
+<<book_client-details.md>>
+<<book_service-details.md>>
+<<book_ui_service_details.md>>
+<<admin_ui.md>>
+<<book_limitations.md>>
+<<book_troubleshooting.md>>
+
+
+## Export Controls ##
+
+Apache Knox Gateway includes cryptographic software.
+The country in which you currently reside may have restrictions on the import,
possession, use, and/or
+re-export to another country, of encryption software.
+BEFORE using any encryption software, please check your country's laws,
regulations and policies concerning the
+import, possession, or use, and re-export of encryption software, to see if
this is permitted.
+See http://www.wassenaar.org for more information.
+
+The U.S. Government Department of Commerce, Bureau of Industry and Security
(BIS),
+has classified this software as Export Commodity Control Number (ECCN)
5D002.C.1,
+which includes information security software using or performing cryptographic
functions with asymmetric algorithms.
+The form and manner of this Apache Software Foundation distribution makes it
eligible for export under the
+License Exception ENC Technology Software Unrestricted (TSU) exception
+(see the BIS Export Administration Regulations, Section 740.13) for both
object code and source code.
+
+The following provides more details on the included cryptographic software:
+
+* Apache Knox Gateway uses the ApacheDS which in turn uses Bouncy Castle
generic encryption libraries.
+* See http://www.bouncycastle.org for more details on Bouncy Castle.
+* See http://directory.apache.org/apacheds for more details on ApacheDS.
+
+
+<<../common/footer.md>>
+
