You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@guacamole.apache.org by mj...@apache.org on 2020/11/05 08:00:08 UTC
[guacamole-manual] branch master updated (a420562 -> 1c82619)
This is an automated email from the ASF dual-hosted git repository.
mjumper pushed a change to branch master
in repository https://gitbox.apache.org/repos/asf/guacamole-manual.git.
from a420562 Merge 1.3.0 changes back to master.
new 9134610 GUACAMOLE-221: Document connection parameter prompting.
new 0d50efa GUACAMOLE-221: Merge documentation for connection parameter prompting support.
new f7276ce GUACAMOLE-1205: Bump Guacamole manual versions to 1.3.0
new 37f5f72 GUACAMOLE-1205: Merge bump of updated component versions to 1.3.0.
new 1c82619 Merge 1.3.0 changes back to master.
The 5 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
src/chapters/adhoc-connections.xml | 4 +-
src/chapters/cas-auth.xml | 4 +-
src/chapters/configuring.xml | 72 +++++++++++++++++-----
src/chapters/custom-auth.xml | 12 ++--
src/chapters/duo-auth.xml | 4 +-
src/chapters/event-listeners.xml | 12 ++--
src/chapters/guacamole-ext.xml | 4 +-
src/chapters/installing.xml | 14 ++---
src/chapters/jdbc-auth.xml | 16 ++---
src/chapters/ldap-auth.xml | 4 +-
src/chapters/openid-auth.xml | 4 +-
src/chapters/radius-auth.xml | 6 +-
src/chapters/saml-auth.xml | 4 +-
src/chapters/totp-auth.xml | 4 +-
src/chapters/yourown.xml | 10 +--
src/gug.xml | 4 +-
tutorials/guacamole-auth-tutorial/pom.xml | 4 +-
.../src/main/resources/guac-manifest.json | 2 +-
tutorials/guacamole-tutorial/pom.xml | 4 +-
19 files changed, 115 insertions(+), 73 deletions(-)
[guacamole-manual] 03/05: GUACAMOLE-221: Merge documentation for
connection parameter prompting support.
Posted by mj...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
mjumper pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/guacamole-manual.git
commit 0d50efa2323842c1efe614c45494ae53b7f61d84
Merge: 7a9ec9a 9134610
Author: Mike Jumper <mj...@apache.org>
AuthorDate: Wed Nov 4 23:38:04 2020 -0800
GUACAMOLE-221: Merge documentation for connection parameter prompting support.
src/chapters/configuring.xml | 60 +++++++++++++++++++++++++++++++++++++-------
1 file changed, 51 insertions(+), 9 deletions(-)
[guacamole-manual] 05/05: Merge 1.3.0 changes back to master.
Posted by mj...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
mjumper pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/guacamole-manual.git
commit 1c826195714137ee853a03be2ca9431b72233c16
Merge: a420562 37f5f72
Author: Michael Jumper <mj...@apache.org>
AuthorDate: Wed Nov 4 23:59:44 2020 -0800
Merge 1.3.0 changes back to master.
src/chapters/adhoc-connections.xml | 4 +-
src/chapters/cas-auth.xml | 4 +-
src/chapters/configuring.xml | 72 +++++++++++++++++-----
src/chapters/custom-auth.xml | 12 ++--
src/chapters/duo-auth.xml | 4 +-
src/chapters/event-listeners.xml | 12 ++--
src/chapters/guacamole-ext.xml | 4 +-
src/chapters/installing.xml | 14 ++---
src/chapters/jdbc-auth.xml | 16 ++---
src/chapters/ldap-auth.xml | 4 +-
src/chapters/openid-auth.xml | 4 +-
src/chapters/radius-auth.xml | 6 +-
src/chapters/saml-auth.xml | 4 +-
src/chapters/totp-auth.xml | 4 +-
src/chapters/yourown.xml | 10 +--
src/gug.xml | 4 +-
tutorials/guacamole-auth-tutorial/pom.xml | 4 +-
.../src/main/resources/guac-manifest.json | 2 +-
tutorials/guacamole-tutorial/pom.xml | 4 +-
19 files changed, 115 insertions(+), 73 deletions(-)
[guacamole-manual] 02/05: GUACAMOLE-221: Document connection
parameter prompting.
Posted by mj...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
mjumper pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/guacamole-manual.git
commit 9134610571b6cece4a27e2f8bbc0d65d65ea0ba1
Author: Nick Couchman <ni...@yahoo.com>
AuthorDate: Mon Nov 2 10:11:37 2020 -0500
GUACAMOLE-221: Document connection parameter prompting.
---
src/chapters/configuring.xml | 60 +++++++++++++++++++++++++++++++++++++-------
1 file changed, 51 insertions(+), 9 deletions(-)
diff --git a/src/chapters/configuring.xml b/src/chapters/configuring.xml
index dc96a8e..0ddefba 100644
--- a/src/chapters/configuring.xml
+++ b/src/chapters/configuring.xml
@@ -1635,15 +1635,18 @@ tcp6 0 0 :::4713 :::* LISTEN</comp
domain parameters are omitted. One notable exception to this is Network Level
Authentication, or NLA, which performs all authentication outside of a desktop
session, and thus in the absence of a graphical interface.</para>
- <important>
- <para>If your server requires NLA, you <emphasis>must</emphasis> provide a
- username and password. Leveraging Guacamole's <link
- xmlns:xlink="http://www.w3.org/1999/xlink" linkend="parameter-tokens"
- >parameter tokens</link> and <link
- xmlns:xlink="http://www.w3.org/1999/xlink" linkend="ldap-auth">LDAP
- support</link> to integrate with Active Directory and automatically pass
- through credentials is a common configuration.</para>
- </important>
+ <para>Servers that require NLA can be handled by Guacamole in one of two ways. The
+ first is to provide the username and password within the connection
+ configuration, either via static values or by passing through the Guacamole
+ credentials with <link xmlns:xlink="http://www.w3.org/1999/xlink"
+ linkend="parameter-tokens">parameter tokens</link> and
+ <link xmlns:xlink="http://www.w3.org/1999/xlink" linkend="ldap-auth">
+ LDAP support</link>. Alternatively, if credentials are not configured
+ within the connection configuration, Guacamole will attempt to prompt the user
+ for the credentials interactively, if the versions of both guacd and
+ Guacamole Client in use support it. If either component does not support
+ prompting and the credentials are not configured, NLA-based connections will
+ fail.</para>
<informaltable frame="all">
<indexterm>
<primary>parameters</primary>
@@ -1730,6 +1733,13 @@ tcp6 0 0 :::4713 :::* LISTEN</comp
session actually starts, avoiding the need for the
Windows server to allocate significant resources
for users that may not be authorized.</para>
+ <para>If the versions of guacd and Guacamole Client
+ in use support prompting and the username, password,
+ and domain are not specified, the user will be
+ interactively prompted to enter credentials to
+ complete NLA and continue the connection. Otherwise,
+ when prompting is not supported and credentials are
+ not provided, NLA connections will fail.</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -6195,6 +6205,38 @@ guaclog: INFO: All files interpreted successfully.</computeroutput>
</section>
</section>
</section>
+ <section xml:id="parameter-prompting">
+ <title>Parameter prompting</title>
+ <para><indexterm>
+ <primary>parameters</primary>
+ <secondary>prompt</secondary>
+ </indexterm>In certain situations Guacamole may determine that additional
+ information is required in order to successfully open or continue a
+ connection. In these scenarios guacd will send an instruction back to
+ the client to retrieve that information, which will result in the user
+ being prompted for those additional parameters.</para>
+ <para>Currently the only parameters that will trigger this prompt to the
+ user are authentication requests for the RDP and VNC protocols where
+ authenticators were not provided as part of the connection configuration.
+ </para>
+ <important>
+ <para>It is important to note that requests for parameters will only be
+ generated in the case where that information has not already been
+ provided as part of the connection. The user will never be asked for
+ parameters that replace or override connection parameters where
+ values have been configured as part of the connection, including
+ authentication information. For example, if the configuration of
+ a connection to a RDP server specifies a username and password,
+ and that username or password is incorrect and results in an
+ authentication failure, Guacamole will not prompt the user for
+ additional credentials. For RDP servers where NLA is enforced,
+ this will result in a connection failure. Other RDP servers may
+ behave differently and give the user the ability to try other
+ credentials, but this is outside the control of Guacamole -
+ Guacamole will not override pre-configured values with input
+ from the user.</para>
+ </important>
+ </section>
</section>
<section xml:id="guacd.conf">
<title>Configuring guacd</title>
[guacamole-manual] 01/05: GUACAMOLE-1205: Bump Guacamole manual
versions to 1.3.0
Posted by mj...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
mjumper pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/guacamole-manual.git
commit f7276ce3c6652cc8bf42d1606cb5eb26be331ae6
Author: Nick Couchman <ni...@cotyinc.com>
AuthorDate: Mon Nov 2 11:18:35 2020 -0500
GUACAMOLE-1205: Bump Guacamole manual versions to 1.3.0
---
src/chapters/adhoc-connections.xml | 4 ++--
src/chapters/cas-auth.xml | 4 ++--
src/chapters/configuring.xml | 12 ++++++------
src/chapters/custom-auth.xml | 12 ++++++------
src/chapters/duo-auth.xml | 4 ++--
src/chapters/event-listeners.xml | 12 ++++++------
src/chapters/guacamole-ext.xml | 4 ++--
src/chapters/installing.xml | 14 +++++++-------
src/chapters/jdbc-auth.xml | 16 ++++++++--------
src/chapters/ldap-auth.xml | 4 ++--
src/chapters/openid-auth.xml | 4 ++--
src/chapters/radius-auth.xml | 6 +++---
src/chapters/saml-auth.xml | 4 ++--
src/chapters/totp-auth.xml | 4 ++--
src/chapters/yourown.xml | 10 +++++-----
src/gug.xml | 4 ++--
tutorials/guacamole-auth-tutorial/pom.xml | 4 ++--
.../src/main/resources/guac-manifest.json | 2 +-
tutorials/guacamole-tutorial/pom.xml | 4 ++--
19 files changed, 64 insertions(+), 64 deletions(-)
diff --git a/src/chapters/adhoc-connections.xml b/src/chapters/adhoc-connections.xml
index 277b792..5989547 100644
--- a/src/chapters/adhoc-connections.xml
+++ b/src/chapters/adhoc-connections.xml
@@ -48,7 +48,7 @@
xlink:href="http://guacamole.apache.org/releases/"
>http://guacamole.apache.org/releases/</link>.</para>
<para>The quickconnect extension is packaged as a <filename>.tar.gz</filename> file containing
- only the extension itself, <filename>guacamole-auth-quickconnect-1.2.0.jar</filename>, which must
+ only the extension itself, <filename>guacamole-auth-quickconnect-1.3.0.jar</filename>, which must
ultimately be placed in <filename>GUACAMOLE_HOME/extensions</filename>.</para>
</section>
<section xml:id="installing-quickconnect">
@@ -65,7 +65,7 @@
does not already exist.</para>
</step>
<step>
- <para>Place the <filename>guacamole-auth-quickconnect-1.2.0.jar</filename> file in
+ <para>Place the <filename>guacamole-auth-quickconnect-1.3.0.jar</filename> file in
the <filename>GUACAMOLE_HOME/extensions</filename> directory.</para>
</step>
</procedure>
diff --git a/src/chapters/cas-auth.xml b/src/chapters/cas-auth.xml
index 1331935..bd49657 100644
--- a/src/chapters/cas-auth.xml
+++ b/src/chapters/cas-auth.xml
@@ -23,7 +23,7 @@
>http://guacamole.apache.org/releases/</link>.</para>
<para>The CAS authentication extension is packaged as a <filename>.tar.gz</filename>
file containing only the extension itself,
- <filename>guacamole-auth-cas-1.2.0.jar</filename>, which must
+ <filename>guacamole-auth-cas-1.3.0.jar</filename>, which must
ultimately be placed in <filename>GUACAMOLE_HOME/extensions</filename>.</para>
</section>
<section xml:id="installing-cas-auth">
@@ -40,7 +40,7 @@
does not already exist.</para>
</step>
<step>
- <para>Copy <filename>guacamole-auth-cas-1.2.0.jar</filename> within
+ <para>Copy <filename>guacamole-auth-cas-1.3.0.jar</filename> within
<filename>GUACAMOLE_HOME/extensions</filename>.</para>
</step>
<step>
diff --git a/src/chapters/configuring.xml b/src/chapters/configuring.xml
index dc96a8e..9b7b977 100644
--- a/src/chapters/configuring.xml
+++ b/src/chapters/configuring.xml
@@ -719,7 +719,7 @@ guacd-port: 4822</programlisting>
events:</para>
<informalexample>
<screen><prompt>$</prompt> <userinput>guaclog <replaceable>/path/to/recording/NAME</replaceable></userinput><computeroutput>
-guaclog: INFO: Guacamole input log interpreter (guaclog) version 1.2.0
+guaclog: INFO: Guacamole input log interpreter (guaclog) version 1.3.0
guaclog: INFO: 1 input file(s) provided.
guaclog: INFO: Writing input events from "<replaceable>/path/to/recording/NAME</replaceable>" to "<replaceable annotations="">/path/to/recording/NAME</replaceable>.txt" ...
guaclog: INFO: All files interpreted successfully.</computeroutput>
@@ -2031,7 +2031,7 @@ tcp6 0 0 :::4713 :::* LISTEN</comp
can be used in situations where guacd does
not support passing the timezone parameter
during the handshake phase (guacd versions
- prior to 1.2.0).</para>
+ prior to 1.3.0).</para>
<para>Support for forwarding the client
timezone varies by RDP server implementation.
For example, with Windows, support for
@@ -2195,7 +2195,7 @@ tcp6 0 0 :::4713 :::* LISTEN</comp
events:</para>
<informalexample>
<screen><prompt>$</prompt> <userinput>guaclog <replaceable>/path/to/recording/NAME</replaceable></userinput><computeroutput>
-guaclog: INFO: Guacamole input log interpreter (guaclog) version 1.2.0
+guaclog: INFO: Guacamole input log interpreter (guaclog) version 1.3.0
guaclog: INFO: 1 input file(s) provided.
guaclog: INFO: Writing input events from "<replaceable>/path/to/recording/NAME</replaceable>" to "<replaceable annotations="">/path/to/recording/NAME</replaceable>.txt" ...
guaclog: INFO: All files interpreted successfully.</computeroutput>
@@ -4029,7 +4029,7 @@ writer.sendEnd();</programlisting>
events:</para>
<informalexample>
<screen><prompt>$</prompt> <userinput>guaclog <replaceable>/path/to/recording/NAME</replaceable></userinput><computeroutput>
-guaclog: INFO: Guacamole input log interpreter (guaclog) version 1.2.0
+guaclog: INFO: Guacamole input log interpreter (guaclog) version 1.3.0
guaclog: INFO: 1 input file(s) provided.
guaclog: INFO: Writing input events from "<replaceable>/path/to/recording/NAME</replaceable>" to "<replaceable annotations="">/path/to/recording/NAME</replaceable>.txt" ...
guaclog: INFO: All files interpreted successfully.</computeroutput>
@@ -4988,7 +4988,7 @@ writer.sendEnd();</programlisting>
events:</para>
<informalexample>
<screen><prompt>$</prompt> <userinput>guaclog <replaceable>/path/to/recording/NAME</replaceable></userinput><computeroutput>
-guaclog: INFO: Guacamole input log interpreter (guaclog) version 1.2.0
+guaclog: INFO: Guacamole input log interpreter (guaclog) version 1.3.0
guaclog: INFO: 1 input file(s) provided.
guaclog: INFO: Writing input events from "<replaceable>/path/to/recording/NAME</replaceable>" to "<replaceable annotations="">/path/to/recording/NAME</replaceable>.txt" ...
guaclog: INFO: All files interpreted successfully.</computeroutput>
@@ -5842,7 +5842,7 @@ color9: rgb:80/00/80</programlisting>
events:</para>
<informalexample>
<screen><prompt>$</prompt> <userinput>guaclog <replaceable>/path/to/recording/NAME</replaceable></userinput><computeroutput>
-guaclog: INFO: Guacamole input log interpreter (guaclog) version 1.2.0
+guaclog: INFO: Guacamole input log interpreter (guaclog) version 1.3.0
guaclog: INFO: 1 input file(s) provided.
guaclog: INFO: Writing input events from "<replaceable>/path/to/recording/NAME</replaceable>" to "<replaceable annotations="">/path/to/recording/NAME</replaceable>.txt" ...
guaclog: INFO: All files interpreted successfully.</computeroutput>
diff --git a/src/chapters/custom-auth.xml b/src/chapters/custom-auth.xml
index 3b65c56..481f98f 100644
--- a/src/chapters/custom-auth.xml
+++ b/src/chapters/custom-auth.xml
@@ -58,7 +58,7 @@
<groupId>org.apache.guacamole</groupId>
<artifactId>guacamole-auth-tutorial</artifactId>
<packaging>jar</packaging>
- <version>1.2.0</version>
+ <version>1.3.0</version>
<name>guacamole-auth-tutorial</name>
<properties>
@@ -88,7 +88,7 @@
<dependency>
<groupId>org.apache.guacamole</groupId>
<artifactId>guacamole-ext</artifactId>
- <version>1.2.0</version>
+ <version>1.3.0</version>
<scope>provided</scope>
</dependency>
@@ -172,7 +172,7 @@ public class TutorialAuthenticationProvider extends SimpleAuthenticationProvider
<title>The required <filename>guac-manifest.json</filename></title>
<programlisting>{
- "guacamoleVersion" : "1.2.0",
+ "guacamoleVersion" : "1.3.0",
"name" : "Tutorial Authentication Extension",
"namespace" : "guac-auth-tutorial",
@@ -196,7 +196,7 @@ public class TutorialAuthenticationProvider extends SimpleAuthenticationProvider
<screen><prompt>$</prompt> mvn package
<computeroutput>[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
-[INFO] Building guacamole-auth-tutorial 1.2.0
+[INFO] Building guacamole-auth-tutorial 1.3.0
[INFO] ------------------------------------------------------------------------
...
[INFO] ------------------------------------------------------------------------
@@ -210,7 +210,7 @@ public class TutorialAuthenticationProvider extends SimpleAuthenticationProvider
</informalexample>
<para>Assuming you see the "<computeroutput>BUILD SUCCESS</computeroutput>" message when you
build the extension, there will be a new file,
- <filename>target/guacamole-auth-tutorial-1.2.0.jar</filename>, which can be
+ <filename>target/guacamole-auth-tutorial-1.3.0.jar</filename>, which can be
installed within Guacamole and tested. If you changed the name or version of the project
in the <filename>pom.xml</filename> file, the name of this new <filename>.jar</filename>
file will be different, but it can still be found within
@@ -472,7 +472,7 @@ public Map<String, GuacamoleConfiguration>
user running Tomcat.</para>
<para>To install your extension, ensure that the required properties have been added to your
<filename>guacamole.properties</filename>, copy the
- <filename>target/guacamole-auth-tutorial-1.2.0.jar</filename> file into
+ <filename>target/guacamole-auth-tutorial-1.3.0.jar</filename> file into
<filename>GUACAMOLE_HOME/extensions</filename> and restart Tomcat. Guacamole will
automatically load your extension, logging an informative message that it has done
so:</para>
diff --git a/src/chapters/duo-auth.xml b/src/chapters/duo-auth.xml
index 680e104..c02f5ef 100644
--- a/src/chapters/duo-auth.xml
+++ b/src/chapters/duo-auth.xml
@@ -55,7 +55,7 @@
>http://guacamole.apache.org/releases/</link>.</para>
<para>The Duo authentication extension is packaged as a <filename>.tar.gz</filename> file
containing only the extension itself,
- <filename>guacamole-auth-duo-1.2.0.jar</filename>, which must ultimately
+ <filename>guacamole-auth-duo-1.3.0.jar</filename>, which must ultimately
be placed in <filename>GUACAMOLE_HOME/extensions</filename>.</para>
</section>
<section xml:id="installing-duo-auth">
@@ -69,7 +69,7 @@
does not already exist.</para>
</step>
<step>
- <para>Copy <filename>guacamole-auth-duo-1.2.0.jar</filename> within
+ <para>Copy <filename>guacamole-auth-duo-1.3.0.jar</filename> within
<filename>GUACAMOLE_HOME/extensions</filename>.</para>
</step>
<step>
diff --git a/src/chapters/event-listeners.xml b/src/chapters/event-listeners.xml
index 63706c3..5d5b50f 100644
--- a/src/chapters/event-listeners.xml
+++ b/src/chapters/event-listeners.xml
@@ -52,7 +52,7 @@
<groupId>org.apache.guacamole</groupId>
<artifactId>guacamole-listener-tutorial</artifactId>
<packaging>jar</packaging>
- <version>1.2.0</version>
+ <version>1.3.0</version>
<name>guacamole-listener-tutorial</name>
<properties>
@@ -82,7 +82,7 @@
<dependency>
<groupId>org.apache.guacamole</groupId>
<artifactId>guacamole-ext</artifactId>
- <version>1.2.0</version>
+ <version>1.3.0</version>
<scope>provided</scope>
</dependency>
@@ -159,7 +159,7 @@ public class TutorialListener implements Listener {
<title>The required <filename>guac-manifest.json</filename></title>
<programlisting>{
- "guacamoleVersion" : "1.2.0",
+ "guacamoleVersion" : "1.3.0",
"name" : "Tutorial Listener Extension",
"namespace" : "guac-listener-tutorial",
@@ -179,7 +179,7 @@ public class TutorialListener implements Listener {
<screen><prompt>$</prompt> mvn package
<computeroutput>[INFO] Scanning for projects...
[INFO] ---------------------------------------------------------------
-[INFO] Building guacamole-listener-tutorial 1.2.0
+[INFO] Building guacamole-listener-tutorial 1.3.0
[INFO] ---------------------------------------------------------------
...
[INFO] ---------------------------------------------------------------
@@ -193,7 +193,7 @@ public class TutorialListener implements Listener {
</informalexample>
<para>Assuming you see the "<computeroutput>BUILD SUCCESS</computeroutput>" message when you
build the extension, there will be a new file,
- <filename>target/guacamole-listener-tutorial-1.2.0.jar</filename>, which can be
+ <filename>target/guacamole-listener-tutorial-1.3.0.jar</filename>, which can be
installed within Guacamole (see <xref xmlns:xlink="http://www.w3.org/1999/xlink"
linkend="custom-listener-installing"/> at the end of this chapter). It should log
event notifications that occur during, for example, authentication attempts.
@@ -341,7 +341,7 @@ public class TutorialListener implements Listener {
will be the <filename>.guacamole</filename> directory within the home directory of the
user running Tomcat.</para>
<para>To install your extension, copy the
- <filename>target/guacamole-listener-tutorial-1.2.0.jar</filename> file into
+ <filename>target/guacamole-listener-tutorial-1.3.0.jar</filename> file into
<filename>GUACAMOLE_HOME/extensions</filename> and restart Tomcat. Guacamole will
automatically load your extension, logging an informative message that it has done
so:</para>
diff --git a/src/chapters/guacamole-ext.xml b/src/chapters/guacamole-ext.xml
index 799a16c..09bbb3f 100644
--- a/src/chapters/guacamole-ext.xml
+++ b/src/chapters/guacamole-ext.xml
@@ -186,7 +186,7 @@
<filename>guac-manifest.json</filename> will look something like this:</para>
<informalexample>
<programlisting>{
- "guacamoleVersion" : "1.2.0",
+ "guacamoleVersion" : "1.3.0",
"name" : "My Extension",
"namespace" : "my-extension"
}</programlisting>
@@ -198,7 +198,7 @@
<informalexample>
<programlisting>{
- "guacamoleVersion" : "1.2.0",
+ "guacamoleVersion" : "1.3.0",
"name" : "My Extension",
"namespace" : "my-extension",
diff --git a/src/chapters/installing.xml b/src/chapters/installing.xml
index ba94a32..423497f 100644
--- a/src/chapters/installing.xml
+++ b/src/chapters/installing.xml
@@ -618,8 +618,8 @@
of a <filename>.tar.gz</filename> archive which you can extract from the command
line:</para>
<informalexample>
- <screen><prompt>$</prompt> <userinput>tar -xzf guacamole-server-1.2.0.tar.gz</userinput>
-<prompt>$</prompt> <userinput>cd guacamole-server-1.2.0/</userinput>
+ <screen><prompt>$</prompt> <userinput>tar -xzf guacamole-server-1.3.0.tar.gz</userinput>
+<prompt>$</prompt> <userinput>cd guacamole-server-1.3.0/</userinput>
<prompt>$</prompt></screen>
</informalexample>
<para>If you want the absolute latest code, and don't care that the code hasn't been as
@@ -671,7 +671,7 @@ checking whether build environment is sane... yes
...
------------------------------------------------
-guacamole-server version 1.2.0
+guacamole-server version 1.3.0
------------------------------------------------
Library status:
@@ -854,8 +854,8 @@ make[1]: Leaving directory `/home/zhz/guacamole/guacamole-server'</computeroutpu
<filename>.tar.gz</filename> archive which you can extract from the command
line:</para>
<informalexample>
- <screen><prompt>$</prompt> <userinput>tar -xzf guacamole-client-1.2.0.tar.gz</userinput>
-<prompt>$</prompt> <userinput>cd guacamole-client-1.2.0/</userinput>
+ <screen><prompt>$</prompt> <userinput>tar -xzf guacamole-client-1.3.0.tar.gz</userinput>
+<prompt>$</prompt> <userinput>cd guacamole-client-1.3.0/</userinput>
<prompt>$</prompt></screen>
</informalexample>
<para>As with <package>guacamole-server</package>, if you want the absolute latest code, and
@@ -967,7 +967,7 @@ Resolving deltas: 100% (3942/3942), done.</computeroutput>
application from the name of the <filename>.war</filename> file, you will likely want to
rename this to simply <filename>guacamole.war</filename> while copying:</para>
<informalexample>
- <screen><prompt>#</prompt> <userinput>cp guacamole/target/guacamole-1.2.0.war <replaceable>/var/lib/tomcat/webapps</replaceable>/guacamole.war</userinput>
+ <screen><prompt>#</prompt> <userinput>cp guacamole/target/guacamole-1.3.0.war <replaceable>/var/lib/tomcat/webapps</replaceable>/guacamole.war</userinput>
<prompt>#</prompt></screen>
</informalexample>
<para>Again, if you are using a different servlet container or if Tomcat is installed to a
@@ -985,7 +985,7 @@ Resolving deltas: 100% (3942/3942), done.</computeroutput>
Starting Tomcat... OK</computeroutput>
<prompt>#</prompt> <userinput>/etc/init.d/guacd start</userinput>
<computeroutput>Starting guacd: SUCCESS
-guacd[6229]: INFO: Guacamole proxy daemon (guacd) version 1.2.0 started</computeroutput>
+guacd[6229]: INFO: Guacamole proxy daemon (guacd) version 1.3.0 started</computeroutput>
<prompt>#</prompt></screen>
</informalexample>
<important>
diff --git a/src/chapters/jdbc-auth.xml b/src/chapters/jdbc-auth.xml
index d14e0be..869a52d 100644
--- a/src/chapters/jdbc-auth.xml
+++ b/src/chapters/jdbc-auth.xml
@@ -62,10 +62,10 @@
<term><filename>mysql/</filename></term>
<listitem>
<para>Contains the MySQL/MariaDB authentication extension,
- <filename>guacamole-auth-jdbc-mysql-1.2.0.jar</filename>, along with a
+ <filename>guacamole-auth-jdbc-mysql-1.3.0.jar</filename>, along with a
<filename>schema/</filename> directory containing MySQL-specific SQL
scripts required to set up the database. The
- <filename>guacamole-auth-jdbc-mysql-1.2.0.jar</filename> file will
+ <filename>guacamole-auth-jdbc-mysql-1.3.0.jar</filename> file will
ultimately need to be placed within
<filename>GUACAMOLE_HOME/extensions</filename>, while the MySQL JDBC
driver must be placed within <filename>GUACAMOLE_HOME/lib</filename>.</para>
@@ -274,10 +274,10 @@ mysql-server-timezone: GMT-9</programlisting>
<term><filename>postgresql/</filename></term>
<listitem>
<para>Contains the PostgreSQL authentication extension,
- <filename>guacamole-auth-jdbc-postgresql-1.2.0.jar</filename>, along
+ <filename>guacamole-auth-jdbc-postgresql-1.3.0.jar</filename>, along
with a <filename>schema/</filename> directory containing PostgreSQL-specific
SQL scripts required to set up the database. The
- <filename>guacamole-auth-jdbc-postgresql-1.2.0.jar</filename> file will
+ <filename>guacamole-auth-jdbc-postgresql-1.3.0.jar</filename> file will
ultimately need to be placed within
<filename>GUACAMOLE_HOME/extensions</filename>, while the PostgreSQL
JDBC driver must be placed within
@@ -466,7 +466,7 @@ mysql-server-timezone: GMT-9</programlisting>
<term><filename>sqlserver/</filename></term>
<listitem>
<para>Contains the SQL Server authentication extension,
- <filename>guacamole-auth-jdbc-sqlserver-1.2.0.jar</filename>, along with
+ <filename>guacamole-auth-jdbc-sqlserver-1.3.0.jar</filename>, along with
a <filename>schema/</filename> directory contains SQL Server-specific
scripts requires to set up the database. The JAR extension file will need to
be placed within the <filename>GUACAMOLE_HOME/extensions</filename> folder,
@@ -725,11 +725,11 @@ Type "help" for help.
does not already exist.</para>
</step>
<step>
- <para>Copy <filename>guacamole-auth-jdbc-mysql-1.2.0.jar</filename>
+ <para>Copy <filename>guacamole-auth-jdbc-mysql-1.3.0.jar</filename>
<emphasis>or</emphasis>
- <filename>guacamole-auth-jdbc-postgresql-1.2.0.jar</filename>
+ <filename>guacamole-auth-jdbc-postgresql-1.3.0.jar</filename>
<emphasis>or</emphasis>
- <filename>guacamole-auth-jdbc-sqlserver-1.2.0.jar</filename> within
+ <filename>guacamole-auth-jdbc-sqlserver-1.3.0.jar</filename> within
<filename>GUACAMOLE_HOME/extensions</filename>, depending on whether you are
using MySQL/MariaDB, PostgreSQL, or SQL Server.</para>
</step>
diff --git a/src/chapters/ldap-auth.xml b/src/chapters/ldap-auth.xml
index c4c2410..750d7ea 100644
--- a/src/chapters/ldap-auth.xml
+++ b/src/chapters/ldap-auth.xml
@@ -83,7 +83,7 @@
containing:</para>
<variablelist>
<varlistentry>
- <term><filename>guacamole-auth-ldap-1.2.0.jar</filename></term>
+ <term><filename>guacamole-auth-ldap-1.3.0.jar</filename></term>
<listitem>
<para>The Guacamole LDAP support extension itself, which must be placed in
<filename>GUACAMOLE_HOME/extensions</filename>.</para>
@@ -214,7 +214,7 @@ dn: cn={4}guacConfigGroup,cn=schema,cn=config
does not already exist.</para>
</step>
<step>
- <para>Copy <filename>guacamole-auth-ldap-1.2.0.jar</filename> within
+ <para>Copy <filename>guacamole-auth-ldap-1.3.0.jar</filename> within
<filename>GUACAMOLE_HOME/extensions</filename>.</para>
</step>
<step>
diff --git a/src/chapters/openid-auth.xml b/src/chapters/openid-auth.xml
index dd98f86..6027fba 100644
--- a/src/chapters/openid-auth.xml
+++ b/src/chapters/openid-auth.xml
@@ -31,7 +31,7 @@
>http://guacamole.apache.org/releases/</link>.</para>
<para>The OpenID Connect authentication extension is packaged as a
<filename>.tar.gz</filename> file containing only the extension itself,
- <filename>guacamole-auth-openid-1.2.0.jar</filename>, which must ultimately be
+ <filename>guacamole-auth-openid-1.3.0.jar</filename>, which must ultimately be
placed in <filename>GUACAMOLE_HOME/extensions</filename>.</para>
</section>
<section xml:id="installing-openid-auth">
@@ -48,7 +48,7 @@
does not already exist.</para>
</step>
<step>
- <para>Copy <filename>guacamole-auth-openid-1.2.0.jar</filename> within
+ <para>Copy <filename>guacamole-auth-openid-1.3.0.jar</filename> within
<filename>GUACAMOLE_HOME/extensions</filename>.</para>
</step>
<step>
diff --git a/src/chapters/radius-auth.xml b/src/chapters/radius-auth.xml
index e226493..37b1c3d 100644
--- a/src/chapters/radius-auth.xml
+++ b/src/chapters/radius-auth.xml
@@ -29,7 +29,7 @@
<screen><prompt>$</prompt> <userinput>mvn clean package -Plgpl-extensions</userinput>
<computeroutput>[INFO] --- maven-assembly-plugin:2.5.3:single (make-source-archive) @ guacamole-client ---
[INFO] Reading assembly descriptor: project-assembly.xml
-[INFO] Building tar: /home/guac/guacamole-client/target/guacamole-client-1.2.0.tar.gz
+[INFO] Building tar: /home/guac/guacamole-client/target/guacamole-client-1.3.0.tar.gz
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO]
@@ -65,7 +65,7 @@
<para>After the build completes successfully, the extension will be in the
<filename>extensions/guacamole-auth-radius/target/</filename> directory, and will be
- called guacamole-auth-radius-1.2.0.jar. This extension file can be copied to
+ called guacamole-auth-radius-1.3.0.jar. This extension file can be copied to
the <filename>GUACAMOLE_HOME/extensions</filename> directory.
<emphasis>If you are unsure where <varname>GUACAMOLE_HOME</varname> is located on
your system, please consult <xref linkend="configuring-guacamole"/> before
@@ -86,7 +86,7 @@
does not already exist.</para>
</step>
<step>
- <para>Copy <filename>guacamole-auth-radius-1.2.0.jar</filename> into
+ <para>Copy <filename>guacamole-auth-radius-1.3.0.jar</filename> into
<filename>GUACAMOLE_HOME/extensions</filename>.</para>
</step>
<step>
diff --git a/src/chapters/saml-auth.xml b/src/chapters/saml-auth.xml
index 1fa89d3..833e1e2 100644
--- a/src/chapters/saml-auth.xml
+++ b/src/chapters/saml-auth.xml
@@ -24,7 +24,7 @@
>http://guacamole.apache.org/releases/</link>.</para>
<para>The SAML authentication extension is packaged as a <filename>.tar.gz</filename>
file containing only the extension itself,
- <filename>guacamole-auth-saml-1.2.0.jar</filename>, which must
+ <filename>guacamole-auth-saml-1.3.0.jar</filename>, which must
ultimately be placed in <filename>GUACAMOLE_HOME/extensions</filename>.</para>
</section>
<section xml:id="installing-saml-auth">
@@ -41,7 +41,7 @@
does not already exist.</para>
</step>
<step>
- <para>Copy <filename>guacamole-auth-saml-1.2.0.jar</filename> within
+ <para>Copy <filename>guacamole-auth-saml-1.3.0.jar</filename> within
<filename>GUACAMOLE_HOME/extensions</filename>.</para>
</step>
<step>
diff --git a/src/chapters/totp-auth.xml b/src/chapters/totp-auth.xml
index ca9bd53..32954a3 100644
--- a/src/chapters/totp-auth.xml
+++ b/src/chapters/totp-auth.xml
@@ -93,7 +93,7 @@
>http://guacamole.apache.org/releases/</link>.</para>
<para>The TOTP authentication extension is packaged as a <filename>.tar.gz</filename> file
containing only the extension itself,
- <filename>guacamole-auth-totp-1.2.0.jar</filename>, which must ultimately be placed in
+ <filename>guacamole-auth-totp-1.3.0.jar</filename>, which must ultimately be placed in
<filename>GUACAMOLE_HOME/extensions</filename>.</para>
</section>
<section xml:id="installing-totp-auth">
@@ -107,7 +107,7 @@
does not already exist.</para>
</step>
<step>
- <para>Copy <filename>guacamole-auth-totp-1.2.0.jar</filename> within
+ <para>Copy <filename>guacamole-auth-totp-1.3.0.jar</filename> within
<filename>GUACAMOLE_HOME/extensions</filename>.</para>
</step>
<step>
diff --git a/src/chapters/yourown.xml b/src/chapters/yourown.xml
index daa41c6..33aba87 100644
--- a/src/chapters/yourown.xml
+++ b/src/chapters/yourown.xml
@@ -112,7 +112,7 @@
<groupId>org.apache.guacamole</groupId>
<artifactId>guacamole-tutorial</artifactId>
<packaging>war</packaging>
- <version>1.2.0</version>
+ <version>1.3.0</version>
<name>guacamole-tutorial</name>
<properties>
@@ -201,7 +201,7 @@
</informalexample>
<para>Assuming you see the "<computeroutput>BUILD SUCCESSFUL</computeroutput>" message
when you build the web application, there will be a new file,
- <filename>target/guacamole-tutorial-1.2.0.war</filename>, which
+ <filename>target/guacamole-tutorial-1.3.0.war</filename>, which
can be deployed to your servlet container and tested. If you changed the name or
version of the project in the <filename>pom.xml</filename> file, the name of this new
<filename>.war</filename> file will be different, but it can still be found
@@ -312,7 +312,7 @@
<dependency>
<groupId>org.apache.guacamole</groupId>
<artifactId>guacamole-common-js</artifactId>
- <version>1.2.0</version>
+ <version>1.3.0</version>
<type>zip</type>
<scope>runtime</scope>
</dependency>
@@ -331,7 +331,7 @@
web application should build successfully, and the Guacamole JavaScript API should
be accessible in the <filename>guacamole-common-js/</filename> subdirectory of your
web application after it is deployed. A quick check that you can access
- <uri>/guacamole-tutorial-1.2.0/guacamole-common-js/all.min.js</uri>
+ <uri>/guacamole-tutorial-1.3.0/guacamole-common-js/all.min.js</uri>
is probably worth the effort.</para>
</section>
<section xml:id="simple-tunnel">
@@ -430,7 +430,7 @@ public class TutorialGuacamoleTunnelServlet
to the URL we wish to use when making HTTP requests to the servlet:
<uri>/tunnel</uri>. This URL is relative to the context root of the web
application. In the case of this web application, the final absolute URL will be
- <uri>/guacamole-tutorial-1.2.0/tunnel</uri>.</para>
+ <uri>/guacamole-tutorial-1.3.0/tunnel</uri>.</para>
</section>
<section xml:id="simple-client">
<title>Adding the client</title>
diff --git a/src/gug.xml b/src/gug.xml
index f09ba87..2dbe1fb 100644
--- a/src/gug.xml
+++ b/src/gug.xml
@@ -3,7 +3,7 @@
xmlns:xi="http://www.w3.org/2001/XInclude">
<info>
<title>Guacamole Manual</title>
- <edition>1.2.0</edition>
+ <edition>1.3.0</edition>
<legalnotice>
<para>Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the <link xmlns:xlink="http://www.w3.org/1999/xlink"
@@ -42,7 +42,7 @@
application, etc.) to give a good starting point beyond simply looking at the Guacamole
codebase.</para>
<para>This particular edition of the <citetitle>Guacamole Manual</citetitle> covers
- Guacamole version 1.2.0. New releases which create new features or break
+ Guacamole version 1.3.0. New releases which create new features or break
compatibility will result in new editions of the user's guide, as will any necessary
corrections. As the official documentation for the project, this book will always be
freely available in its entirety online.</para>
diff --git a/tutorials/guacamole-auth-tutorial/pom.xml b/tutorials/guacamole-auth-tutorial/pom.xml
index 1ee80c9..5aecdc3 100644
--- a/tutorials/guacamole-auth-tutorial/pom.xml
+++ b/tutorials/guacamole-auth-tutorial/pom.xml
@@ -7,7 +7,7 @@
<groupId>org.apache.guacamole</groupId>
<artifactId>guacamole-auth-tutorial</artifactId>
<packaging>jar</packaging>
- <version>1.2.0</version>
+ <version>1.3.0</version>
<name>guacamole-auth-tutorial</name>
<properties>
@@ -37,7 +37,7 @@
<dependency>
<groupId>org.apache.guacamole</groupId>
<artifactId>guacamole-ext</artifactId>
- <version>1.2.0</version>
+ <version>1.3.0</version>
<scope>provided</scope>
</dependency>
diff --git a/tutorials/guacamole-auth-tutorial/src/main/resources/guac-manifest.json b/tutorials/guacamole-auth-tutorial/src/main/resources/guac-manifest.json
index 2e02cc4..4ee61bc 100644
--- a/tutorials/guacamole-auth-tutorial/src/main/resources/guac-manifest.json
+++ b/tutorials/guacamole-auth-tutorial/src/main/resources/guac-manifest.json
@@ -1,6 +1,6 @@
{
- "guacamoleVersion" : "1.2.0",
+ "guacamoleVersion" : "1.3.0",
"name" : "Tutorial Authentication Extension",
"namespace" : "guac-auth-tutorial",
diff --git a/tutorials/guacamole-tutorial/pom.xml b/tutorials/guacamole-tutorial/pom.xml
index fb3977c..bf85c5c 100644
--- a/tutorials/guacamole-tutorial/pom.xml
+++ b/tutorials/guacamole-tutorial/pom.xml
@@ -7,7 +7,7 @@
<groupId>org.apache.guacamole</groupId>
<artifactId>guacamole-tutorial</artifactId>
<packaging>war</packaging>
- <version>1.2.0</version>
+ <version>1.3.0</version>
<name>guacamole-tutorial</name>
<properties>
@@ -70,7 +70,7 @@
<dependency>
<groupId>org.apache.guacamole</groupId>
<artifactId>guacamole-common-js</artifactId>
- <version>1.2.0</version>
+ <version>1.3.0</version>
<type>zip</type>
<scope>runtime</scope>
</dependency>
[guacamole-manual] 04/05: GUACAMOLE-1205: Merge bump of updated
component versions to 1.3.0.
Posted by mj...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
mjumper pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/guacamole-manual.git
commit 37f5f72ba83310cc1dfffa9d00694e9e1b2e018f
Merge: 0d50efa f7276ce
Author: Mike Jumper <mj...@apache.org>
AuthorDate: Wed Nov 4 23:38:37 2020 -0800
GUACAMOLE-1205: Merge bump of updated component versions to 1.3.0.
src/chapters/adhoc-connections.xml | 4 ++--
src/chapters/cas-auth.xml | 4 ++--
src/chapters/configuring.xml | 12 ++++++------
src/chapters/custom-auth.xml | 12 ++++++------
src/chapters/duo-auth.xml | 4 ++--
src/chapters/event-listeners.xml | 12 ++++++------
src/chapters/guacamole-ext.xml | 4 ++--
src/chapters/installing.xml | 14 +++++++-------
src/chapters/jdbc-auth.xml | 16 ++++++++--------
src/chapters/ldap-auth.xml | 4 ++--
src/chapters/openid-auth.xml | 4 ++--
src/chapters/radius-auth.xml | 6 +++---
src/chapters/saml-auth.xml | 4 ++--
src/chapters/totp-auth.xml | 4 ++--
src/chapters/yourown.xml | 10 +++++-----
src/gug.xml | 4 ++--
tutorials/guacamole-auth-tutorial/pom.xml | 4 ++--
.../src/main/resources/guac-manifest.json | 2 +-
tutorials/guacamole-tutorial/pom.xml | 4 ++--
19 files changed, 64 insertions(+), 64 deletions(-)