Users, accounts and roles

Users

Once you have signed up for QualityGate a new user with the provided email address is created. An initial password will be sent to that email address which can be used for logging into the system. Once logged in the initial password can be changed under the Change password menu. The users can either be natural entities or technical users of legal entities.

Accounts

Accounts represent entities who can own subscriptions and private projects. An account is automatically created for each QualityGate user during registration. For this account, the newly created user gets both Owner and Admin roles.

Roles

Roles describe relationships between users and accounts. One user can have multiple roles for any number of accounts. In QualityGate the following roles are defined:

  • OWNER - each account has exactly one owner that cannot change over time. Similarly, each user owns exactly one account. A user with this role can manage the owned account’s users and subscriptions.
  • ADMIN - a user having this role becomes an administrator of the account letting him/her managing users, projects, rights, etc. A user can become an administrator of multiple accounts and an account can have multiple administrators.
  • CIO - a user with this role is allowed to see every project of the account. The Dashboard’s user interfaces are limited to high-level views of the projects only. A user can become a CIO of multiple accounts and an account can have multiple CIOs.
  • PROJECT_MANAGER - a user with this role can be regarded as an administrator of particular projects belonging to the account. Having this role requires granting the user access to each projects separately (Users). A user can be the project manager of multiple projects belonging to different accounts. Similarly, one project can have multiple project managers.
  • TEAM_MEMBER - a user with this role is someone who effectively works on particular projects or takes care of the low-level issues found by QualityGate. Having this role requires granting the user access to each projects separately (Users). A user with this role can drill down to code level, while cannot access higher-level information, such as project-level qualification or developer qualification.
_images/manageusers.png

The following table shows the cross-reference of roles and functionalities.

  OWNER ADMIN CIO PROJECT_MANAGER TEAM_MEMBER
Manage billing X        
Manage subscriptions X        
Manage projects   X X    
Add projects   X X    
List projects   X X X X
Manage users X X X    
Assign account-level roles   X X    
Manage branches   X X X  
Manage analysis   X X X  
Manage analyzers X X X    

Changing the current account

Users having various roles for different accounts can change the account on behalf of which they act by selecting the current account in the upper right corner of the user interface.

Changing the default account

Each user can have various roles for different accounts. In the User Profile menu, users can set their default account, which will be used when they log in to QualityGate.

Adding users to an account

In the Manage Users menu, a user of an account having the proper role can add, invite or delete new or existing users of an account. When a user with PROJECT_MANAGER or TEAM_MEMBER role is added, project-level access should also be granted under the Users menu. If a user is added who does not have a QualityGate registration yet, an invitation email is sent to the provided email address.

Managing API tokens

For every account a user is related to with a role, an API token is generated. This token can be used for submitting requests to QualityGate through its REST API (see: REST API). The API tokens can be managed in the User Profile menu.

Deleting users

Users can delete themselves from QualityGate by clicking the Delete button at the bottom of the User Profile page.

Back: Subscriptions and Billing Next: Private analysis and Analyzers