Configuring First-Time Use

A first-time use script is used the first time a user uses v-GO. Normally, the user sees just a few pages, which display some settings. Subsequently, when a recognized application is run, v-GO requests logon credentials from the user (username and password). Information is collected from the user at different times for each application, depending on when the application is run.

Just after v-GO is installed, you can configure v-GO to prompt users for these credentials to the corresponding applications. When users access recognized applications thereafter, v-GO does not prompt the user for logon credentials.

The First Time Use Wizard enables users to pre-populate their usernames and passwords for configured applications. Users can then enter their secrets once, at initial installation, and rely on Single Sign-on to enter them from then on.

After you install the v-GO client, the First Time Use Wizard asks the users to pre-populate their SecretStore with current application IDs and passwords. NSSO provides a variety of configuration settings to customize this process and meet the specific needs of your organization. Any step can be eliminated, except picking a password.

In addition, users can be prompted to configure logons for their existing logons. Combining first-time use configuration with the pre-defined logons from within ConsoleOne ensures that users have single sign-on immediately after installation.

Users can configure their individual logons as they encounter each application. Configuration settings for the First Time Use Wizard are specified in the FTULIST.INI.

The FTULIST.INI file is in the directory where you installed v-GO for Novell Single Sign-on. Typically, the directory is C:\NOVELL\SSO\PASSLOGIX.

You can use ZENWorks to create and distribute the FTULIST.INI files. However, if you define the first-time use script, v-GO reads the information from the directory.


Specifying the Steps in the First Time Use Wizard

The first section of the FTULIST.INI file specifies the steps that are to be included in the first-time use process. The following table explains syntax used to define the first-time use process:

Entry Description

[FTU]

A reserved section for enumerating processes to include in first-time use.

Ver=20010322

A version number (required). The version number must match the v-GO client's build date. To find this date, right-click the Single Sign-on icon on the system tray > select About Single Sign-on. For example, if the v-GO build date is 2001.03.22, enter 20010322.

Step1=

My Logons

Omitting an entry in this section instructs v-GO to omit the associated step from the First-Time Use Wizard. Always use My Logons for Step 1. Don't eliminate Step 1.


Setting Up Existing Logons

NSSO enables users to set up existing logons for specific applications during first time use so that single sign-on works the first time users encounter these applications.

If a logon is not set up using the First Time Use Wizard, users will be prompted to set it up when they first encounter the logon request. You can choose which logons users must set up during first time use, so that users gain the maximum benefit of single sign-on.

For example, you can require users to set up frequently used applications right away, but allow users to set up infrequently used applications when users encounter them.

You can include the following in first-use logons:

You must declare (in the FTULIST.INI file) each logon that is to be included in the First Time Use Wizard. Use the following syntax:

Entry Description

[My Logons]

A reserved section for enumerating first time use logons

ExtensionName=

AccessManager; NSSO component (required)

Section1=~

The name of the first application to include in first time use

Section1=~

The name of the Nth application to include in first time use

After a logon has been declared, the following syntax is required to configure it:

Entry Description

[~Application Name]

An application name as specified in the [My Logons] section

ConfigName=

A name used to identify this application's logon in First Time Use Wizard

ConfigKey=

A section name used to identify this logon in the ENTLIST.INI or APPLIST.INI file

FTU_NeedID=

A flag indicating if the First Time Use Wizard will set up a user ID

FTU_NeedPwd=

A flag indicating if the First Time Use Wizard will set up a password

URL=

A Web URL (optional if not a Web page) or pointer to a pre-defined application section within the ENTLIST.INI or APPLIST.INI file

Description=

The application label that is presented in the Logon Manager dialog box


Example: First Time Use

[FTU]
Ver=20000410
Step1=My Logons

[My Logons]
ExtensionName=AccessManager
Section1=~Lotus Notes
Section2=~Intranet

[~Lotus Notes]
ConfigName=Lotus Notes
ConfigKey=Lotus Notes
FTU_NeedID=1
FTU_NeedPwd=1

[~Intranet]
ConfigName=Intranet
FTU_NeedID=1
FTU_NeedPwd=1
URL=intranet.passlogix.com

For more information concerning values and variables, see Values and Variables for FTULIST.INI.



Previous | Next