Author: kminder
Date: Tue Jun 23 17:54:25 2015
New Revision: 1687112
URL: http://svn.apache.org/r1687112
Log:
KNOX-548: KnoxCLI adds a new system-user-auth-test command to test a topology's
system username and password
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/books/knox-0-5-0/deployment-overview.png
knox/site/books/knox-0-5-0/deployment-provider.png
knox/site/books/knox-0-5-0/deployment-service.png
knox/site/books/knox-0-5-0/runtime-overview.png
knox/site/books/knox-0-5-0/runtime-request-processing.png
knox/site/books/knox-0-6-0/deployment-overview.png
knox/site/books/knox-0-6-0/deployment-provider.png
knox/site/books/knox-0-6-0/deployment-service.png
knox/site/books/knox-0-6-0/runtime-overview.png
knox/site/books/knox-0-6-0/runtime-request-processing.png
knox/site/books/knox-0-7-0/deployment-overview.png
knox/site/books/knox-0-7-0/deployment-provider.png
knox/site/books/knox-0-7-0/deployment-service.png
knox/site/books/knox-0-7-0/runtime-overview.png
knox/site/books/knox-0-7-0/runtime-request-processing.png
knox/site/books/knox-0-7-0/user-guide.html
knox/site/images/application-certificate.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/site/team-list.html
knox/trunk/books/0.7.0/knox_cli.md
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=1687112&r1=1687111&r2=1687112&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=1687112&r1=1687111&r2=1687112&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=1687112&r1=1687111&r2=1687112&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=1687112&r1=1687111&r2=1687112&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=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-5-0/deployment-overview.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-5-0/deployment-overview.png?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-5-0/deployment-provider.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-5-0/deployment-provider.png?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-5-0/deployment-service.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-5-0/deployment-service.png?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-5-0/runtime-overview.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-5-0/runtime-overview.png?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-5-0/runtime-request-processing.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-5-0/runtime-request-processing.png?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-6-0/deployment-overview.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-6-0/deployment-overview.png?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-6-0/deployment-provider.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-6-0/deployment-provider.png?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-6-0/deployment-service.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-6-0/deployment-service.png?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-6-0/runtime-overview.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-6-0/runtime-overview.png?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-6-0/runtime-request-processing.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-6-0/runtime-request-processing.png?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-7-0/deployment-overview.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-7-0/deployment-overview.png?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-7-0/deployment-provider.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-7-0/deployment-provider.png?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-7-0/deployment-service.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-7-0/deployment-service.png?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-7-0/runtime-overview.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-7-0/runtime-overview.png?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-7-0/runtime-request-processing.png
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-7-0/runtime-request-processing.png?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-0-7-0/user-guide.html
URL:
http://svn.apache.org/viewvc/knox/site/books/knox-0-7-0/user-guide.html?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
--- knox/site/books/knox-0-7-0/user-guide.html (original)
+++ knox/site/books/knox-0-7-0/user-guide.html Tue Jun 23 17:54:25 2015
@@ -659,7 +659,7 @@ ip-10-39-107-209.ec2.internal
<td>path to topology file that you wish to validate.</td>
</tr>
</tbody>
-</table><h4><a id="LDAP+Authentication+and+Authorization"></a>LDAP
Authentication and Authorization</h4><h5><a
id="`bin/knoxcli.sh+auth-test+[--cluster+c]+[--u+username]+[--p+password]+[--g]+[--d]+[--help]`"></a><code>bin/knoxcli.sh
auth-test [--cluster c] [--u username] [--p password] [--g] [--d]
[--help]</code></h5><p>This command will test a topology’s ability to
connect, authenticate, and authorize a user with an LDAP server. The only
required argument is the –cluster argument to specify the name of the
topology you wish to use. The topology must be valid (passes validate-topology
command). If a –u and –p argument are not specified, the command
line will prompt for a username and password. If authentication is successful
then the command will attempt to use the topology to do an LDAP group lookup.
The topology must be configured correctly to do this. If it is not, groups will
not return and no errors will be printed unless the <code>--g</code> command is
specified. Currently this command only works if a topology supports the use of
ShiroProvider for authentication.</p>
+</table><h4><a id="LDAP+Authentication+and+Authorization"></a>LDAP
Authentication and Authorization</h4><h5><a
id="`bin/knoxcli.sh+user-auth-test+[--cluster+c]+[--u+username]+[--p+password]+[--g]+[--d]+[--help]`"></a><code>bin/knoxcli.sh
user-auth-test [--cluster c] [--u username] [--p password] [--g] [--d]
[--help]</code></h5><p>This command will test a topology’s ability to
connect, authenticate, and authorize a user with an LDAP server. The only
required argument is the –cluster argument to specify the name of the
topology you wish to use. The topology must be valid (passes validate-topology
command). If a –u and –p argument are not specified, the command
line will prompt for a username and password. If authentication is successful
then the command will attempt to use the topology to do an LDAP group lookup.
The topology must be configured correctly to do this. If it is not, groups will
not return and no errors will be printed unless the <code>--g</code> c
ommand is specified. Currently this command only works if a topology supports
the use of ShiroProvider for authentication.</p>
<table>
<thead>
<tr>
@@ -686,6 +686,24 @@ ip-10-39-107-209.ec2.internal
</tr>
<tr>
<td>--d </td>
+ <td>Optional; Print extra debug info on failed authentication</td>
+ </tr>
+ </tbody>
+</table><h4><a id="Topology+LDAP+Bind"></a>Topology LDAP Bind</h4><h5><a
id="`bin/knoxcli.sh+system-user-auth-test+[--cluster+c]+[--d]+[--help]`"></a><code>bin/knoxcli.sh
system-user-auth-test [--cluster c] [--d] [--help]</code></h5><p>This command
will test a given topology’s ability to connect, bind, and authenticate
with the ldap server from the settings specified in the topology file. The bind
currently only will with Shiro as the authentication provider. There are also
two parameters required inside of the topology for these </p>
+<table>
+ <thead>
+ <tr>
+ <th>argument </th>
+ <th>description</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>--cluster </td>
+ <td>Required; name of cluster for which you want to test
authentication</td>
+ </tr>
+ <tr>
+ <td>--d </td>
<td>Optional; Print extra debug info on failed authentication</td>
</tr>
</tbody>
Modified: knox/site/images/application-certificate.png
URL:
http://svn.apache.org/viewvc/knox/site/images/application-certificate.png?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/index.html
URL:
http://svn.apache.org/viewvc/knox/site/index.html?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
--- knox/site/index.html (original)
+++ knox/site/index.html Tue Jun 23 17:54:25 2015
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 2015-06-14
+ | Generated by Apache Maven Doxia at 2015-06-23
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<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="20150614" />
+ <meta name="Date-Revision-yyyymmdd" content="20150623" />
<meta http-equiv="Content-Language" content="en" />
<title>Knox Gateway – REST API Gateway for the Hadoop
Ecosystem</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -58,7 +58,7 @@
- <li id="publishDate" class="pull-right">Last Published:
2015-06-14</li>
+ <li id="publishDate" class="pull-right">Last Published:
2015-06-23</li>
</ul>
</div>
Modified: knox/site/issue-tracking.html
URL:
http://svn.apache.org/viewvc/knox/site/issue-tracking.html?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
--- knox/site/issue-tracking.html (original)
+++ knox/site/issue-tracking.html Tue Jun 23 17:54:25 2015
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 2015-06-14
+ | Generated by Apache Maven Doxia at 2015-06-23
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<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="20150614" />
+ <meta name="Date-Revision-yyyymmdd" content="20150623" />
<meta http-equiv="Content-Language" content="en" />
<title>Knox Gateway – Issue Tracking</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -58,7 +58,7 @@
- <li id="publishDate" class="pull-right">Last Published:
2015-06-14</li>
+ <li id="publishDate" class="pull-right">Last Published:
2015-06-23</li>
</ul>
</div>
Modified: knox/site/license.html
URL:
http://svn.apache.org/viewvc/knox/site/license.html?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
--- knox/site/license.html (original)
+++ knox/site/license.html Tue Jun 23 17:54:25 2015
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 2015-06-14
+ | Generated by Apache Maven Doxia at 2015-06-23
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<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="20150614" />
+ <meta name="Date-Revision-yyyymmdd" content="20150623" />
<meta http-equiv="Content-Language" content="en" />
<title>Knox Gateway – Project License</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -58,7 +58,7 @@
- <li id="publishDate" class="pull-right">Last Published:
2015-06-14</li>
+ <li id="publishDate" class="pull-right">Last Published:
2015-06-23</li>
</ul>
</div>
Modified: knox/site/mail-lists.html
URL:
http://svn.apache.org/viewvc/knox/site/mail-lists.html?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
--- knox/site/mail-lists.html (original)
+++ knox/site/mail-lists.html Tue Jun 23 17:54:25 2015
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 2015-06-14
+ | Generated by Apache Maven Doxia at 2015-06-23
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<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="20150614" />
+ <meta name="Date-Revision-yyyymmdd" content="20150623" />
<meta http-equiv="Content-Language" content="en" />
<title>Knox Gateway – Project Mailing Lists</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -58,7 +58,7 @@
- <li id="publishDate" class="pull-right">Last Published:
2015-06-14</li>
+ <li id="publishDate" class="pull-right">Last Published:
2015-06-23</li>
</ul>
</div>
Modified: knox/site/project-info.html
URL:
http://svn.apache.org/viewvc/knox/site/project-info.html?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
--- knox/site/project-info.html (original)
+++ knox/site/project-info.html Tue Jun 23 17:54:25 2015
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 2015-06-14
+ | Generated by Apache Maven Doxia at 2015-06-23
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<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="20150614" />
+ <meta name="Date-Revision-yyyymmdd" content="20150623" />
<meta http-equiv="Content-Language" content="en" />
<title>Knox Gateway – Project Information</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -58,7 +58,7 @@
- <li id="publishDate" class="pull-right">Last Published:
2015-06-14</li>
+ <li id="publishDate" class="pull-right">Last Published:
2015-06-23</li>
</ul>
</div>
Modified: knox/site/team-list.html
URL:
http://svn.apache.org/viewvc/knox/site/team-list.html?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
--- knox/site/team-list.html (original)
+++ knox/site/team-list.html Tue Jun 23 17:54:25 2015
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 2015-06-14
+ | Generated by Apache Maven Doxia at 2015-06-23
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<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="20150614" />
+ <meta name="Date-Revision-yyyymmdd" content="20150623" />
<meta http-equiv="Content-Language" content="en" />
<title>Knox Gateway – Team list</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -58,7 +58,7 @@
- <li id="publishDate" class="pull-right">Last Published:
2015-06-14</li>
+ <li id="publishDate" class="pull-right">Last Published:
2015-06-23</li>
</ul>
</div>
Modified: knox/trunk/books/0.7.0/knox_cli.md
URL:
http://svn.apache.org/viewvc/knox/trunk/books/0.7.0/knox_cli.md?rev=1687112&r1=1687111&r2=1687112&view=diff
==============================================================================
--- knox/trunk/books/0.7.0/knox_cli.md (original)
+++ knox/trunk/books/0.7.0/knox_cli.md Tue Jun 23 17:54:25 2015
@@ -92,7 +92,7 @@ argument | description
\-\-path | path to topology file that you wish to validate.
#### LDAP Authentication and Authorization ####
-##### `bin/knoxcli.sh auth-test [--cluster c] [--u username] [--p password]
[--g] [--d] [--help]` ####
+##### `bin/knoxcli.sh user-auth-test [--cluster c] [--u username] [--p
password] [--g] [--d] [--help]` ####
This command will test a topology's ability to connect, authenticate, and
authorize a user with an LDAP server. The only required argument is the
--cluster argument to specify the name of the topology you wish to use. The
topology must be valid (passes validate-topology command). If a --u and --p
argument are not specified, the command line will prompt for a username and
password. If authentication is successful then the command will attempt to use
the topology to do an LDAP group lookup. The topology must be configured
correctly to do this. If it is not, groups will not return and no errors will
be printed unless the `--g` command is specified. Currently this command only
works if a topology supports the use of ShiroProvider for authentication.
argument | description
@@ -101,4 +101,13 @@ argument | description
\-\-u | Optional; username you wish you authenticate with.
\-\-p | Optional; password you wish to authenticate with
\-\-g | Optional; Specify that you are looking to return a user's groups. If
not specified, group lookup errors won't return.
+\-\-d | Optional; Print extra debug info on failed authentication
+
+#### Topology LDAP Bind ####
+##### `bin/knoxcli.sh system-user-auth-test [--cluster c] [--d] [--help]` ####
+This command will test a given topology's ability to connect, bind, and
authenticate with the ldap server from the settings specified in the topology
file. The bind currently only will with Shiro as the authentication provider.
There are also two parameters required inside of the topology for these
+
+argument | description
+---------|-----------
+\-\-cluster | Required; name of cluster for which you want to test
authentication
\-\-d | Optional; Print extra debug info on failed authentication
\ No newline at end of file
