Configure QMetry Application in Azure AD

The document describes the steps to set up single sign-on (SSO) for the application that you added to your Azure Active Directory (Azure AD) tenant. After you set up SSO, you can sign in to the application by using your Azure AD credentials.

Supported Browsers

Browser Name

Steps to use the browser smoothly

Chrome

Clear cache or log out of Azure AD portal

Firefox

Clear cache or log out of Azure AD portal

Edge

  • If you are signed in the Edge browser, sign out from the Edge profile.

  • If you are not signed into the Edge profile, then clear cache or log out of Azure AD portal

Configuring Application in Azure AD

Note

One Azure AD tenant can be integrated with only one instance. For example, if you have two client instances, setting them up as separate enterprise applications in a given Azure AD tenant will not be supported, and could cause issues with the authentication of users during login into .

  1. Log in to https://portal.azure.com/ with an Admin account.

  2. On the side menu bar and go to Azure Active Directory.

    Azure_Active_Directory.png

  3. Go to Enterprise Applications.

    Enterprise_Applications.png

  4. Click New Application.

    New_Application_.png

  5. Click Create your own application.

    Create_your_own_application_.png

  6. Enter the name of the application. Ensure you select the option - Integrate any other application you don't find in the gallery.

    name_of_the_application_.png

  7. Click Set up single sign-on section.

    Set_up_single_sign-on.png

  8. Click SAML.

  9. Download XML file and comment the code. Download the Federation Metadata XML from the screen.

    Federation_Metadata_XML.png

    Open the XML file and comment the Signature and RoleDescriptor tags in the file as shown below.

    It is recommended to delete the commented portion in the file.

    Comment.png

  10. Upload the XML file in QMetry with the following parameters set:

    • Active: Select "Yes" to keep the SAML State "Active".

    • Default Access Type: Select the Default User Access Type for Regular User.

      Upload_the_XML_file.png

  11. Change the Certificate file "SAML Certificates" section in your Azure AD application.

    1. Click Edit.

      Change_the_Certificate.png

    2. Click Import Certificate.

    3. Select the private key file and enter the Password.

      Get the keystore.p12 (Private Key) file and Password from QMetry Support.

    4. Delete other "Inactive" Certificates.

      SAML_Signing_Certificate.png

  12. Upload the metadata file.

    How to get metadata file?

    1. Log into using your administrator account.

    2. Go to Integrations and select LDAP/SAML. Choose SAML and click Download QMetry Metadata. You will get an XML file "qmetrysaml_meta.xml".

      Get_Metadata_file.png

      Now go to the SAML section of Microsoft Azure.

      Upload_metadata_file.png

    3. Click Upload metadata file and upload the "qmetrysaml_meta.xml" file.

      Upload_metadata_file.png

      Once you upload the file, save it.

  13. Change in user attributes.

    You should configure Firstname, LastName, and Email from Azure to QMetry. The values will be populated in respective fields when you are creating a new user in QMetry.

    In Azure, go to the User Attributes' Claims section and click Add new claim.

    Add_new_claim.png

    • Mention fields (FirstName, LastName, and Email) at left under Claim name.

      Note

      Make sure the format is FirstName, LastName and Email.

    • Select its corresponding values in Azure from the drop-down list at right. The values are editable.

      For example, the value for FirstName is set as user.givenname, LastName is set as user.surname and the value for Email is set as user.mail in the screenshots below.

      Manage_Claim.png

  14. Open the created app and click Assign users and groups section.

    Assign_users_and_groups.png

    Add required users or group by clicking on the Add user or group button. Click Assign. Assign users to the app through Add Assignment.

    The assigned users are displayed on the screen. These users will have access to the created app and will be able to log into QMetry through Azure AD.

  15. Log into .

    Now check the Login screen. If the SAML Settings are configured successfully, then the Login with SAML link appears on the Login screen.

    Login_with_SAML.png

    Once your credentials are authenticated, you are navigated to the application. You can log in to with Azure AD credentials.

  16. Click on the Login with SAML link.

  17. Click Submit. It navigates you to the IDP Provider site.

    The login screen of the Identity Provider opens. Provide your Username and Password here.

  18. The login screen of the Identity Provider opens. Enter your Username and Password here.

    Login_with_SAML.png
In this section:
© 2025
Publication date: