Groups
Prerequisites
Access Level:
User, Sub-admin, Admin
Permission Requirements
- . Basic Vault Interaction
- View metadata for own files (necessary to download)
- View access/sharing/project history of own files
- Create file metadata
- View keys for own files (necessary to download)
- Download own files' content
- View directories
- Create directories
- Delete directories
- . Basic Group Interaction
- View groups they are a member of
- View keys for groups they are a member of
- Create groups
- Rename own groups and transfer ownership
- Add users to groups they are a member of
- Edit other members in groups they are a member of
- Remove other users from groups they are a member of
- Delete groups they are the owner of
- . Basic Project Interaction
- View projects they are a member of
- View other members in projects they are a member of
- Classify resources with projects they are active in
- . Project Management
- Declassify resources tagged with projects they manage
- Edit metadata for projects they manage
- Delete projects they manage
- Add users to projects they manage
Groups let you share files with a defined set of collaborators in a single action. Instead of sharing each file individually with multiple users, share it with a group and all members receive access.
When to use groups:
- You regularly share files with the same set of people (e.g., a research team, a lab group)
- You want new files to be automatically accessible to all group members when shared with the group
- You need to manage access collectively: adding a member to the group grants access to all group-shared files; removing a member revokes it
Groups can also be associated with projects, restricting group membership to certified project members.
Access Group Directories
- Go to the Vault icon in the top left panel.
- Click the Groups card on the right panel.
- View all the groups you have access to in the right panel.
- Users with user roles can only view the groups they are part of.
- Users with sub-admin roles and admin roles can view the groups they manage.
- Users with super-admin roles can view all existing and past groups.
You can use the search bar to find a group in the right panel.
View Groups from Management
- Go to the Management icon in the top left taskbar.
- Navigate to the Users section.
- Click the Groups section in the top left panel.
- View all existing and past groups in the system.
You must be a user with an admin or super-admin role to access groups from the Management section.
View Your Group Members from the Vault
- Go to the Vault icon in the top left panel.
- Click the Groups card on the right panel.
- Click the group whose members you want to view.
- In the new window, view the list of group members on the right.
Create a Group
- Go to the Vault icon in the top left panel.
- Click the Groups card on the right panel.
- Click the Create group button.
- In the pop-up, enter the group name.
- Click Create.
- In the new pop-up, enter user names to add to the group.
- Select their user permissions in the group.
- Click Add to group.
- The box Add users to group after creation is checked by default.
- You may be asked to enter your password upon group creation.
When you create a group you are automatically assigned the group owner role.
Create a Group Tagged by a Project from the Vault
- Go to the Vault icon in the top left panel.
- Click the Groups card on the right panel.
- Click the Create group button.
- In the pop-up, enter the group name and select the project to tag the group with.
- Click Create.
- In the new pop-up, enter user names to add to the group.
- Select their user permissions in the group.
- Click Add to group.
You can only add users to a group if they are members of the project the group is tagged with. Users must satisfy project requirements to join a project-tagged group.
Manage a Group
- Go to the Vault icon in the top left panel.
- Click the Groups card on the right panel.
- Click the Open Full Menu button next to the appropriate group.
- Select Open overlay.
- In the pop-up, view the group details.
Group members can be managed by a group owner or by a group member with group permissions granted by the owner.
Add a New Member to a Group
- Go to the Vault icon in the top left panel.
- Click the Groups card on the right panel.
- Click the group to open the group overlay.
- In the new window, click the Add a new member section in the left panel.
- In the pop-up, enter the user name to add to the group.
- Select the user's permissions in the group.
- Click Add to group.
You cannot add members to a project-tagged group unless you are a member of the same tagged project.
Change Group Members' Permissions
- Go to the Vault icon in the top left panel.
- Click the Groups card on the right panel.
- Click the group to open the group overlay.
- In the new window, select the user you wish to change permissions for.
- On the left panel tick or untick the permissions as needed.
- Once done, click Close.
Promote a Group Member to Owner of the Group
- Go to the Vault icon in the top left panel.
- Click the Groups card on the right panel.
- Click the group to open the group overlay.
- In the new window, select the user you wish to promote to group owner.
- Click Promote to owner button in the top left panel.
- In the pop-up, click Yes to confirm.
The owner of the group may perform actions within the group regardless of their group permissions.
When you promote a member to group owner, you will lose all ownership permissions. You will no longer be able to delete the group, but you can leave it. The promoted user, as the new group owner, will have the ability to delete the group but will not be able to leave it.
Make a Group Member a Group Manager
- Go to the Vault icon in the top left panel.
- Click the Groups card on the right panel.
- Click the group to open the group overlay.
- In the new window, select the group member you wish to promote to group manager.
- Tick the Add Members permission in the left panel.
- View the role change under the Role column on the right.
Remove a Group Member
- Go to the Vault icon in the top left panel.
- Click the Groups card on the right panel.
- Click the group to open the group overlay.
- In the new window, select the user you wish to remove from the group.
- Click Remove from group button in the left panel.
- In the pop-up, click Yes to confirm.
Removed group members cannot interact with the group's files in any way.
Rename a Group
Method one:
- Go to the Vault icon in the top left panel.
- Click the Groups card on the right panel.
- Click the Open Full Menu button next to the group you wish to rename.
- Select Rename.
- In the pop-up, enter the new group name.
- Click Rename.
Method two:
- Go to the Vault icon in the top left panel.
- Click the Groups card on the right panel.
- Click the group to open the group overlay.
- In the new window, click the Rename group section in the left panel.
- In the pop-up, enter the new group name.
- Click Rename.
Change the Project in a Group
Method one:
- Go to the Vault icon in the top left panel.
- Click the Groups card on the right panel.
- Click the Open Full Menu button next to the group whose project you wish to change.
- Select Change project.
- In the pop-up, select the project.
- Click Classify.
Method two:
- Go to the Vault icon in the top left panel.
- Click the Groups card on the right panel.
- Click the group to open the group overlay.
- In the new window, click the Change project section in the left panel.
- In the pop-up, select the project.
- Click Classify.
- You must be a certified member of the project you want to tag your group with.
- Multiple groups can share the same project tag.
- Non-members of the project can view the tagged group's contents only after being granted certified project membership by an admin.
Forcefully Change the Project in a Group
Method one:
- Go to the Vault icon in the top left panel.
- Click the Groups card on the right panel.
- Click the Open Full Menu button next to the group whose project you wish to change.
- Select Change project.
- In the pop-up, tick Use my permission to override rules, re-tag resources with any visible project, regardless of current project relations.
- Select the project to tag the group.
- Click Force change with admin privilege.
Method two:
- Go to the Vault icon in the top left panel.
- Click the Groups card on the right panel.
- Click the group to open the group overlay.
- In the new window, click the Change project section in the left panel.
- In the pop-up, tick Use my permission to override rules, re-tag resources with any visible project, regardless of current project relations.
- Select the project to tag the group.
- Click Force change with admin privilege.
Remove Project from a Group
Method one:
- Go to the Vault icon in the top left panel.
- Click the Groups card on the right panel.
- Click the Open Full Menu button next to the group whose project you wish to change.
- Select Change project.
- In the pop-up, select No project (unlocked).
- Click Declassify.
Method two:
- Go to the Vault icon in the top left panel.
- Click the Groups card on the right panel.
- Click the group to open the group overlay.
- In the new window, click the Change project section in the left panel.
- In the pop-up, select No project (unlocked).
- Click Declassify.
Download Group Content
bulk-action
- Go to the Vault icon in the top left panel.
- Click the Group Directories section on the left panel.
- Select the group file(s) or directory(ies) you wish to download.
- Click Download in the top center panel.
- In the prompt, preview the file and directory structure.
- Select the destination of your download.
- Click Download.
Downloading a group's contents removes the group's encryption. It is your responsibility to secure the files.
- You may be asked to enter your password when changing the download destination.
- You can set a default download destination for groups by clicking Set as default after making your selection.
Compute Disk Usage of a Group
bulk-action
- Go to the Vault icon in the top left panel.
- Click the Group Directories section on the left panel.
- Select the group(s) for which you want to compute the disk usage.
- Click the Open Full Menu button in the top center panel.
- Select Compute Disk Usage in the top center panel.
Delete a Group
- Go to the Vault icon in the top left panel.
- Click the Groups card on the right panel.
- Click the Open Full Menu button next to the group you want to delete.
- Select Delete.
- In the pop-up, click Yes to confirm.
You can only delete a group if you are the group owner. If you are a member, you can only leave the group.
Leave a Group
- Go to the Vault icon in the top left panel.
- Click the Groups card on the right panel.
- Click the Open Full Menu button next to the group you want to leave.
- Select Leave group.
- In the pop-up, click Yes to confirm.
You can only leave a group if you are a group member. If you are the owner, you can only delete the group.