3.4 Windows Application Definition Tools

Novell SecureLogin provides wizards to assist with the creation of basic application definitions. For more complex applications and requirements, Novell SecureLogin provides the following tools to assist with finding the application information required to build an application definition:

3.4.1 Finding Application Details with Window Finder

The Novell SecureLogin Window Finder finds windows applications details, including control and dialog box IDs. Novell SecureLogin might 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.

Starting the Windows Finder

The following procedure uses the Novell SecureLogin test application provided on the Novell SecureLogin product installer package or your other distribution source.

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

  2. Right-click the Novell SecureLogin icon in the dialog box, drag it 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



Module Details Section

Module Name

This is the Windows executable name for the selected application.

This is the application name for a Windows application definition or the pre-defined application.

Command Line

This is the full command line used to start the application.

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

Parent Details Section

Window Title

This is the title of the window of the selected control.

Use with the Title command in the Dialog/EndDialog section of the application definition.

Window Class

This is the Windows class name for this dialog or window.

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


This is the internal Windows handle for this window.

This is generally not used in application definitions.

Control Details Section

Dialog ID

This is the unique number identifying the control.

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

Class Name

This is the Windows class name for the control.

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

Window Text

This is the test that exists on the control.

Useful to copy and paste into the application definition editor.

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

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

3.4.2 Finding Application Details with the Login Watcher

The Login Watcher records login and Windows application data to provide information that you might 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:The Login Watcher records all log in information, including usernames and passwords, in a text file. This text file might be a security issue.

Information Details

Information Item



Milliseconds elapsed since the Login 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 login and text displayed as labels for fields and buttons.

Class name

Name of the window class.


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:

  1. Right-click the Novell SecureLogin icon on the notification area.

  2. Select close from the menu.

  3. Right-click the Windows Start menu > Explore.

  4. Double-click loginwatch.exe, by default located at <...>\program files\novell\securelogin\tools. The Login Watcher dialog box is displayed.

  5. Specify the executable filename in the Login Watcher field. For example, YPager.exe.

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

  7. Log in to the relevant application.

  8. Click Stop when logged on successfully to return to the Login Watcher dialog box.

  9. Click View Log. Novell SecureLogin starts the Notepad application and displays the watch.txt file with login details recorded.

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

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