4.2 Novell SecureLogin Supported Variables

Novell SecureLogin reads details from the system and uses them to create variables that you can incorporate into the application definition. These variables are automatically generated as runtime variables and used in the same manner within any application definition.

Variable

Description

?BrowserType(system)

Contains Internet Explorer and indicates the browser on which the application definition is running.

This variable is only set in a Web application definition.

?CurrTime(system)

Contains the running time in seconds from Jan 1970 to the present. Use this variable to force password changes every X days, or similar.

Do not use the application definition to force a password change if you want to continue the application generating the change password event. This is recommended.

Use this variable on applications where you cannot set a password expiry at the application back end.

?DSVariable(system)

SecureLogin traps the DataStoreVariableNotAvailable exception and stores the name of the variable, which resulted the exception, in a built-in variable called ?DSVariable. This helps in tracing errors that occurs while trying to read a directory attribute.

?SysContext(system)

Contains the context within which the current Novell SecureLogin user's directory object exists.

?SysPassword(system)

Contains the directory password of the user currently using Novell SecureLogin.

This variable is only available if the appropriate options are chosen when installing Novell SecureLogin.

?SysServer(system)

Contains the name of the server or the IP address of the server that was entered in the Novell client login panel.

NOTE:This variable is only available if the Novell client login extension is installed (eDirectory) and is not available if the MS Active Directory or ADAM option has been installed.

?SysTree(system)

The name of the directory tree that the Novell SecureLogin is currently using.

NOTE:The variable ?SysTree will return the Domain name when using Microsoft GINA (Microsoft Active Directory or ADAM) and the Tree name or Port Number when using Novell GINA or LDAP installation.

?SysTSLaunched (system)

Contains the condition state value when SLLauncher is run.

This variable is set to "True" when a script is being executed by SLLauncher. Otherwise it will be "<NOTSET>".

?SysUser(system)

The name of the user currently using Novell SecureLogin.

?SysVersion(system)

The local Novell SecureLogin windows agent version.

You can use this variable to determine if specific support is built into the product running on the user's workstation. Version convention is two digits for each section, read from right to left, and leading zeroes are removed. For example, version 3.0.4.0 would be returned as 03000400.

4.2.1 Variables that enable single sign-on in Firefox

Novell SecureLogin can select a specific credential set to single sign Firefox authentication dialog boxes by adding a Generic application definition called “Firefox–CredentialSelection”.

IMPORTANT:The application definition of firefox.exe must already exist for adding a generic application definition.

The application definition allows the administrator to define which credentials to use to single sign-on to the Firefox authentication dialog box of any realm or domain. The application definition contains variables with values that are supplied from the SecureLogin SLoMoz Firefox plug-in.

Variable

Description

?FFCredential

The name of the credential set that the SecureLogin SLoMoz Firefox plug-in will use to populate the authentication dialog. By default, the variable will store the equivalent of [?FFRealm "?FFDomain"].

To allow using ?SysUser and ?SysPassword in a login, set the FFCredential to be -SysCredential. For example,

set ?FFCredential -SysCredential

?FFDialogText

The text of the Firefox authentication dialog box.

?FFDomain

The domain that is prompting for authentication.

?FFMustSaveCredential

The variable that controls whether SecureLogin requires users saving credentials for a specific realm or domain.

?FFRealm

The realm that is prompting for authentication.