3.7 Creating a Basic SSO Connector Template

A connector for Basic single sign-on uses HTML Forms to populate the authentication information. To create a custom connector for Basic SSO, you must define the HTML form for the desired application.

3.7.1 Basic SSO Requirements

Gather the following information to create your custom connector for Basic SSO:

  • The application or web service must support HTML Forms.

    For more information, see www.w3.org.

  • The connector supports user access to destination websites only through a Chrome web browser running on a desktop or laptop computer. It does not support access from mobile devices.

  • The NetIQ Basic SSO extension is compatible only with the Chrome web browser. A user must install the extension in the Chrome browser one time on each desktop or laptop they use to access the Basic SSO websites. The extension is available for free from the Google Play Store.

3.7.2 Planning for Basic SSO

Before you attempt to create the connector, you must collect information about the format of the HTML form on the login page of the web service or application. For example:

  • What is the domain URL for the web service or application?

  • What is the login page for the web service or application?

  • What is the form ID or name for the user name?

  • What is the form ID or name for the user password?

  • What input type is used for the form (button, image, string)?

  • What is the criteria for a successful login or a failed login?

NOTE:You can use a worksheet to organize the information. See Worksheet for Basic SSO Custom Connectors.

3.7.3 Creating a Basic SSO Connector Template for a Web Service

A Basic SSO connector template consists of multiple components. CloudAccess contains an interface that allows you to create the components in one place.

To create a connector template for Basic SSO:

  1. Log in as an administrator to the Access Connector Toolkit.

  2. Click New > Basic SSO.

    The connector Type is Basic SSO. The Type Name is Generic Basic SSO Connector.

  3. On the Template tab, complete the template properties:

    • The unique name for the template file (target name)

    • A brief description used as the connector name

    • A 3-digit version number (ex: 1.0.0)

    • A custom graphic to use for the icon that represents the connector on the Admin page.

  4. Under Target Domain, click New, then define the domain for the desired application for Basic SSO authentications.

    Domain: Specify the URL of the application for Basic SSO authentications.

    Path ID: Specify the ID of the path for the desired action. For example login or success.

    Path: Specify the URL for each ID. For example the login URL, or the success URL.

  5. On the Form tab, create the form for the Basic SSO connector.

    The Form tab allows you define the HTML form for the desired application. The toolkit lists the HTML form fields that are required to populate the form correctly. Use the information from w3.org to create the form.

  6. Click Save to save the new connector template.

  7. Proceed to Section 3.9, Exporting a Connector Template to finish creating the new connector.