Skip to main content
Version: Early Access

Agility Connect Single Sign On Configuration

This article provides instuctions for configuring SSO with Agility Connect.

Overview​

Agility Connect 19.1 and later versions support integration with SAML compliant external user authentication tools such as Okta, Centrify,OneLogin, and Ping Identity.

SAML is an XML-based open standard developed by OASIS Security Services Technical Committee. It defines a framework to perform web browser SSO using secure tokens for exchanging security information between web applications. For more information about SAML, its concepts and components, see https://www.oasis-open.org/.

Setup SAML Authentication for Agility Connect Users​

Setting up Agility Connect to use SAML compliant external authentication is a two-step process:

  • Set upAgility Connect as a Service Provider (SP) with the SAML compliant IdP such as Okta,Centrify, OneLogin or Ping Identity.
  • Enable SSO in Agility Connect and configureAgility Connect to use the SAML compliant IDP for authentication.

Of these two steps, setting up Agility Connect as a Service Provider with the IDP is out of scope of this topic. However, this topic includes instructions on how to get the Agility Connectmetadata that's required to configure Agility Connect as a Service Provider with the IdP.

Get the Agility Connect Metadata​

  1. Once you have Agility Connect installed, log on to Agility Connect
  2. Click the Administration icon () at the top right and select System > Settings from the menu.
  3. Select the SSO tab.
  4. Click Get Metadata.

SSO Tab

  1. Save the XML file for later use when you register Agility Connect as a Service Provider with the SAML IdP.

CTM SSO

Enable and Configure SSO in Agility Connect​

  1. With the Agility Connect metadata at hand, make sure you have configured Agility Connect as a Service Provider with the SAML IdP.
  2. Log on to Agility Connect as an Administrator.
  3. Click the Administration icon () at the top right and selectSystem > Settingsfrom the menu.
  4. Select the SSO tab.

SSO Tab

  1. If you have the IdP metadata XML file, you can import the same by clicking Import IdPXML.Otherwise, you can fill in the fields manually.

Import IDP

Click Upload, browse and select the IdP XML file to import the IdP's metadata.

You can also copy and paste the configuration XML codein the text box.

When done, click Validate and Save.

  1. If you do not have the IdPconfiguration XML file, enter the details for the fields such as the IdPEntity ID, IdP SSO URL, and IdP X509 Certificate.The Service Provider Entity Id,Assertion Consumer Service URL (HTTP-POST) andName ID format fields are auto-filled.
  1. Click Enable SSO.
  2. Click Test Connectionand make sure the connection is successful.
  3. Click Save.

This concludes the SSO configuration.

From this point, clicking Sign-in from the Agility Connect log-on page takes the users to the organization's SSO page.

Configure the IdP's Directory Service Field to Supply the Username​

Agility Connect uses email ID as the key to identifying user accounts. As a result, user authentication may fail if your IdP does not include the email ID in its SAML response. In such cases, you must make sure that your IdP's response includes the email ID (by mapping the Directory Service Field appropriately).

For example, you must map "mail" as the Directory Service Field to supply the username in Idaptive's Centrify.

IDP mail

Disable SSO​

To disable SSO:

  1. Click the Administration icon () at the top right and click System > Settingsfrom the menu.
  2. Select the SSO tab.

SSO Tab

3. Click Disable SSO.

A confirmation message appears.

Diable SSO

4. Click Continue.

If you are not able to log onto Agility Connect after enabling SSO, log on via a shell to the Agility Connect server and run the following command to disable SSO.

$CONTINUUM_HOME/common/disable_sso.py