3.4 Windows Application Definition Tools

SecureLogin provides wizards to assist with the creation of basic application definitions. 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.4.1 Finding Application Details with Window Finder

The SecureLogin Window Finder finds windows applications details, including control and dialog box IDs. 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 SecureLogin test application provided on the SecureLogin product installer package or your other distribution source.

On the Windows Start menu, select All Programs > NetIQ Securelogin > Window Finder. The Window Finder is displayed.
Right-click the SecureLogin icon and drag it to the required window, field or control.

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	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.
Handle	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. 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. Note the required details from the WinSSO Window Finder window from the relevant fields. Click Close.

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	Description
Time	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.
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

Right-click the SecureLogin icon on the notification area.
Select close from the menu.
Right-click the Windows Start menu > Explore.
Double-click loginwatch.exe (\program files\netiq\securelogin\tools).
Specify the executable filename in the Login Watcher field. For example, YPager.exe.
Click Start.
Log in to the relevant application.
Click Stop when logged on successfully to return to the Login Watcher dialog box.
Click View Log. SecureLogin starts the Notepad application and displays the watch.txt file with login details recorded.
Note the required information or save the text file with a different name.
Click the Login Watcher dialog box. Click Close.