​

Roles and permissions

Cosmos-Hub 2.0 sets permissions on each object of an organisation, from workspaces down to studies, analyses and snapshots. Permissions set on a workspace cover the objects inside it, and permissions set on a single study, analysis or snapshot cover only that object. Org admins hold every permission on every object, and workspace owners hold every permission on their own workspace. Every other user is a collaborator and holds only the permissions that an org admin or a workspace owner gives them. A User is any person that is part of a Cosmos-Hub organisation, who can perform actions on the workspaces and related objects depending on the permissions it was granted. A Group is a set of users who share the same set of permissions on a workspace and its related objects. User groups are useful to grant a set of users (e.g: members of the same lab, external visitors) permissions at once. New users and groups start without any permission.

​

Common Setups

​

Users and Groups

​

Managing Users and Groups across an Organisation

To see the users and groups of your organisation, click the Organisation icon at the bottom left of the interface, then open Users or Groups. The Users and Groups pages list every member and user groups of the current organisation and allow to manage them.

​

The user and group dashboard

Clicking on any User or Group in the list to access the User and Group Dashboard, which allows profile and activity auditing, and setting individual permissions etc for a individual user/group. Click a user in the Users list, or a group in the Groups list, to open its dashboard.

​

Inviting a new users to an organisation

To invite a user, click Invite User on the Users page, enter their Email Address, optionally tick under Assign Groups the groups they should be part of, and click Send Invitation.

​

Create a User Group

To create a group, click Create Group on the Groups page. Enter a Group Name and (optional) select Initial Users members of that group, and click Create Group. Note: not selecting any user will create a group with only the owner as member of that group. Once a group has been created, you will be prompted to set workspaces permissions for it. See Setting permissions for Users and Groups

​

Add users to a group

Click the group in the Groups table and add one or more users from its Overview tab. To add a single user to a group, you can also open the user and click Assign Group on their Overview tab.

​

Delete a user or a group

To delete a user or a Group, open their Overview tab, type their email address under Danger Zone exactly as shown, and click Delete User. To delete several users in one step, tick them in the Users table and delete them from there. To delete a group, open the group and delete it from its Overview tab.

​

Set permission overrides for a single user

Set specific permissions for a specific user (e.g: when they need access that differs from their groups, for example one extra permission on a study). On the Users page, click the user and open the Permissions tab, which lists their Permission Overrides, the permissions set directly on that user. Then select the workspace in the Object Browser and choose which permissions to change values under Set Permission. User permissions can be changed from the Permission Centre as well.

​

Permission Centre

The Permission Centre is the main control panel to define user and group permissions for all the workspaces and objects of a Cosmos-Hub 2.0 organisation. To access the Permission Centre, click the Organisation icon at the bottom left of the interface, then open ‘Permission Centre’.

• Object Browser lists the workspaces of the organisation. Select a workspace to see and manage who can access it.
• Principal lists the groups and users that have access to the selected workspace. Click Manage Access to add or remove groups and users.
• The permission panel shows the permissions of the selected group or user on the selected workspace and on the studies, analysis projects and snapshots inside it. Use the Set Permission dropdown to change a permission. For each permission, Effective shows the permission that currently applies, and Source shows where it comes from.

​

Setting permissions for an object

​

Update a single user or group permissions

Set permissions on a single user when they need access that differs from their groups, for example one extra permission on a study.

1. On the Users page, click the user.
2. Open the Permissions tab. The tab lists the Permission Overrides of the user, that is the permissions set directly for them.
3. In the Object Browser, select the object, then choose the values under Set Permission.

You can make the same change in the Permission Centre, by selecting the object and then the user under Users.

​

Organisation Administration

To update organisation details, click the Organisation icon at the bottom left of the interface, then open Organisation Administration. Note: this section is accessible to Organisation admins only. Organisation administrators can updated the logo, name or description.

​

Next steps