Using Gluu as the SAML Identity Provider

You can use a Gluu server with Shibboleth Version 3 as the IdP with the Cloudpath server.

A Gluu server is a fully certified OpenID Provider that supports a number of OpenID Connect specifications.

Basic Tasks for Using Gluu

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

  1. Adding a SAML Step To Your Workflow
  2. Adding the Gluu SAML Authentication Server to the Workflow
  3. Downloading the SAML Metadata for Gluu
  4. Connecting to the Gluu Identity Service Provider
  5. Publishing the Workflow for SAML Gluu
  6. Testing the User Experience for SAML Gluu

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 Gluu 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. An example configuration is shown in the screen below, followed by field descriptions.
    Note: You can click the "i" icons next to the field names to obtain the information required for each field.

    SAML Configuration Fields for GLUU

    • Required SAML Configuration section:
      • IdP Metadata Type: Use the URL option.
      • IdP Metadata URL: Enter the URL, using your hostname. Example URL: https://test117.cloudpath.net/idp/shibboleth
      • IdP EntityID: Enter the URL, using your hostname. Example URL: https://test117.cloudpath.net/idp/shibboleth
      • SP EntityID: Enter the string urn:testsaml:cloudpath:followed by your first name. For example: urn:testsaml:cloudpath:Jeff
    • SAML Attribute to Enrollment Mappings: Click the inetOrgPerson/X.500 tab to automatically have the fields filled in.
    • 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 Gluu

  1. In the workflow, click the arrow (circled in red in the figure below) to download the SAML metadata, and save it to a local file:

    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 the metadata should look like is shown below:

    SAML Metadata Snippet for GLUU

Connecting to the Gluu Identity Service Provider

  1. In a browser, go to the URL of your Gluu server.
    The Gluu login screen appears.

    Gluu Login Screen

  2. Enter your credentials, then click LOGIN.
    The Gluu Welcome screen appears:

    Gluu Welcome Screen

  3. On the left-side menu, click SAML > Add Trust Relationships.
    The following screen appears:

    Add Trust Relationships - Initial Screen

  4. Configure the following fields:
    • Display Name: The hostname of your Cloudpath system.
    • Description: Any description you want to enter. This field is required, however.
    • Entity Type: Select "Single SP" from the drop-down list.
    • Metadata Location: Select "File" from the drop-down list, then click Choose File, and upload the metadata file that you downloaded earlier.
    The screen has now expanded and will appear like the figure shown below:

    Add Trust Relationships - Expanded Screen

  5. Continue by doing the following:
    1. SP Logout URL (optional): You can leave this blank if you wish.
    2. Configure Relying Party: Check the box, after which a green link of the same name appears.
      1. Click the green link. The following screen appears:

        Relying Party Configuration Screen - Selecting Add All

      2. Select Add All. The following expanded screen appears:

        Relying Party Configuration Screen - Expanded Screen

      3. Keep all the default selections, and click Save.
    3. Released: Highlight New Trust Relationships, then click on any attributes on the left side of the screen that you wish to add for user information. It is recommended to at least add the following: Username, Email, Display Name, First Name, Last Name, and memberOf. After making your selections, click Add. The following screen example shows the attributes that have been selected before clicking the Add button:

      Selecting Additional Attributes

    4. Click Activate. If successful, you should see a screen such as the following:

      Addition of Attributes is Successful

    5. Log out of the Gluu interface.

Publishing the Workflow for SAML Gluu

  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 Gluu

  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 Gluu login page:

    Gluu Login Page

  4. Log in with your credentials.
  5. If the SAML authentication is successful, you are returned to the Cloudpath system, where you can continue with the enrollment.