User accounts are used to control access to Virtool. They allow fine control of what actions users are allowed to perform and what resources they are allowed to access.
When users create new data items (eg. samples, references, jobs), they are automatically assigned as the owner of that item.
For references and samples, owners have perpetual full rights on their samples and references.
Rights are properties of samples and references that control what actions specific users or user groups are allowed to perform on them.
Administrators automatically pass all rights checks.
Permissions are used to control what application-level actions users are allowed to perform. Permissions are inherited through group membership.
Administrators automatically pass all permission checks.
||can cancel running jobs|
||can create references|
||can create samples|
||can add and remove HMM annotations and files|
||can add, modify, and remove subtractions|
||can remove uploaded files|
||can remove cancelled and finished jobs|
||can upload files|
Groups allow setting rights and permissions for more than one user. Users that are members of a group will inherit rights and permissions from the group.
It is not possible to set permissions on a per-user basis.
User accounts can either be administrative or limited.
Administrators automatically pass all permission and right checks. They can also access the Administration Panel.
Click the button to open the user creation dialog.
Enter a username and password for the user. Clicking Force user to reset password on login will display a password reset page for the user when they login for the first time.
Click Save to add the user. They will appear in the list of users.
Administrators can forcefully change a users’s password.
This is useful when a user forgets their password or an old user account must be accessed.
Locate the Change Password panel in the Users tab.
Enter a new password and click Save.
The Last changed time will be updated if you successfully change the password.
Clicking Force user to reset password on login will invalidate all of the users existing sessions and require them to login and reset their password when they try to access Virtool.
Users’ group membership can be changed easily.
This may affect what rights the user has on certain samples and references. It can also affect their application permissions.
Locate the Groups panel in the Users tab.
Click one of the group items to toggle membership in it.
Notice that the user’s permissions are changed when group membership is toggled.
Samples that a user creates can automatically be assigned to the creating user’s primary user group.
How samples are assigned their initial user group is configurable.
Locate the Primary Group panel under the Users tab.
Select a primary group for the user from the dropdown list of the user’s member groups.
The display group is the user’s primary group.
The group management interface can be acessed by clicking the button to the right of the search bar in Users tab.
The group management interface looks like this:
Open the group management interface. Enter a name for the new group in the input at the top of dialog and click the button.
The new group will appear in the groups list.
Open the group management interface and select the group you want to change permissions for.
Toggle permission by clicking them.
Users added to the Managers group will inherit the toggled permissions.
Open the group management interface and select the group you want to remove.
Click the Remove Group button to remove the group.