Users

Users

Overview

Super admins can create new users and assign roles with predefined permissions.

If it is the Base Platform, super admins can perform basic configurations such as creating users and assigning roles. These roles include only “View” and “Modify” rights.

To access advanced user and role settings, ensure that the Customization App is enabled.

 

Creating a User

Super Admins can add new users and assign roles to define their access in the system.

image-20250626-044742.png

To create a new user, perform the following steps:

  1. Go to Customization and select Users.

  2. Click New.

  3. Enter the following details:

Username: The name users use to log in to QMetry.

Alias: A unique name to identify the user across QMetry. Alias appears in fields like “Requirement Owner” in the Requirement module.

Time zone: Select the user’s time zone.

Authentication Type: Users can log in using LDAP, SAML, or QMetry authentication.

image-20250626-052326.png

Setting Authentication Type

Super Admins can set the authentication type to QMetry Database, LDAP, or SAML (for single sign-on) while creating a new user. Super admins can change the authentication type later, if needed.

 

QMetry Authentication

By default, QMetry uses its own database to verify user login. When a super admin selects QMetry Authentication while creating a new user, the system sends a welcome email to the user’s registered email address with login details.

Switching from QMetry to LDAP or SAML authentication

To change an existing QMetry user’s authentication method to LDAP or SAML:

  1. Login as a super admin.

  2. Go to the User Management screen under the Customization section.

  3. Select Edit.

  4. Manually set the Authentication Type to LDAP or SAML.

  5. Click Update.

 

LDAP or SAML Authentication

While creating a new user, super admins can manually set the Authentication Type to LDAP or SAML. These authentication options are enabled only when the admin configures LDAP or SAML in the Integration section.

Users authenticated through LDAP or SAML cannot update or reset their password from within QMetry.

Switching from LDAP or SAML to QMetry authentication

If an LDAP or SAML user needs to switch to QMetry authentication:

  1. The user must first log in using LDAP or SAML authentication type.

  2. After the initial login, the Super Admin can change the Authentication Type to QMetry Database.

  3. The user receives a link to set a new QMetry password.

  4. Once updated, the user can log in using their QMetry username and new password.

After login, the user is assigned the default Project and Role.

Notes

  • Turn the Read Only flag “ON” to give the user "View" access to all assigned projects.

  • Read Only users use Read Only license. 

  • Switching a user from a Regular to a Read Only license automatically updates their access to Read Only in all assigned projects.

  • Switching a user from a Read Only to a Regular license restores their previously assigned roles, unless the roles are explicitly modified during the update.

  • When switching from Read Only to Regular, the previous roles are restored even if the system shows a warning saying, "Please map at least one Project and Role."

  • When switching a user from Read Only to Regular, manually update the pre-assigned roles before or after the switch if any changes are needed.

 

Mapping Roles

Super admins can assign Projects and Roles to the new user.

A. To assign a single Project and Role, select user's Role for the Project.

B. To assign multiple Projects to the user with the same Role for all the Projects:

  1. Select the Projects and click Bulk Assign.

  2. Select a Role and click Create

Read Only Role Rights

The Super Admin can assign "View" rights to a Role and then map that role to users who need Read Only access. This allows a group of users to view test assets in QMetry without the ability to add, edit, execute, or delete them.

If a user has a Regular license but is assigned only Read Only rights, they will still consume a Regular license.

Use Case: Customer has a group of users who need not have the authority to add, edit, or delete the test assets in QMetry. “Read Only” rights are sufficient for such users. The customer wants their users just to view the company data in QMetry.

 

Editing an Existing User

To edit the details of an existing user:

  1. Click Edit under the Action column.

  2. On the User Details tab, you can

    1. Update user details

    2. Update User Role Assignment

image-20250626-044347.png
  1. On the Security tab, you can:

  • Update User Password

  • Enable or disable Two-step Verification for QMetry

Notes

  • Super Admins can update a user's login username.

  • The super admin username is non editable.

  • When updating a username, ensure it is unique across all users, including Active, Archived, and Deleted users.

  • When a username is updated, audit logs capture this change, and the updated name will reflect throughout the application.

 

Deactivating a User

A super admin can deactivate an active user, restricting them from logging in to QMetry.

To deactivate a user:

  1. Go to Customization and select Users.

  2. Select the user and click Deactivate.

When deactivating a user, the admin can assign another user as the co-owner of the deactivated user's dashboards. All dashboards owned by the deactivated user are shared with the selected co-owner.

image-20250626-070916.png

 

  1. Select a user to be co-owner of the dashboards created by the user being deactivated.

  2. Select Yes to proceed

 

Reactivating a User

The super admin can activate the deactivated users.

Steps to reactivate a user:

  1. Go to Customization and select Users.

  2. To view the deactivated users, apply filter on the Active parameter and select “No”.

3. Select the user and click Activate.

 

Deleting a User

When the admin deletes a user from QMetry, the system marks them as inactive and blocks login access. It also prevents the creation of new users with the same username.

All deleted users appear as “inactive” in user dropdowns where applicable.

Steps to delete a user:

  1. Go to Customization and select Users.

  2. Deactivate the user.

  3. To view the deactivated users, apply filter on the Active parameter with option No.

4. Select the user and click Delete.

 

Restoring Deleted Users 

Super Admins can restore deleted users. Restored users are reactivated in a deactivated state and do not retain previous project access, allowing admins to review and reassign access as needed.

image-20250626-072119.png

To restore deleted users:

  1. Navigate to Customization and select Users.

  2. Click the Restore Deleted User button (refer above image).

  3. Select the user from the list of deleted users.

    • Filter the list on user type, username, first name, last name, or email id.

  4. Click Restore.

The selected user is restored as a Deactivated user and appears in the User List.

Note

When a user is reactivated, the super admin must reassign all relevant projects and roles to the user.

 

Transferring Super Administrator Role

Super admins can transfer their access to another user directly from General Settings, eliminating the need to contact QMetry Support. This facilitates smoother transitions during organizational changes.

 

Self-Transfer

A Super Admin can transfer their rights to another user using the Transfer Super Administrator tab under General Settings.

image-20250514-094803.png

For self-transferring the super admin role:

  1. Navigate to Customization and select General Setting and Audit.

  2. Go to Transfer Super Administrator tab.

  3. Select the new super admin from the Select User list.

    • Only eligible users (active and QMetry-authenticated users) are listed.

    • Read-only license users will not appear in the list.

  4. Click Yes to confirm the transfer.

 

Notes

  • The new super admin is granted admin rights across all projects, including archived and active ones.

  • They receive default access to all custom dashboards and gadgets within the instance.

  • They have full permissions to manage organization settings, users, projects, and system configurations.

  • The current Super Admin’s privileges are revoked and replaced with project-level admin access for all existing projects.

  • Once the transfer is complete, email notifications are sent to both the new and previous super admins.