Using SSOCircle as the SAML Identity Provider

You can use SSOCircle as the public SAML IdP with a tested Cloudpath configuration.

SSOCircle provides a ready-to-use Identity Provider that uses several strong 2-factor authentication methods.

Basic Tasks for Using SSOCircle

Configure SAML using SSOCircle as the IdP by performing the following tasks sequentially:

  1. Adding a SAML Step To Your Workflow
  2. Adding the SSOCircle SAML Authentication Server to the Workflow
  3. Downloading the SAML Metadata for SSOCircle
  4. Configuring Your Account on SSOCircle
  5. Publishing the Workflow for SAML SSOCircle
  6. Testing the User Experience for SAML SSOCircle

Adding a SAML Step To Your Workflow

A SAML authentication server may be added to the workflow in place of a traditional Active Directory or LDAP server for authenticating users.

Determine in which branch and in which step to add a SAML authentication server plug-in to the workflow. For example, in the default workflow, you might create a split for Guests and Employees, and you could then use a SAML authentication server instead of the Active Directory authentication server, as shown below.

  1. Log in to the Cloudpath user interface.
  2. Go to Configuration > Workflows.
  3. Click on a workflow (or create a new one) for which you want to configure SAML as the authentication server.
  4. Highlight the tab in the workflow where you want to add the SAML authentication-server step. In this example below, it is the Employees tab.

    Adding a SAML Step To Your Workflow

  5. With the Employees branch of the workflow highlighted, click the blue arrow to insert a step below the Guests/Employees split.

Adding the SSOCircle SAML Authentication Server to the Workflow

  1. Once you click the arrow to insert the SAML step, you receive the following prompt:
    "Which Type Of Step Should Be Added?"
  2. Select the button to authenticate to a traditional authentication server, as shown in the following screen:

    Authenticate to a Traditional Authentication Server

  3. Click Next.
  4. If you have already defined an authentication server, you will get a prompt asking whether you want to reuse an existing authentication server or define a new authentication server. Choose the radio button to define a new authentication server, then click Next.
  5. On the Authentication Server Configuration screen, select the Connect to SAML radio button:

    Authentication Sever Configuration Screen

  6. Complete the configuration as shown in the example below:
    Note: You can click the "i" icons next to the field names to obtain the information required for each field.

    SAML Configuration Fields for SSOCircle

    • Required SAML Configuration section:
      • IdP Metadata Type: Use the URL option.
      • IdP Metadata URL: Enter the URL of: https://idp.ssocircle.com
      • IdP EntityID: Enter the URL of: https://idp.ssocircle.com
      • SP EntityID: Enter the string urn:testsaml:cloudpath:followed by your first name. For example: urn:testsaml:cloudpath:Jeff
    • SAML Attribute to Enrollment Mappings - Required fields:
      • Username Attribute: Must be EmailAddress
      • Email Attribute: Must be EmailAddress
      • First Name Attribute: Must be FirstName
      • Last Name Attribute: Must be LastName
      Note: You can use defaults for the remaining fields.
    • SAML Options (not shown in the screen shot above): Use all default settings.
  7. Click Next.
    The Server Certificate Information screen appears:

    Pin or Upload the Current Server Certificate

  8. You can leave the Pin the Current Server Certificate radio button selected, or you can select the other radio button and upload the CA certificate for the SAML server (if you have that certificate). Whichever method you choose, click Next when you are done.
    You are returned to the workflow screen, as shown in the example below:

    Workflow After SAML Has Been Configured as Authentication Server

Downloading the SAML Metadata for SSOCircle

  1. In the workflow, click the arrow (circled in red in the figure below) to download the SAML metadata:

    Download Icon in Workflow for SAML Metadata

  2. You will need to copy the contents to a clipboard in upcoming steps. For now, you can open the metadata file using Notepad to view the contents.
    A snippet of what this metadata should look like is shown below:

    SAML Metadata Snippet for SSOCircle

Configuring Your Account on SSOCircle

  1. In a browser, go to the following URL: https://idp.ssocircle.com/sso/UI/Login
    The SSO login screen appears.

    SSO Login Screen

    Use your credentials to log in (or create a new account if you do not already have one):
  2. Click Log In.
    The User Profile screen appears, as shown in the following example screen:

    User Profile Screen

  3. Click Manage Metadata on the left side of the screen.
    The Manage your Service Provider Metadata screen appears:

    Manage your Service Provider Metadata Screen

  4. Click the Add new Service Provider link.
    The SAML Service Provider Metadata Import screen appears:

    SAML Service Provider Metadata Import Screen

  5. On the SAML Service Provider Metadata Import screen, do the following:
    1. For the FQDN, enter the SP Entity ID exactly as you entered it in your Cloudpath system: urn:testsaml:cloudpath:<your first name>. See SAML Configuration Fields for SSOCircle.
    2. In the Attributes section, check FirstName, LastName, and EmailAddress.
    3. In the Insert the SAML Metadata information of your SP section, copy and paste the entire contents of the metadata file that you downloaded earlier into the box provided. (Make sure there is no white space before the pasted contents.)
    Once you have entered the necessary information, the SAML Service Provider Metadata Import screen should look similar to the following (not all of the metadata is shown below, however):

    SAML Service Provider Metadata Import Screen After Information is Entered

  6. Click Submit.
    If the import is successful, you will receive a message such as the following:

    Metadata-Import -Successful Message

  7. Click Logout.

Publishing the Workflow for SAML SSOCircle

  1. Return to the workflow on your Cloudpath system by navigating to the Configuration > Workflows screen.
  2. Complete the workflow by adding a device configuration. Refer to Adding a Device Configuration to Your Workflow.
  3. Publish the workflow by clicking the Publish icon to the left of the workflow name.

Testing the User Experience for SAML SSOCircle

  1. Test the enrollment process by clicking on the enrollment portal URL for the workflow at the top of the Configuration > Workflows screen.
  2. When are you presented with the with the Welcome screen, click Start.
  3. When you are presented with various branches of your workflow, navigate down a branch that uses the SAML authentication server you just configured.
    You are directed to the SSOCircle login page.
  4. Log in with the your credentials.
    The SAML consent page appears:

    SAML Consent Page

  5. Check the "I'm not a robot" box, and follow the on-screen instructions.
  6. When a green check mark appears next to the "I'm not a robot" box, click Continue SAML Single Sign On.
  7. If the SAML authentication is successful, you are returned to the Cloudpath system, where you can continue with the enrollment.