You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@guacamole.apache.org by GitBox <gi...@apache.org> on 2020/11/03 14:17:43 UTC

[GitHub] [guacamole-manual] necouchman opened a new pull request #149: GUACAMOLE-221: Document connection parameter prompting.

necouchman opened a new pull request #149:
URL: https://github.com/apache/guacamole-manual/pull/149


   Seems like there isn't all that much to update for parameter prompting, so hopefully this takes care of it. Let me know if anything else needs to be added/adjusted.


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [guacamole-manual] necouchman commented on pull request #149: GUACAMOLE-221: Document connection parameter prompting.

Posted by GitBox <gi...@apache.org>.
necouchman commented on pull request #149:
URL: https://github.com/apache/guacamole-manual/pull/149#issuecomment-721829985


   Okay, I've updated a couple of the other sections that talk about NLA to include some words on prompting.


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [guacamole-manual] mike-jumper commented on a change in pull request #149: GUACAMOLE-221: Document connection parameter prompting.

Posted by GitBox <gi...@apache.org>.
mike-jumper commented on a change in pull request #149:
URL: https://github.com/apache/guacamole-manual/pull/149#discussion_r516881410



##########
File path: src/chapters/configuring.xml
##########
@@ -6195,6 +6195,33 @@ 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 a connection to a
+                    RDP server specifies a username and password, and that username

Review comment:
       I think this should be clarified to refer to a "connection configuration" or "the configuration of a connection" or similar, rather than just "connection".

##########
File path: src/chapters/configuring.xml
##########
@@ -6195,6 +6195,33 @@ 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 a connection to a
+                    RDP server specifies a username and password, and that username
+                    or password is incorrect and results in an  authentication failure,
+                    the connection will fail and the user will not be prompted for
+                    alternative credentials.</para>

Review comment:
       > ... the user will not be prompted for alternative credentials.
   
   Some RDP servers will still take it upon themselves to display a login screen and prompt for correct credentials (if NLA is not in use). It's good to assure the admin that Guacamole will not prompt the user for these things, but I think we should be more specific with that assurance.




----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [guacamole-manual] necouchman commented on pull request #149: GUACAMOLE-221: Document connection parameter prompting.

Posted by GitBox <gi...@apache.org>.
necouchman commented on pull request #149:
URL: https://github.com/apache/guacamole-manual/pull/149#issuecomment-721419551


   > Thoughts on other parts of the docs referencing NLA? I think the following is no longer correct
   
   Sure, I'll take a look through and make sure those get cleaned up.


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [guacamole-manual] mike-jumper merged pull request #149: GUACAMOLE-221: Document connection parameter prompting.

Posted by GitBox <gi...@apache.org>.
mike-jumper merged pull request #149:
URL: https://github.com/apache/guacamole-manual/pull/149


   


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org