Configuring single sign-on (SSO) with OneLogin

For partners subscribed to Basic with SSO 2021, Select with SSO 2021, and Enterprise plans.

In this article, you'll learn how to configure SSO on your IT Glue account using OneLogin. For instructions on how to configure SSO for MyGlue using OneLogin, refer to the blue info

If you are configuring SSO for MyGlue using OneLogin, the instructions are the same but you will need to enter different values when configuring OneLogin and your MyGlue account settings page. Click here to see the different values that you'll need to substitute in at key steps within this KB article.

NOTE  These instructions refer to OneLogin but you can use any SSO provider that supports SAML 2.0 or configure your own solution. For more information, refer to our main SAML topic.

Prerequisites

  • You must have Administrator level access to IT Glue to configure SSO on your account.
  • Ensure your users are provisioned in the identity provider (OneLogin), with exactly the same email address as their IT Glue account. We don’t create user accounts under SSO.
  • Before turning this feature on, log in to your IT Glue account twice - once in a regular browser and once in an incognito/private window. This is to ensure that you are still logged in to your account if you get locked out in the other window. Alternatively, you can also log in to two separate browsers.

Instructions

Configuring OneLogin

OneLogin for IT Glue works the way it does for other sites and apps. In other words, a user logs in once to have automatic access to IT Glue and many other applications such as email, your CRM, and so on without having to log in separately to those services.

  1. In the admin portal for OneLogin, navigate to Applications > Applications and then search for and select IT Glue.
  2. Click Save to add the app to your Company Apps and display additional configuration tabs.
  3. In the Configuration tab, enter your IT Glue subdomain in the field provided. For example, if your IT Glue account URL is "mycompany.itglue.com", then you would enter mycompany. If you have an EU-hosted IT Glue account, then you would enter mycompany.eu in the field.
    Knowledge_Base_-_Customer_Support-3.png
  4. On the SSO tab, select SHA-265 in the SAML Signature Algorithm drop-down menu. Then, copy the three URLs (Issuer, SAML 2.0 Endpoint, SLO Endpoint) that are displayed on this screen using their respective Copy to Clipboard buttons.
    OneLogin.png
  5. Click the View Details link under the X.509 Certificate. Ensure the SHA fingerprint drop-down is set to SHA1 before clicking the Copy to Clipboard button.
    Screenshot_2021-02-10__4_25_PM.png
  6. Scroll down to the X.509 Certificate section and click the Copy to Clipboard button to copy the entire certificate, including the Begin Certificate and End Certificate text.
    itglue-x509-2.png
  7. Finally, on the Access tab, assign the application to a user role that will allow users to access IT Glue.

Configuring IT Glue

After setting up OneLogin, you will need to configure your IT Glue account to authenticate using SAML. You will need a few pieces of information from OneLogin to complete this step.

IMPORTANT  It's highly recommended that before you begin the below set of instructions, log in to your IT Glue account twice - once in a regular browser and once in an incognito/private window. Alternatively, you can also log in to two separate browsers. This is to ensure that you are still logged in to your account in case you are locked out in the other window.

  1. Log in to IT Glue and navigate to Account > Settings > Authentication tab.
    Account_Settings___IT_Glue.png
  2. Click to turn the Enable SAML SSO toggle switch to ON. Once this is turned on, a form will appear. You will need to enter the information you collected from OneLogin in the section above into this form.
    Untitled-2_copy.png
    1. Copy the OneLogin Issuer URL and paste it into the IT Glue Issuer URL field.
    2. Copy the OneLogin SAML 2.0 Endpoint URL and paste it in the IT Glue SAML Login Endpoint URL field.
    3. Copy the OneLogin SLO Endpoint URL and paste it in the IT Glue SAML Logout Endpoint URL field.
      Note: IT Glue does not support SSO logout URLs.
    4. Copy the SHA-1 fingerprint you created above and paste it into the IT Glue Fingerprint field.
    5. Copy the X.509 certificate and paste it into the IT Glue Certificate field.

    6. IMPORTANT  Ensure there are no extra spaces trailing at the end of the Certificate string (i.e. after -----END CERTIFICATE-----).

  3. Click Save.

    IMPORTANT  Warning. Click Save only when all information has been entered. If you turn on SSO prematurely, it will break the login experience for all users on your account.

Once you make this change, you can test your access.

Configuring MyGlue

If you are setting up SSO for MyGlue, complete all steps as instructed in the Configuring OneLogin section. However, in step 3, you need to substitute different values as follows:

  • In the Configuration tab, enter https://app.myglue.com

Testing SSO authentication

Before you configured SSO, you should have created two IT Glue browser sessions. If you get locked out, you will be able to use the incognito/private window to turn off SSO while you investigate the cause.

To make sure SSO is working, perform these steps:

  1. Log out of and close any OneLogin browser sessions you have open.
  2. In a new browser session, navigate to your IT Glue account subdomain (mycompany.itglue.com) directly. This should redirect you to the identity provider.
  3. Enter your SSO credentials.

After entering your credentials, you should be redirected and logged into IT Glue.

Troubleshooting an email mismatch

If you have been using OneLogin for some time, your IT Glue account admin email may not match your OneLogin admin email. This can be remedied by doing the following:

  1. In OneLogin, go to Users > Account_Owner.
  2. Select the Applications tab.
  3. Select IT Glue to open the Edit Login pane.

Here you can overwrite the default fields for your IT Glue login and insert the correct information to match your OneLogin credentials with your IT Glue credentials.

Common Questions

When the SSO server is unavailable, how do we access our accounts?

If your SSO provider's service is unavailable, you can still login using your IT Glue username and password at app.itglue.com.

If your SSO is not working, confirm your provider's service is available. Send us an email for assistance.

How do we disable SSO for a user?

To disable a user account, an Administrator or a Manager will need to navigate to the Account > Users page in IT Glue. We don’t currently support disabling user accounts through the SSO server.