3.2 Exporting and Importing Predefined Applications and Application Definitions

SecureLogin provides export and import functionality to facilitate distribution of predefined applications and application definitions. Converting predefined applications and application definitions to XML format allows you to distribute and deploy predefined applications and application definitions across directories, software, and hardware platforms.

This section contains the following information:

3.2.1 Export Using an XML File

You can manage application definitions for applications by using the iManager, the Microsoft Management Console (MMC) or the SecureLogin Manager (slmanager.exe).

To export SecureLogin data using an XML file through iManager, do the following:

  1. Log in to iManager.

  2. In the object field, specify your object name, then click OK.

    Managing SecureLogin SSO

  3. Click Distribution. The distribution details are displayed.

  4. Click Save. The save dialog box is displayed.

    Save Dialog Box

  5. In the Select Securelogin Configuration section, do the following:

    1. Select Applications.

    2. Clear the other Select Securelogin Configuration check boxes.

    3. Select Not Encrypted in the Select File Protection section.

      NOTE:This option is not present for iManager.

  6. Click Export. The Do you want to open or save dialog box is displayed.

  7. Click Save. The save dialog box is displayed.

  8. Select the file location and specify a file name in the File Name field.

  9. Make sure XML document is selected in save as type.

  10. Click Save. The SecureLogin confirmation message is displayed.

  11. Click OK.

    Confirmation Message

3.2.2 Importing in XML Format

Use the following procedure to import SecureLogin data in XML format:

  1. Log in to iManager.

  2. Select Securelogin SSO > Manage Securelogin SSO. The Manage SecureLogin SSO page is displayed.

  3. In the object field, specify your object name, then click OK.

    Manage Securelogin SSO

  4. Click Distribution. The Distribution details are displayed.

    Distribution details

  5. Click Load. The Load dialog box is displayed.

    Importing a configuration

  6. In the dialog box do the following:

    1. Select the Applications check box.

    2. Clear the other check boxes.

  7. Browse and select the exported XML file.

  8. Click OK to select the file.

    The selected:

    • Predefined applications and application definition are copied across to the receiving organizational unit or container.
    • Securelogin configuration is copied across to the receiving object.

    If a predefined applications and application definition currently exists in the receiving object, a confirmation message is displayed to confirm or reject overwrite with the imported data.

  9. Click Import to confirm or click Cancel to reject overwriting with the imported data.

  10. A SecureLogin message is displayed to confirm SecureLogin data is loaded.

    Confirmation Message

3.2.3 Modifying in the Personal Management Utility

SecureLogin predefined applications and application definitions are easily modified to cater to your organization's requirements.

Use the following procedure to modify a SecureLogin predefined application or application definition.

  1. Double-click the SecureLogin system tray icon to display the Personal Management Utility.

  2. Click Applications. The Applications pane is displayed.

    application pane

  3. Double-click the required application definition. The application details are displayed.

    application details

  4. Select the Definition tab. The Application Definition editor is displayed.

    Application Definition editor

  5. Modify the application definition or the predefined application, as required.

    NOTE:It is a good practice to include the date and a description of the changes made for future reference.

  6. Click OK to save changes and close the Personal Management Utility.

For information on how to modify specific functions see, Section 5.0, Command Reference.

3.2.4 Building an Application Definition in the Personal Management Utility

This section describes how to create and modify SecureLogin application definitions in the Personal Management Utility. It is recommended that you test the application definitions locally and then copy them to the relevant container or organizational unit in multi-user directory environments.

Use the following procedure to create an application definition for a Windows application.

  1. Double-click the SecureLogin system tray icon to display the Personal Management Utility.

  2. On the File menu, point to New, and then click Application. The New Application dialog box is displayed.

    new application dialog box

  3. Click New Application Definition, and select the required application type from the Type drop-down list.

  4. Specify the name of the application executable for Windows* applications in the EXE field.

  5. Specify a description and click OK. The application definition is added to the left pane under applications and the details display in the right pane.

  6. Select Definition, and delete the text, # place your application definition here.

  7. Specify your application details, and click OK to save the changes and close the Personal Management Utility.

    NOTE:If you are creating multiple application definitions, click Apply to save changes without closing the Personal Management Utility.

Settings Tab

The Settings tab includes the following Advanced options for application definitions and predefined applications.

Settings tab

The following table lists the options in the Settings tab:

Table 3-1 Settings Options

Option

Description

Allow web page to load while Application Definition is running (Web applications only)

Applies to Microsoft Internet Explorer and Application Definitions created for Web pages and JavaScript log on that execute in a Web page.

Set to No by default, this suspends completion of any other Internet Explorer tasks until the log on has completed.

Selecting Yes, SecureLogin allows Internet Explorer to continue functioning while SecureLogin is executing log on.

Enable third party access for this platform

This option is set to No by default, disabling API access for this Predefined application or Application definition.

Clear to disable API access for this Predefined Application or Application Definition.

Password field must exist on Internet Explorer page for Application Definition to run (Web applications only)

Applies to Microsoft Internet Explorer and Application Definitions created for Web pages and JavaScripts within Web pages.

Selecting this option ensures SecureLogin does not execute automated log on for pages without a password field.

Clear this option if your Web application returns errors on pages without password fields that you need to handle with SecureLogin. For example, password change successful.

Synchronize with Mobile Device

This option is set to No by default, enabling synchronization to an API enabled handheld device, for this Predefined application or Application Definition.

Clear to disable synchronization to an API enabled handheld device for this Predefined application or Application Definition.