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

Supported Browsers

Steps:

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

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

Open

Step 3. Go to Enterprise Applications.

Open

Step 4. Click on New Application.

Step 5. Click on Create your own application.

Step 6. Enter name of the application.

Make sure you select the option - Integrate any other application you don't find in the gallery.

Step 7. Click on the Set up single sing on section.

Step 8. Click on the SAML section.

Step 9. Upload QMetry metadata file.

→ How to get metadata file?

1. Log into QMetry Test Management using your administrator account.

2. Go to Integrations >> LDAP/SAML >> Choose SAML >> Download QMetry Metadata from the screen by clicking on the button >> You will get an XML file "qmetrysaml_meta.xml".
   
   

Now go to the SAML section of Microsoft Azure.

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

Once you upload the file, save it.

Step 10. 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.

Click on Add new claim to add new claims.

• Mention QMetry 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.

The added claims and corresponding values look like below.

Step 11.  Download XML file and comment the code.

Download the Federation Metadata XML from the screen.

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

Step 12. Open the created app and click on the Assign users and groups section.

Add required users/group by clicking on the Add user/group button.

Click on the Assign button at the bottom. 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 able to log into QMetry through Azure AD.

Step 13. 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.

Step 14. Log into QMetry

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

Click on the Login with SAML link.

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

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

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