Skip past navigation linksSecure Global Desktop 4.31 Administration Guide > Applets > Framework applet parameters

Framework applet parameters

The framework applet has the following parameters:

Parameter Type Default Description
AnonLogin Boolean false

This parameter is used to control whether users see the standard Secure Global Desktop login page or the kiosk-style login page. Whether anonymous users can log or not is controlled by the Anonymous user login authority setting in Array Manager.

Use the placeholder %%ANONLOGIN%% to let Secure Global Desktop supply the correct value for this parameter. You should only enter a particular value for this parameter (rather than the placeholder) if you're sure you know what you're doing.

AsadKeepAlive Integer 100

The interval in seconds at which "keep alive" packets are sent from the client to the server.

AsadPort Integer No default

The TCP port the framework applet uses to communicate with the Secure Global Desktop server.

Use the placeholder %%ASADPORT%% to let Secure Global Desktop supply the correct value for this parameter. You should only enter a particular value for this parameter (rather than the placeholder) if you're sure you know what you're doing.

This parameter has no default value. Communication with the Secure Global Desktop server is only possible if you supply a valid TCP port number (or use %%ASADPORT%%).

DoLogin Boolean true

This parameter is used to determine whether the applet should start the login process.

DoLogout Boolean false

This parameter is used to determine whether the applet should start the logout process.

This parameter takes precedence over DoLogin if both parameters are simultaneously set to true.

LoginGUIMask Integer "2"

A bitmask in the range 0 to 15 which controls the appearance of the Secure Global Desktop log in dialog.

The bits are as follows:

  • Bit 1 - controls whether or not the log in dialog box displays. This is where the user enters their username and password.
  • Bit 2 - controls whether or not the ambiguous/aged password dialog box displays.
  • Bit 3 - controls whether or not the error dialog box displays.
  • Bit 4 - controls whether or not the log in dialog displays before credentials are submitted. This forces the user to click OK to log in. The values for the username and password are taken from the TarantellaUsername and TarantellaPassword parameters.

If the value of this parameter is:

  • 0 - no dialog boxes display.
  • 15 - all dialog boxes display.

Note This parameter is only active in scripting mode.

ProxyFrame String "_self"

The frame which the applet using this parameter runs in.

This parameter is used by the applet that determines the proxy configuration and should not be changed unless you know what you are doing.

ProxyServer String "DIRECT"

This parameter is used to determine which proxy server, if any, should be used. If this parameter is omitted, Secure Global Desktop will ignore any proxy server configuration and attempt to connect directly to the Secure Global Desktop server.

Use the placeholder %%PROXY%% to let Secure Global Desktop supply the correct value for this parameter.

Scripting Boolean "false"

This parameter is used with the scriptStart method to release/wake-up the applet.

If the parameter is missing or incorrect, the default of false is used.

TarantellaPassword String ""

The password the applet uses to log in to a Secure Global Desktop server.

If the value of the TarantellaUsername parameter is an empty string (""), the applet tries to log the user in anonymously (without a password).

If you are concerned about security, you may not want to use this parameter. Users can see the password you supply (by viewing the page source) and they may be authenticated to Secure Global Desktop as a different user.

Note This parameter is only active in scripting mode.

TarantellaUsername String No default

The username the applet uses to log in to a Secure Global Desktop server.

If this parameter is used, the applet tries to log the user in to Secure Global Desktop using the values for the TarantellaUsername and TarantellaPassword parameters. If the value of this parameter is an empty string (""), the applet tries to log the user in anonymously (without a password).

Note This parameter is only active in scripting mode.

TargetFrame String "WebtopFrame"

The name of the frame into which the framework applet loads other components, such as the login applet.

URLLoginFailure String ""

The URL of the page that is to be loaded into the TargetFrame if the login fails.

If this parameter is missing, the standard Secure Global Desktop login page is loaded into the TargetFrame. This loads the Secure Global Desktop Login applet.

If the value of this parameter is "", no page is loaded.

Note This parameter is only active in scripting mode.

URLLoginSuccess String ""

The URL of the page that is to be loaded into the TargetFrame if the login succeeds.

If this parameter is missing, the standard Secure Global Desktop webtop is loaded into the TargetFrame.

If the value of this parameter is "", no page is loaded.

Note This parameter is only active in scripting mode.

Using scripting mode to log a user in

When both the DoLogin and DoLogout parameters are missing or set to false, the framework applet is in "scripting mode". This means you can use the TarantellaUsername, TarantellaPassword, LoginGUIMask, URLLoginSuccess and URLLoginFailure parameters to log a user in to Secure Global Desktop.

If the TarantellaUsername parameter is missing and bit 1 of the LoginGUIMask parameter is set, the user will be prompted to log in. If the LoginGUIMask parameter is missing or bit 1 is not set, you can only log a user in using the login method.

If the TarantellaUsername parameter contains a username (any text), the applet tries to log the user in as that username and it uses the value of the TarantellaPassword parameter as the password. If the value of the TarantellaUsername parameter is an empty string (""), the applet tries to log the user in anonymously.

If the login succeeds and the URLLoginSuccess parameter is:

If the login fails and the URLLoginFailure parameter is:

Related topics