The information in this article is for versions of qTest Manager released up to 9.2.7. If you are using Manager 9.3 or later, please read this article.
To add a new user to qTest Manager, you will need to invite them to the site via an activation link. The activation link is sent in an email generated from within qTest Manager.
You must be a Site Administrator to use this functionality. If you are using a free trial, you can invite up to four more users by default. If you need access to invite more than four other users, please contact firstname.lastname@example.org.
Invite a User to qTest Manager
- Position the arrow cursor over your username located in the top right corner of the Home page. A drop-down menu is displayed. Select the Administration option.
- The Site Administration - Projects page is displayed. Select the Licenses - Users tab.
- The number of available licenses displays in the "Available Licenses" field on the right side of the "Licenses" page. In the example shown above, one other user has been invited to use this qTest Manager account, and three other users can be invited to this account.
- Select + Invite. The "Invite User" dialog displays. In the "Login Email" field, enter the email address of a user you want to invite.
- Select OK. The "Activation Link" dialog displays.
A notification email is sent to the user. By selecting the activation link provided in the email, the user can activate his or her account and login to your qTest Manager account. You can also manually send the activation link to the user in case the activation emails end up in the user's Spam folder.
The email address of the user you invited displays in the "User’s List" field.
HINT: Each user you invite is automatically added to the qConnect Sample Project. The Sample Project comes with sample data, including requirements organized into folders, a test plan, test cases, and more.
Admin and User Profiles
- You can assign a user a default User Profile, so they are automatically assigned certain project permissions when added to a project.
- You can also assign a user with an Admin Profile, so they have administrative permissions across projects.
- For more details, see the article User Profiles.
To deactivate a user, perform the following steps.
- In Site Administration, select the Licenses Users tab.
- Hover your cursor in the ‘Action’ field for the user you want to deactivate. Select the Deactivate User icon. The user’s status will change to ‘Inactive’ and he/she will be removed from any previously-assigned projects and no longer be able to log into qTest Manager.
To reactivate an inactive user, perform the following steps.
- In Site Administration, select the Licenses Users tab. The "Licenses" page displays.
- Hover your cursor in the ‘Action’ field for the user you want to reactivate. Select the Reactivate User icon. The user’s status will change to ‘Active,’ and a notification email will be sent to the user. He/she will be invited back to any previously-assigned projects.
Resend Activation Link to User
When a new user is invited to qTest Manager, the user is sent an email that contains a link the user can click on and enter credentials to activate his or her qTest Manager account. If a new user was invited to qTest Manager but can’t find the activation email, and has therefore not activated the account, the activation link can be resent to the user. This function can only be performed by the site administrator.
To resend the activation link to a new user, perform the following steps:
- In Site Administration, selct the Licenses-Users tab.
- In the Users List area of the page, hover your cursor in the ‘Action’ field for the user you want to resend the invitation email. Then, select the Resend Invitation Email icon.
The following dialog displays.
- Select Yes. The "Get Activation Link" dialog displays. Select OK.
HINT: If the user still does not receive the activation email, the Site Administrator can copy the activation link from the Get Activation Link screen.
Resetting a User’s Password
If a qTest Manager user has activated his account but has forgotten his or her password, you can reset the user’s password by performing the following steps:
- In Site Administration, Select the Licenses - Users tab.
- In the Users List area of the page, hover the arrow cursor in the ‘Action’ field for the user whose password you want to reset. Then, select the Reset Password icon.
The Reset Password Link dialog displays.
- Select OK. A notification email is sent to the user that provides instructions to reset their account password.
IMPORTANT: If the user does not receive the notification email, you can send the URL directly to the user. This URL is unique for the user.
IMPORTANT: Resetting a user's password will reset all of that user's tokens.
Managing Active Sessions
As the Site Administrator, you can view and manually terminate active sessions. You can also configure the system to automatically terminate sessions which have been idle for a specified amount of time.
- In Site Administration, select the Licenses - Users tab, and then select Login Clients from the left navigation panel.
- You can see the number of current Active Sessions in the "Session Information" field.
- On the "Session Settings" field, you can optionally check Auto terminate sessions after users have idled for ... minutes and specify a number to enable this option. Select Save.
Note: a session is idle when it does not have any request from the client to the qTest server.
- All current active sessions, excluding Explorer sessions, are listed in the Active Sessions grid.
- In the Login Email field, enter a login email in the text box to filter the grid.
- Click the table's headers to sort the data.
Click on the X icon to terminate the corresponding session. The system will inform the user his or her session has been terminated by the admin.
- If you open qTest Manager in multiple tabs of the same web browser, they are counted as the same session.
- If you log in to qTest Manager using the same account on different web browsers, they are counted as different sessions.
- If you log in to qTest Manager using the same account on different computers, they are counted as different sessions.
- API sessions do not count towards the user's maximum three session limit.