3.3 Windows Application Definition Tools

SecureLogin provides wizards to assist with the creation of basic application definitions (refer to the SecureLogin administration guide for wizards instructions). For more complex applications and requirements, SecureLogin provides the following tools to assist with finding the application information required to build an application definition:

3.3.1 Finding Application Details With Window Finder

Window Finder finds windows applications details including control and dialog IDs. SecureLogin may require this information to identify specific objects in order to uniquely identify the application.

Control IDs are used to uniquely identify objects within a window. Window Finder extracts this information from the application for use in the application definition.

Start SecureLogin’s Window Finder

The following procedure uses the Novell SecureLogin test application provided on the SecureLogin distribution CD.

  1. On the Windows start menu, select All Programs > Novell Securelogin > Window Finder. The WinSSO Window Finder is displayed.

    Window Finder

  2. Right-click the securelogin icon Window Finder in the dialog box, drag to the required window, field or control, and release the mouse button.

WINSSO Window Finder Details

The following table lists the fields in the WinSSO Window Finder:

Table 3-2 Window finder details

Field

Description

Module Details section

Module Name

Windows executable name for the selected application.

This is the application name for a Windows Application Definition/Pre-defined Application.

Command Line

The full command line used to start the application.

You can use this information in conjunction with GetCommand-Line command.

Parent Details section

Window Title

Title of the window of the selected control.

Use with the Title command in the Dialog/EndDialog section of the Application Definition.

Window Class

Windows class name for this dialog or window.

Use with the Class command in a Dialog or EndDialog section.

Handle

The internal Windows handle for this window.

Generally not used in Application Definitions.

Control Details section

Dialog ID

The unique number identifying the control.

Use with various commands including Type, SetPlat, and Click.

Class Name

Windows class name for the control.

SecureLogin supported classes, which include Edit, Combo box, and Static.

Window Text

Test that exists on the control.

Useful to copy and paste into the Application Definition editor.

Note or copy the required details from the WinSSO Window Finder window from the relevant fields.

Click Close to quit and close the WinSSO Window Finder window.

3.3.2 Finding Application Details with the Login Watcher

Login Watcher records log on and Windows application data to provide information that you may need for creating an application definition.

Order Information is Recorded and Stored

Information is recorded and stored in a text file in the following order:

Time||Module Name||Window Handle||Window Text||Class Name||Parent||Visible Flag||Title Flag||Control ID

NOTE:Login watcher records all log on information, including usernames and passwords, in a text file. This text file may be a security issue.

Information Details

Information Item

Description

Time

Milliseconds elapsed since logon Watcher started.

Module name

Name of the executable being recorded.

Window handle

Unique identifier for the window.

Window text

All text displayed in the window, which includes text entered dur-ing log on and text displayed as labels for fields and buttons.

Class name

Name of the window class.

Parent

Window handle of the parent window.

Visible flag

Refers to top level windows that have the style set to Visible.

If set to Visible, the word Visible displays, otherwise the field is empty.

Title flag

Refers to top level windows that have the style set to display the Window Title.

If the title is not displayed, then the field is empty.

Control ID

The unique numerical identifier for the windows object.

SecureLogin Test Application Example

The following procedure uses the SecureLogin test application:

Starting Login Watcher

  1. Right-click the SecureLogin task bar icon.

  2. Select close from the menu.

  3. Double-click loginwatch.exe, by default located at <...>\program files\novell\securelogin\tools. the logon watcher dialog box is displayed.

    Login Watcher

  4. Specify the executable filename in the Login Watcher field.

  5. Click Start. The Now Recording Log confirmation dialog box appears.

    Confirmation dialog box

  6. Log on to the relevant application.

  7. Click Stop when logged on successfully to return to the login watcher dialog box.

  8. click View Log. SecureLogin starts the Notepad application and displays the watch.txt file with log on details recorded.

  9. Note the required information or save the text file with a different name.

  10. Click the Login Watcher dialog box. Click Close.