Product Documentation

Web Type Application Definitions

May 09, 2015

Web type application definitions are used to identify Web-based applications, including Java applets.

Typically, any application that runs in a browser is categorized as a Web application for the purposes of defining an application definition. Single Sign-on supports Web applications running on Internet Explorer Versions 6.0, 7.0, 8.0 and 9.0.

Web application definitions are created, in part, by identifying parts of the Web application as it runs. To gather the information required for Web application definitions, launch the application and navigate to the form that requires a user credential management event (user logon, change password, successful password change, or failed password change) while running the Form Definition Wizard from the console or from the Application Definition Tool. The wizard’s on-screen text provides instructions for locating and identifying the applicable parts of the application.

Name Form

When creating application definitions for Web type applications, the Name form page of the Form Definition Wizard is used to:

  • Assign a user-defined name to the form being created
  • Identify the type of form being created
  • Identify any special actions

Consider that the name assigned to the form appears on the Manage forms page of the Application Definition Wizard. Assign a name that is meaningful to the type of form being defined.

Several types of standard user credential processing forms can be defined using the Form Definition Wizard including:

  • Logon form

    Used to identify the logon interface to an application, and to manage the user credential actions required to gain access to the associated application.

  • Password change form

    Used to identify the password change interface to an application, and to manage the user credential actions required to change the user password to the associated application.

  • Successful password change form

    Used to identify the password change interface to an application, and to manage the user credential actions required to acknowledge the successful change to a password for the associated application.

  • Failed password change form

    Used to identify the unsuccessful password change interface to an application, and to define the actions to take when a credential change operation is unsuccessful.

Password Manager Agent Versions 4.0 and 4.1 do not support successful or failed change credentials forms and do not respond to application definitions containing these forms.

Use the Special actions area to identify any special form treatments for the form being defined:

  • No special action

    Select this option for normal Web form processing.

  • Redirect to Windows application

    Select this option when no form is recognized for the web application in the Web Form Wizard. This occurs when the Web application uses ActiveX controls, Flash-based controls, some types of Ajax controls, or other non-HTML based controls used to manage user credential management events.

  • Ignore this form when it is detected by the plug-in software

    Select this option to have the plug-in software ignore the form.

Identify Form

When creating application definitions for Web type applications, the Identify form page is used to provide the information required to have the Single Sign-on Plug-in software uniquely recognize the form being defined.

Web applications are identified using the URL address associated with the user credential management form being defined.

Click Select to open the Web page selector. Use the Web page selector to identify the Web page you want to associate with the form.

After completing the Web page selector, you are returned to this page. Two check boxes are available to manage how to interpret identified URLs:

  • Strict URL matching

    Select this check box to recognize only user credential management events from Web applications that are started using the specified URL(s). Some URLs may contain dynamic data such as session management identifiers, application parameters, or other identifiers that can change for each instance. In these circumstances, using strict matching results in the URL not being recognized.

  • Case-sensitive URL

    Select this check box to use exact case matching URL(s).

Define Form Actions

The Define form actions page is used to define the actions that must be performed by the Single Sign-on Plug-in to submit the credentials for the specific form being defined.

The top of the page displays the selection of user credentials associated with the specific form:

  Logon Form Password Change Form Successful Password Change Form Failed Password Change Form
Username/ID X X X X
Password X   X X
Old Password   X    
New Password   X    
Confirm Password   X    
Custom Field 1 X   X X
Custom Field 2 X   X X
OK X X X X

The bottom of the page displays the defined action sequence.

The objective of this page is to define the actions to be taken by the plug-in software to successfully submit the required user credentials to the identified form.

For many Web applications, the following process is all that is required:

  1. Click the Set/Change hyperlink associated with a specific user credential. This action opens the Configure Field Text dialog box used to identify the field to receive the selected credential. If the form is already open, this dialog box displays all the possible candidates for the field type associated with the selected user credential or submit option.

    If the application credential form is not currently open, start the application and navigate to the correct user credential form. Then select the Refresh . After the application form is selected, this dialog box is populated with field type candidates that are appropriate for the selected user credential.

  2. Select the field type candidate to receive the credential. As the different candidates are selected, the associated field type is visibly highlighted on the application to make it easier to identify the field type that is to receive the identified user credential or submit button.
  3. Repeat this action for all the user credentials required by the form and for the button required to submit the form.

    Some forms require domains or other user-configurable credentials that must be successfully submitted to process the form. To accommodate these requirements, two custom fields are made available. Assign special-requirement credentials to these fields. The names associated with these fields are defined on the Name custom fields page of the Application Definition Wizard after the form is defined.

    Note: Not all the credentials identified in the top of the Define form actions page must be configured.

For many Web applications, after you define which fields on the form are to receive the identified user credential and which button to select to submit the form, you have completed the form action definition process and you can continue with the next page in the wizard.

However some forms require more information, steps, special keys, or other actions to complete a credential management task successfully. For these forms, click Action Editor to open the Action Editor dialog box.

Defining Action Sequences for Web Forms Using the Action Editor

Use the Define form actions page to define actions that must be performed by the plug-in software to submit the credentials for the specific user credential management form being defined.

For many Web applications, the basic information gathered in the Form Definition Wizard is enough to define the form. However some forms require more information, steps, special keys, or other actions to successfully complete a user credential management task. For these forms, on the Define form actions page, click Action Editor to open the Action Editor dialog box.

The Action Editor for Web dialog box consists of:

  • Select Actions

    Displays all possible action-sequence actions:

  • Configure Actions

    Used to define the action-specific options to include in the action sequence.

  • Sequence Actions

    Displays the sequence of defined actions to perform to process the specific user credential management form.

Configure Other Settings

For Web definitions, the Configure other settings page is used to specify if the Web page’s submit button is pressed automatically by the plug-in software or if the user is required to manually press the button.

Select Submit this form automatically to submit the form without user intervention.