org.apache.guacamole.net.auth

Class TokenInjectingConnectionGroup

java.lang.Object

org.apache.guacamole.net.auth.DelegatingConnectionGroup

org.apache.guacamole.net.auth.TokenInjectingConnectionGroup

All Implemented Interfaces:

Attributes, Connectable, ConnectionGroup, Identifiable

public class TokenInjectingConnectionGroup
extends DelegatingConnectionGroup

ConnectionGroup implementation which overrides the connect() function of an underlying ConnectionGroup, adding a given set of parameter tokens to the tokens already supplied.

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.guacamole.net.auth.ConnectionGroup

ConnectionGroup.Type

Constructor Summary

Constructors

Constructor and Description
TokenInjectingConnectionGroup(ConnectionGroup connectionGroup, Map<String,String> tokens) Wraps the given ConnectionGroup, automatically adding the given tokens to each invocation of connect().

Method Summary

Modifier and Type	Method and Description
org.apache.guacamole.net.GuacamoleTunnel	connect(org.apache.guacamole.protocol.GuacamoleClientInformation info, Map<String,String> tokens) Establishes a connection to guacd using the information associated with this object.

Methods inherited from class org.apache.guacamole.net.auth.DelegatingConnectionGroup

connect, getActiveConnections, getAttributes, getConnectionGroupIdentifiers, getConnectionIdentifiers, getDelegateConnectionGroup, getIdentifier, getName, getParentIdentifier, getType, setAttributes, setIdentifier, setName, setParentIdentifier, setType

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TokenInjectingConnectionGroup

public TokenInjectingConnectionGroup(ConnectionGroup connectionGroup,
                                     Map<String,String> tokens)

Wraps the given ConnectionGroup, automatically adding the given tokens to each invocation of connect(). Any additional tokens which have the same name as existing tokens will override the existing values.

Parameters:

connectionGroup - The ConnectionGroup to wrap.

tokens - The additional tokens to include with each call to connect().

Method Detail

connect

public org.apache.guacamole.net.GuacamoleTunnel connect(org.apache.guacamole.protocol.GuacamoleClientInformation info,
                                                        Map<String,String> tokens)
                                                 throws org.apache.guacamole.GuacamoleException

Description copied from interface: Connectable

Establishes a connection to guacd using the information associated with this object. The connection will be provided the given client information. Implementations which support parameter tokens should apply the given tokens when configuring the connection, such as with a TokenFilter.

Specified by:

connect in interface Connectable

Overrides:

connect in class DelegatingConnectionGroup

Parameters:

info - Information associated with the connecting client.

tokens - A Map containing the token names and corresponding values to be applied as parameter tokens when establishing the connection. If the implementation does not support parameter tokens, this Map may be ignored.

Returns:

A fully-established GuacamoleTunnel.

Throws:

org.apache.guacamole.GuacamoleException - If an error occurs while connecting to guacd, or if permission to connect is denied.

See Also:

Parameter Tokens