On this page you can find an explanation of the domains feature within wvr.io and how users can get different access to spaces within an environment.
Domains were introduced in version 1.2.0
What are domains?
Domains are groups of users that are needed to gain access to a space within an environment. The feature is replacing organisations and individual access to a space and a domain can be assigned to one or more spaces.
Users that are logged in but do not belong to a domain will only be able to view, but not edit, public spaces, similar to users that are not logged in.
Users belonging to a domain will always have read access to any space associated with the domain and will be able to view the space(s), excluding services and macros if present, but not edit the space(s).
Users within a domain can have write access to one or more spaces and will be able to view and edit anything within these spaces.
Write access to a space can be changed on an individual level or on a group level, as long as the user belongs to a domain associated with the space.
How to set up a domain:
Setting up a domain will require a user with full ACL permissions to the environment. These users will have access to the 'Users and Spaces' menu located on the left taskbar. In this menu the 'Domains' menu can be found.
From the domains menu, existing domains can be edited or a new domain can be made. If no domain is present on the environment, press the 'Create a domain' button, here you can give it a name and save it.
Once a domain is saved it cannot be deleted, it can however be deactivated, which will result in the spaces within that domain becoming inaccessible for the users belonging to that domain.
Activating and deactivating can be done by a user with full ACL permissions.
How to give users access to spaces via a domain:
From the domains menu described above: If a domain is present, you can click on the domain and assign members under the 'Members' tab or assign spaces under the 'Spaces' tab.
Members that are added to a domain will then have read access to any space that is present in the 'Spaces' tab for that domain.
To set write access for a user you will need to go to the 'All spaces' menu located in the 'Users and Spaces' menu, locate the space you want to give a user access to and click on it.
In this menu the domain the user belongs to should be present on the 'Domains' tab.
User Access will show all users that have been granted access to the space via a domain or via a User Group.
Individual access can be changed on the 'User Access' tab where the default will be set to Read but it can be switched to Write to grant a user Write access to the space.
Group Access can grant an entire User Group write access by changing the switch for a group from Read to Write. These groups can be set up in the 'User groups' menu in the 'Users and Spaces' menu.
If a user belongs to a user group, but not to a domain that is assigned to the space, the user will still show up in the list on the 'User Access' tab. However this user will not be able to access the space, as membership to a domain is needed to see a space.
Note that individual access will overwrite any group access the user may also have. (i.e. a user belonging to a read-only group may be granted write access to a certain space on an individual basis).
Quick Guide:
- Domains are needed in order to see spaces in the workbench
- Domains can be set up by users with ACL rights
- Multiple Domains can be present on an environment
- Users can be added to a domain through the Domains submenu of Users and Spaces, in the Members tab
- Spaces can be added to a domain through the Domains submenu of Users and Spaces, in the Spaces tab
- Domains do not control read and write access of a user, these permissions are explained here