You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@guacamole.apache.org by vn...@apache.org on 2018/09/28 19:52:21 UTC
[10/19] guacamole-manual git commit: GUACAMOLE-524: Added exmaples
and links for attribute tokens
GUACAMOLE-524: Added exmaples and links for attribute tokens
Project: http://git-wip-us.apache.org/repos/asf/guacamole-manual/repo
Commit: http://git-wip-us.apache.org/repos/asf/guacamole-manual/commit/86cbb0b8
Tree: http://git-wip-us.apache.org/repos/asf/guacamole-manual/tree/86cbb0b8
Diff: http://git-wip-us.apache.org/repos/asf/guacamole-manual/diff/86cbb0b8
Branch: refs/heads/staging/1.0.0
Commit: 86cbb0b86bb71cdb50ecaac5361dea5ee3127a32
Parents: df26b02
Author: Jared Frees <fr...@osu.edu>
Authored: Tue Jul 10 11:46:02 2018 -0400
Committer: Jared Frees <fr...@osu.edu>
Committed: Tue Jul 10 11:46:02 2018 -0400
----------------------------------------------------------------------
src/chapters/configuring.xml | 4 ++++
src/chapters/ldap-auth.xml | 12 ++++++++++++
2 files changed, 16 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/guacamole-manual/blob/86cbb0b8/src/chapters/configuring.xml
----------------------------------------------------------------------
diff --git a/src/chapters/configuring.xml b/src/chapters/configuring.xml
index de25f7e..d0548ff 100644
--- a/src/chapters/configuring.xml
+++ b/src/chapters/configuring.xml
@@ -4042,6 +4042,10 @@ guaclog: INFO: All files interpreted successfully.</computeroutput>
modules that implement the feature. There are an arbitrary
number of these tokens. If no attributes are specified
then this token does not exist.</para>
+ <para>For example, if an attribute name is specified as "mail" then a token would
+ be set as ${GUAC_ATTR_MAIL} with the value of "mail" in the authentication
+ module that "mail" is specified in. For a practical example, see
+ <property>ldap-user-attributes</property> in <xref linkend="ldap-auth"/>.</para>
</listitem>
</varlistentry>
</variablelist>
http://git-wip-us.apache.org/repos/asf/guacamole-manual/blob/86cbb0b8/src/chapters/ldap-auth.xml
----------------------------------------------------------------------
diff --git a/src/chapters/ldap-auth.xml b/src/chapters/ldap-auth.xml
index 58f9dbf..45e728d 100644
--- a/src/chapters/ldap-auth.xml
+++ b/src/chapters/ldap-auth.xml
@@ -368,6 +368,18 @@ dn: cn={4}guacConfigGroup,cn=schema,cn=config
If the attribute has multiple values in the LDAP directory then the token
saves the first value of the attribute. Multiple attributes can be
specified here, separated by commas.</para>
+ <para>For example, if <property>ldap-user-attributes</property> is
+ "<systemitem>mail, workstation</systemitem>", then a GUAC_ATTR_MAIL
+ token would be set to the value of the mail attribute in the LDAP directory
+ for the currently logged-in user and a GUAC_ATTR_WORKSTATION token
+ would be set to the value of the workstation attribute similarly,
+ contingent on the fact that the attributes have a value in the LDAP directory.
+ So, the tokens could be used like this:
+ <varname>${GUAC_ATTR_MAIL}</varname> or <varname>${GUAC_ATTR_WORKSTATION}/<varname>.
+ If the value of mail in the LDAP directory is "example@email.com" then
+ ${GUAC_ATTR_MAIL} would have the value "example@email.com".
+ Tokens usage is discussed more in <xref linkend="configuring-guacamole"/> in
+ <xref linkend="parameter-tokens"/>.</para>
</listitem>
</varlistentry>
<varlistentry>