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:
[email protected]
With regards,
Apache Git Services
