2.7 Installing SecureLogin Browser Extensions

SecureLogin supports single sign-on for web applications using Internet Explorer, Mozilla Firefox, and Google Chrome browsers. To enable single sign-on for web applications in Mozilla Firefox and Google Chrome, you must install the Single Sign-on Assistant extension or NetIQ Securelogin SSO Extension in the respective browser.

Single Sign-on Assistant provides a secure single sign-on experience for Access Manager, CloudAccess and SecureLogin users by allowing automatic authentication for configured applications. NetIQ recommends that you use Single Sign-on Assistant instead of NetIQ SecureLogin SSO Extension.

IMPORTANT:The Single Sign-on Assistant extension is supported from SecureLogin 8.5.3 and above. You must remove the NetIQ SecureLogin SSO Extension from your browser before installing Single Sign-on Assistant extension.

Download and install the required SecureLogin browser extension for Google Chrome and Mozilla Firefox using the following information:

2.7.1 Installing Single Sign-on Assistant in Google Chrome

  1. If NetIQ SecureLogin SSO Extension is installed, perform Step 2. Otherwise, continue from Step 3.

  2. Perform the following steps in the Google Chrome browser to remove NetIQ SecureLogin SSO Extension:

    1. Click More Tools > Extensions.

    2. Locate NetIQ SecureLogin SSO Extension.

    3. Click the delete icon to remove NetIQ SecureLogin SSO Extension.

  3. In the Google Chrome browser, click More Tools > Extensions > Get more extensions.

  4. Specify Single Sign-on Assistant in the search field.

  5. Locate and click Single Sign-on Assistant in search results.

  6. Click ADD TO CHROME.

  7. Click Add extension.

  8. To perform auto update in the chrome browser, click Settings > Extensions > Update extensions now to force update the extension manually.

2.7.2 Installing Single Sign-on Assistant in Microsoft Edge (Chromium-based)

You can install the Single Sign-on Assistant extension from both Microsoft store and Chrome web store. However, you must apply the appropriate settings in SecureLogin. In the Preferences > Web page, you must ensure that Microsoft Edge settings are applied when the extension is installed from Microsoft store, and Google Chrome settings are applied when installed from the Chrome web store.

NOTE:When you install Single Sign-on Assistant in Microsoft Edge from the Chrome web store, applying the preferences of Microsoft Edge will not work. You must apply the preferences of Google Chrome.

Perform the following steps to install Single Sign-on Assistant:

  1. In Microsoft Edge, click Extensions > Get extensions for Microsoft Edge.

  2. Specify Single Sign-on Assistant in the Search field.

  3. Locate and click Single Sign-on Assistant in the search results.

  4. Click Get > Add extension to start installation.

  5. Restart Edge.

2.7.3 Installing Single Sign-on Assistant in Microsoft Edge (HTML-based)

  1. In Microsoft Edge, click Settings and more > Extensions > Explore more extensions.

  2. Specify Single Sign-on Assistant in the Search field.

  3. Locate and click Single Sign-on Assistant in the search results.

  4. Click Get to start installation.

  5. When the installation is complete, click Launch to switch back to Edge.

  6. Read the notification about what the extension is allowed to do, and select Turn it on.

  7. Restart Edge.

2.7.4 Installing Single Sign-on Assistant in Mozilla Firefox

NOTE:Single Sign-on Assistant is supported in Mozilla Firefox version 50 and above.

  1. If NetIQ SecureLogin SSO Extension is installed, perform Step 2. Otherwise, continue from Step 3.

  2. Perform the following steps in the Mozilla Firefox browser to remove NetIQ SecureLogin SSO Extension:

    1. Click Add-ons > Extensions.

    2. Locate NetIQ SecureLogin SSO Extension.

    3. Click Remove to remove NetIQ SecureLogin SSO Extension.

  3. In the Mozilla Firefox browser, click Add-ons > Extensions.

  4. Specify Single Sign-on Assistant in the Search all add-ons field.

  5. Locate Single Sign-on Assistant in the search results and click Install.

  6. Click Accept and Install... in the End-User License Agreement window.

  7. Click Add when the Mozilla Firefox browser prompts to add Single Sign-on Assistant extension.

  8. Click OK.

For accessing applications that are local to your system, after installing the extension select Allow access to file URLs under the Single sign-on Assistant. This allows SecureLogin to login and fill the form for local files such as file:///C:/dev/test.html.

2.7.5 Installing NetIQ SecureLogin Extension in Google Chrome

  1. In the Google Chrome browser, click Settings > Extensions > Get more extensions.

  2. Specify NetIQ Securelogin SSO Extension in the search field.

  3. Click NetIQ Securelogin SSO Extension and follow the on-screen prompts.

If you already have an older version of NetIQ Securelogin SSO Extension installed, it is recommended to install the Single Sign-on Assistant plug-in.

2.7.6 Installing NetIQ SecureLogin Extension in Mozilla Firefox

NOTE:NetIQ SecureLogin SSO Extension is supported only in Mozilla Firefox version 50 and above.

  1. Download NetIQ Securelogin SSO Extension for Mozilla Firefox from the NetIQ Product download site.

    1. In the product download site, select the product as SecureLogin and the version as SecureLogin 8.5, then click Submit Query.

    2. From the search result click NetIQ SecureLogin 8.5.

    3. In the NetIQ SecureLogin 8.5 page, click proceed to download and follow the on-screen prompts to download the extension.

  2. In the Mozilla Firefox browser, click Add-ons > Extensions.

  3. Drag and drop the downloaded NetIQ Securelogin SSO Extension to the Extensions page of Mozilla Firefox.

    NOTE:If you download the extension using Google Chrome, the extension is downloaded as a .zip file. You must drag and drop the complete zip file to install the extension in Mozilla Firefox.

  4. Click Install in the pop-up dialog box.

For accessing applications that are local to your system, after installing the extension select Allow access to file URLs under the NetIQ SecureLogin SSO Extension. This allows SecureLogin to login and fill the form for local files such as file:///C:/dev/test.html.

2.7.7 Configuring HTML Basic Authentication for SecureLogin Using Single Sign-on Assistant

IMPORTANT:HTML Basic Authentication does not process the message box command of SecureLogin in Mozilla Firefox. The message box command is processed only when the user interacts with the HTML page.

SecureLogin supports HTML Basic Authentication when using Single Sign-on Assistant 3.3 with Google Chrome and Mozilla Firefox. It provides authentication in the following three scenarios.

Default: This scenario does not require a single sign-on script. It creates the credential set for the respective authentication prompts and saves the credentials for the subsequent single sign-on operations to provide seamless sign-on. It uses the following format for the credential set.

Domain "Realm"

Using the Single Sign-on Scripts: Perform the following steps to write your own single sign-on script or application definitions to enable HTML Basic Authentication.

  1. Right click on the SecureLogin system tray icon and click Manage.

  2. In SecureLogin, right click on Applications and click New.

  3. In New Application, select New Application Definition.

  4. In Type, select Generic.

  5. In Name, specify CredentialSelection.

  6. Click OK.

  7. Navigate to Applications > Generic > CredentialSelection.

  8. Specify your application definitions in Definition. The following is a sample application definition.

    if "abc.xyz.123.com" -in ?domain
    
    debugprint "Setting credential to domain credentials"
    Set ?Credential apptest-correct
    
    else
    Set ?Credential apptest-wrong
    endif

NOTE:If there are multiple HTML Basic Authentication requests, you can use the same CredentialSelection type with a custom definition for each URL.

Using the System Credentials: Seamless sign-on to authentication prompts is achieved when user logs into Windows. The following is a sample application definition.

if "abc.xyz.123.com" -in ?domain

set ?Credential "-SYSCREDENTIAL"

endif