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 2019/08/12 19:08:25 UTC
[GitHub] [guacamole-manual] mike-jumper commented on a change in pull
request #120: GUACAMOLE-579: Add documentation for CAS extension tokens.
mike-jumper commented on a change in pull request #120: GUACAMOLE-579: Add documentation for CAS extension tokens.
URL: https://github.com/apache/guacamole-manual/pull/120#discussion_r313082729
##########
File path: src/chapters/configuring.xml
##########
@@ -5254,6 +5257,57 @@ guaclog: INFO: All files interpreted successfully.</computeroutput>
two different users access the same connection at the same time, both users will be
connected independently of each other using different sets of connection
parameters.</para>
+ <section xml:id="extension-tokens">
+ <title>Extension-specific tokens</title>
+ <indexterm>
+ <primary>tokens</primary>
+ <secondary>extension-specific</secondary>
+ </indexterm>
+ <para>Each extension can also implement its own arbitrary tokens that can dynamically
+ fill in values provided by the extension. Within these extensions, attribute
+ names are canonicalized into a standard format that consists of all capital
+ letters separated by underscores.</para>
+ <section xml:id="cas-tokens">
+ <title>CAS Extension Tokens</title>
+ <indexterm>
+ <primary>tokens</primary>
+ <secondary>cas</secondary>
+ </indexterm>
+ <para>The CAS extension will read attributes provided by the CAS server when
+ a user is authenticated and will make those attributes available as
+ tokens. The CAS server must be specifically configured to release certain
+ attributes to the client (Guacamole), and configuration of that is outside
+ the scope of this document. Any attribute that the CAS server is
+ configured to release should be available to Guacamole as a token for
+ use within a connection. The token name will be prepended with the
+ <constant>CAS_</constant> prefix. A CAS server configured to release
+ attributes <varname>firstname</varname>, <varname>lastname</varname>,
+ <varname>email</varname>, and <varname>mobile</varname> would produce the
+ following tokens:</para>
+ <variablelist>
Review comment:
The [DocBook `<variablelist>` element](https://tdg.docbook.org/tdg/4.5/variablelist.html) is defined as:
> A list in which each entry is composed of a set of one or more terms and an associated description
If there is no associated definition for each `<term>`, then a different type of list would be better, such as [`<itemizedlist>`](https://tdg.docbook.org/tdg/4.5/itemizedlist.html).
----------------------------------------------------------------
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
With regards,
Apache Git Services