Configuring SAML for Jitbit

This topic describes how to configure OneLogin to provide SSO for Jitbit using SAML.

1. Log into OneLogin as an admin and go to Apps > Add Apps.

2. Search for and select the Jitbit Helpdesk connector.

   The initial Configuration tab appears.

3. Click Save to add the app to your Company Apps and display additional configuration tabs.

   The Info tab appears.

4. Go to the Configuration tab and enter your Jitbit subdomain in the URL field.

   https://your_org.jitbit.com/helpdesk/

5. Click Save.

6. Go to the Parameters tab and map Jitbit attributes to OneLogin attributes.

   In most cases, you should keep the Configured by admin default. For more information, see Setting Credential Configuration Options.

   For most implementations, you can accept all of the default attribute mappings. Ensure that the Jitbit field NameID (Subject) is set to Email. To change OneLogin values, click the parameter row to open the Edit Field dialog, and select the value from the drop-down list. Click Save if you made any changes on the Parameters tab.

   

7. Go to the SSO tab to configure your Jitbit account with OneLogin's SAML settings.

   

   1. In a new browser tab, log into your organization's Jitbit account as admin.

   2. On the Administration tab, select General Settings and scroll down to the Authentication Settings section.

   3. Select the Enable SAML 2.0 single sign on option to allow for SSO functionality.

   4. With both the OneLogin SSO tab and the Jitbit Authentication Settings page open, copy the following OneLogin SAML values to the analogous Jitbit fields.

      Copy this OneLogin SSO field value:	To this Jitbit SSO field:
      SAML 2.0 Endpoint (HTTP)	EndPoint URL
      X.509 Certificate To get the X.509 Certificate, click View Details to open the certificate page. Copy the entire X.509 Certificate, including "----BEGIN CERTIFICATE----" and "----END CERTIFICATE----."	X.509 Certificate Paste the entire X.509 Certificate into the Jitbit X.509 certificate field.

      
      

      When you are finished, the Jitbit Authentication settings page should look like this:

      

8. Click Save.

9. On the OneLogin Access tab, assign the OneLogin roles that should have access to Jitbit and provide any app security policy that you want to apply to Jitbit.

   You can also go to Users > All Users to add the app to individual user accounts.

10. Click Save.

11. Test the SAML connection.

    1. Ensure that you have user accounts in both OneLogin and Jitbit that use the same email as the username.

       You can create a test user, or you can use your own account if you choose.

    2. Make sure you are logged out of Jitbit.

    3. Log in to OneLogin as an admin and give the test user access to the Jitbit app in OneLogin. (See step 9 above)

    4. Log in to OneLogin as the test user.

    5. Click the Jitbit icon on your OneLogin dashboard.

       If you are able to access Jitbit, then SAML works.