Configuring Single Sign-On in JumpCloud


Navigate to your JumpCloud and switch to "Applications" section. Click on the "Plus" button (show in the screenshot below) to add new application.

In "Configure New Application" pane, locate the "Custom SAML App" item (usually it's the first item in the list) and click "configure" button inside it.

Set Bugsee as the "Display label" field value and optionally pick the color for that app. Now, in Bugsee's web dashboard, bring up the SSO setup wizard. On the first step of Bugsee SSO setup wizard, click "Download" for "Service Provider metdata URL". Now use the downloaded file for "Service Provider Metadata" in JumpCloud application configuration page (Click "Upload Metadata" and select the downloaded file).

Once upload completes, some of the fields will be populated automatically as shown. Notice, that "IDP Entity ID" is not filled. Just copy and paste the value from "SP Entity ID" to "IDP Entity ID".

Next, we need to configure user attributes. They will contain information about the user being authenticated and must match to the values specified in the "Fields Map" step in Bugsee SSO setup wizard. Follow the visual instructions below.

Remember and/or make note of the attributes' names you've used. We will need them later in Bugsee SSO setup wizard.

You can read more about user attributes available in JumpCloud in their Knowledge base article

Now, make sure "Sign assertion" is not checked and "Declare redirect endpoint" is, on the contrary, is checked. Fill in "IdP-initiated URL" only if you want to force the "SP-initiated authentication SSO" (Bugsee supports both SP- and IdP-initiated authentication SSO). As the last segment in "IdP URL" put "bugsee".

Finally, click "activate" button at the bottom and then "continue" in the confirmation popup dialog.

Now you have your application configured in JumpCloud. Next, we will need to configure Bugsee to complete the SSO setup. Before we switch to Bugsee, we need to export IdP metadata for the created application in JumpCloud. You have two options:

  • In the list of application in JumpCloud, set check next to the newly created one Bugsee application. Then in the top-right corner, click "export metadata" button.
  • Click the newly created application in JumpCloud to bring up its configuration settings pane. At its bottom, click "export metadata" link.

Once you have the metadata file, switch over to Bugsee web dashboard to continue configuring SSO there. Click "Next" to switch to the second step. Select "XML" for the "IdP metadata source" and paste the contents of the downloaded IdP metadata file from JumpCloud into corresponding field.

Click "Next". Now, at the "Fields Map" step, we need to put the names of the fields we have defined in the application settings in JumpCloud. Put the values like it's shown below

Finally, go through the remaining steps in the wizard (which are very simple) and you're done with configuring SSO.