Enabling Applications for Single Sign-On

If a pop-up prompt doesn't appear when you launch a new application, use the Add Application Wizard to enable the application for single sign-on. The Wizard creates a script that captures your login credentials. The next time that you launch the application, SecureLogin uses the script to automatically log you in.


Enabling Applications That Have Prebuilt Scripts

Scripts store certain login information so that it can be used again and again. To save you the time and trouble of setting up scripts, SecureLogin provides prebuilt scripts for many applications.

To enable an application that has a prebuilt script:

  1. Right-click the SecureLogin icon on the task bar, then click Add Applications.

  2. In the Welcome window, click Next.

  3. Click Prebuilt Scripts, then click Next.


    The option to use a prebuilt script

  4. Select the application from the list, then click Finish.


    Applications that have prebuilt scripts

  5. Provide a login (user ID).

    As the following figure illustrates, when you next launch the application, SecureLogin prompts you to enter login variables.


    Fields to enter login variables

    After you type the variables (typically, Username and Password) and click OK, SecureLogin saves this data and logs you in. This data is a user ID. For subsequent launches, SecureLogin uses this user ID to automatically log you in.


Enabling Applications That Don't Have Prebuilt Scripts

This section provides information on the following:


Enabling a Windows Application

The following steps apply when SecureLogin doesn't automatically detect a new application. If SecureLogin detects a new application and launches the Add Application Wizard, go to Step 6. For information on SecureLogin's pop-up prompt, see Responding to Pop-Up Prompts.

  1. Launch the application and drag the login panel to one side of the screen.

  2. Type login information (for example, username and password), but don't click OK, Next, or Finish.


    An example login dialog box

    The login panel needs to remain so that SecureLogin can capture the information on the panel.

  3. Right-click the SecureLogin icon on the task bar, then click Add Applications.

  4. Click Next > Windows Application > Next.


    The option to create a login script for a Windows application

  5. Drag the hand icon from the Set Up a Windows Application dialog box to the title bar of the login window.


    The hand icon in the Add Application Wizard

  6. In the Select Window Function window, select Login Window from the drop-down list, then click Next.


    Selecting the window function

  7. Select the login fields.


    Selecting login fields

    1. Drag the hand icons and drop them onto the corresponding Username, Password, and (if appropriate) Other fields in the login window.

    2. Drag the hand icon for the OK button and drop it onto the OK, Next, Continue, or similar button.

    3. Click Next.

  8. In the Confirm Details dialog box, verify that your username is correct and that a password exists, then click Next.

  9. In the Name the Script window, accept the default name (or select a name from the drop-down list or type a new name) for the application, then click Finish.


Enabling a Web Application

  1. From a browser, go to the URL of the Web page that you want to log in to.

  2. Right-click the SecureLogin icon on the task bar, then click Add Applications.

  3. Click Next > Web Page > Next.


    The option to create a script for a Web application

  4. In the Set Up a Web Page dialog box, copy and paste the URL, type your username and password, then click Finish.


    Setting up a Web page


Enabling a Java Application

If Java applications are coded in AWT or SWING, SecureLogin can enable those applications for single sign-on.

A script requires control numbers (hidden numbers that differentiate a Username edit box from a Password edit box). Determining the correct control numbers in a Java application might require trial and error. Therefore, we recommend that the network administrator configure Java applications centrally, test the applications, and then distribute them.


Prerequisites


Enabling the Add Applications Wizard for Java

When the JRE is installed, the SecureLogin installation program installs Java support by default. However, when SecureLogin first launches, the Add Application Wizard for Java is disabled. To use Java applications, you must enable the Add Applications Wizard for Java.

  1. Right-click the SecureLogin icon on the task bar, select Manage Logins, then click Settings.


    The Settings tab

  2. Select Add Application Prompts for Java Applications, then click Edit.

  3. Change the value to Yes, then click OK.


    The Edit Settings dialog box

  4. Set the Allow Single Sign-on to Java Applications value to Yes.

  5. Save the data by clicking OK.


Adding the Java Application to the List of Applications

  1. Launch the Java application.

    The Java application can be an applet or an executable file. The application displays a login dialog box.


    A login dialog box from a Java application

    SecureLogin displays the following message:


    The Java single sign-on prompt

  2. Click Yes.

    SecureLogin extracts and stores the Java control information for login to the application or server.

  3. Double-click the SecureLogin icon on the task bar, then select Applications.


    The Applications page

    SecureLogin displays a new icon (Java) and application type (in this example, http://javaboutique).

  4. Select the Java application, click Edit, then click Script.


    The Script page and sample script

    The Description field displays the application's address. The Script tab displays the Java control information that SecureLogin extracted from the Java login. The following table describes part of the example script:

    Text in the Script Description

    #control 1:

    The Username field

    #control 2:

    The Password field

    #control 3:

    The Login button

  5. Modify the script by typing the commands and control numbers that enable SecureLogin to automatically log you in to the application.


    A modified script

    Determining the control numbers might require trial and error.

  6. Save the single-sign-on information by clicking OK twice.

  7. Test the Java application by launching it and logging in.