NOTE: We currently don't support clicking on the app tile within the IdP, users must access the CHEQROOM login page. We recommend that you bookmark that link for faster access. This is because we only support SP-initiated SSO flow.

You'll learn how to configure SSO on your CHEQROOM account using SAML Idp:

Enable SAML integration

  • Log in to your CHEQROOM account

  • Go to Settings

  • Go to Integrations

  • Find the SSO SAML integration and click Configure

  • Choose a Default user role, this will be assigned to a user who logs in through SAML Idp SSO but has no assigned role. Here we recommend using a role that hasn't got a lot of permissions (for example the Equipment Viewer role)

  • Choose where your roles are sourced, this lets you choose if you want to manage the roles from SAML IdP or keep the role management in CHEQROOM. More information can be found on the Configure how roles are managed for SSO help article.

  • Fill in the Domains field, by default, we already add the domain of your email address. In some cases it can be that you have multiple email domains (f.e john@yourcompany1.com and john@yourcompany2.com), then you need to add both domains.

  • Click Next to proceed to the SAML IdP setup.

Setup SAML IdP

  • Go to your IdP and add a SAML application for CHEQROOM

  • Most SAML IdP's will immediately provide a metadata file when you are creating a SAML application. but it's also possible that you will first need to add the application before you can download the IdP metadata file. Download Metadata and upload the file on the SAML integration page in CHEQROOM

  • The Service Provider details (ACS URL and Entity ID) can also be copied from the SAML integration page in CHEQROOM

  • Make sure that you configure the following attributes:

    • name

    • username

    • email

  • Also make sure that you return a Name Identifier (NameID) in your SAML response

  • When you're done adding the application in your IdP, go back to the SAML integration page in CHEQROOM and click Enable SSO

Testing SSO

To make sure SSO is working properly, perform these steps:

  1. Log out and close all CHEQROOM browser sessions you have open

  2. Go to https://login.cheqroom.com

  3. Enter your email address

  4. You should now be redirected to your SAML IdP login page

  5. Enter your credentials

After entering your credentials, you should be redirected and logged in to CHEQROOM.

Configuring Roles

This step is only related if you've chosen that your roles are managed from SAML IdP. More information can be found on the Configure how roles are managed for SSO help article.

  • Go to the CHEQROOM application in your IdP

  • Add an extra attribute (similar like adding name, email, username):

    • cheqroom__role

  • Next you will need to specific the role values on your users. You can copy paste the role values from the SAML integration page in CHEQROOM.

Did this answer your question?