4.2 Creating an SSO Assistant Connector

An SSO assistant connector uses HTML forms to populate the authentication information. To create an SSO assistant connector, you must define the HTML form for the application.

4.2.1 SSO Assistant Connector Requirements

  • The application or web service must support HTML forms.

    For more information, see www.w3.org.

  • The connector supports user access to destination websites through web browsers running on a desktop or a laptop.

    The MobileAccess app supports the secure retrieval and replay of stored credentials for websites that users access through the landing page on supported mobile devices.

  • Determine whether the application uses different HTML forms for desktop and mobile.

4.2.2 Planning for an SSO Assistant Connector

Collect the following information before creating an SSO assistant connector:

  • Domain name of the web service or application

  • Login URL of the web service or application

  • ID or name of the form that contains user name

  • ID or name of the form that contains user password

  • Input type used for the form

  • Criterion for a successful login or a failed login

4.2.3 Creating an SSO Assistant Connector

  1. Log in to Administration Console as an administrator.

  2. In Dashboard, click Administrative Tasks > Connector Studio > + > Create SSO Assistant connector.

    The type and the type name of the connector are set when you select the type of connector to create.

  3. Under General, specify the following details:

    Target Name: Specify a unique name for the connector.

    Description: Specify the purpose of the connector.

    Version: Specify a three-digit version number for the connector.

    Icon: Browse to and select a graphic that you want as the icon for the new connector.

  4. Under Settings, create a new setting for the connector. This setting provides a way for administrators to input data while creating the connector.

    Field

    Description

    Name

    Specify a name for the setting. This name is used to reference or track the setting internally.

    Display Name

    Specify a display name for the setting. This name appears on the Applications page under Setting Name and Value while configuring an application using this connector.

    Data Owner

    Access Manager does not use this option for an SSO assistant connector.

    Type

    Select String as the data type of the value that you specify in Setting Name and Value on the Applications page while configuring an application.

    Min

    Access Manager does not use this option for an SSO assistant connector.

    Max

    Access Manager does not use this option for an SSO assistant connector.

    Description

    Specify the description of this setting. This value appears when you mouse over the help icon for this setting under Setting Name and Value in the Applications page while configuring an application.

    Default Value

    Specify a default value. This value appears by default for the corresponding Setting Name and Value in the Applications page while configuring an application.

    Required

    Ensure to select this option. After selecting, the end user must enter a value for the setting.

    Concealed

    Access Manager does not use this option for an SSO assistant connector.

  5. Define the HTML form for the appropriate application and platform under Desktop, iOS, and Android.

    You can use the same fields for all three platforms or define a unique form for each platform. HTML forms for some applications are different for desktop application and mobile application. When the HTML forms are different, you must create multiple forms for an application.

    Field

    Description

    Login URL

    Specify the login URL of the application.

    Import

    Use this option if you want to populate the values in Form ID, Input Field Definitions, and Submit ID by using Login URL that you have specified.

    When you use this option, you do not need to specify details in the other fields on this page manually.

    Input Field Definitions

    Click + to add more input fields if required. Only the String type is supported.

    Submit ID

    Specify the ID or name on the element that submits the login form.

  6. Click OK.

  7. Proceed to Section 4.8, Publishing a Connector to the Local Catalog.