Setting workspace permissions

Permissions can be set based on features using the Features tab. Edit workspace permissions using the Workspace Security dialog accessible from the Workspace Details tab. Access the dialog using the following steps in a workspace:

1. Click the Administration tab followed by Workspace Details.
2. Click Manage Workspace Permissions in the Relativity Utilities console to open the Workspace Security dialog.
   
3. Do any of the following:
   • Perform group management. Refer to Group Management for more information.
   • Modify the settings on the tabs as needed. Refer to the Features tab, Object Security tab, Tab Visibility tab, or Other Settings tab sections for specific information of each tab.
4. Click Revert All if you need to undo all your unsaved toggle key changes. The features will return to their original toggle key settings.
5. Click Review and Save after modifying settings.
6. Review the unsaved changes displayed on the Review Permissions Changes modal.
   
   • Features changes—lists the features that were changed and how they were changed. Changes at the granular level may affect the status of the feature setting, so review this information carefully.
   • Granular permissions changes—lists the changes made at the granular permissions level, including those resulting from feature changes or direct edits at the granular permission level.
7. Click Save to finalize the changes.

To add and remove groups, you must have the Edit Security permission set for the Workspace object and the Add and Delete permissions set for the Groups object (instance level security).

Group Management

The Group Management tab displays all groups added to a workspace. The following actions are available for groups added to a workspace other than System Admins:

• View Users—displays a list of users in a group.
• Edit Permissions—opens the Object Security tab for you to begin editing the workspace permissions for a group.
• Copy—opens a list of groups whose permission settings you can transfer to the group. Select a group and click Copy Permissions at the bottom of the list to complete the transfer.
  Copying permissions from one group to another will cause all permissions to be overwritten. This includes item level security permissions for the target group.
  
• Preview—preview currently applied security settings for a group. See Preview Security for more information.
• Add/Remove Groups—opens the Add/Remove Groups dialog on which you can search for and add or remove groups.
  • To add and remove groups, you must have the Edit Security permission set for the Workspace object and the Add and Delete permissions set for the Groups object (instance level security).
  • Relativity displays a warning message when a System Admin attempts to edit or copy permissions for any group in a client domain. This warning makes the System Admin aware that modifying permissions may have significant consequences. For example, changing permissions may allow client domain users to modify items outside their tenancy. The System Admin can click Manage Permissions to proceed with the update or Cancel to exit the pop-up window.

Add/Remove Groups

The Add/Remove Groups window displays the following lists:

• Available Groups—lists available groups in your Relativity environment not yet granted access to the workspace.
• Groups in Workspace—lists groups granted access to the workspace.
  
  

Adding groups to a workspace

To add one or more groups to a workspace, follow these steps:

If you are in a Workspace admin group, you must have the instance-level Edit permission to the Group object to add a group to a workspace.

1. Click the Administration tab followed by Workspace Details.
2. Click Manage Workspace Permissions.
3. Click Add/Remove Groups on the Group Management tab.
4. Select one or more groups from the Available Groups list in any order. Scroll the list or search for a specific group using the search bar.
5. Click Add.
6. Click Save.

Removing groups from a workspace

To remove one or more groups from a workspace, follow these steps:

1. Click the Administration tab followed by Workspace Details.
2. Click Manage Workspace Permissions.
3. Click Add/Remove Groups on the Group Management tab.
4. Select one or more groups from the Groups in Workspace list in any order. Scroll the list or search for a specific group using the search bar.
5. Click Remove.
6. Click Save.

Features tab

The Feature tab simplifies permission setup by reducing the number of steps needed. Instead of navigating through Object, Tab Visibility, or Admin tabs, you can enable a feature with a single action.

Each feature includes specific actions, which represent individual tasks users can perform within that feature. Granting access to actions lets you control permissions more precisely, allowing a group to perform certain tasks without providing full access to the entire feature.

A feature or action combines the required permissions drawn from the other three tabs. When you enable a feature, all associated permissions activate automatically. For an overview of features and actions, seeFeature permissions, Feature actions.

Considerations

Keep these factors in mind when setting Feature permissions:

• Granular permission settings on the Object Security, Tab Visibility, and Other Settings tabs are the primary source and propagate to features listed on the Features tab. Changes to these permissions from those tabs will also update in the corresponding features.

• Changing a specific permission under the Object Security, Tab Visibility, and Other Settings tab associated with an enabled feature will result in the feature being disabled.

• Disabling a feature on the Features tab disables its associated granular permissions for that feature. However, if a granular feature is part of another enabled feature, then it will remain enabled (blue check mark) on the disabled feature’s See Details panel.

• Disabling a feature revokes access to all granular permissions associated with the feature that are not currently granted as part of a different enabled feature. Therefore, enabling and then disabling a feature will not necessarily return the group to the state it was previously in. Be sure to examine the Review Permissions Changes dialog to confirm all permissions changes are as expected.

Using the Features tab

The Features tab displays a list of features currently available for the selected group in the workspace. Click the toggle key next to one or more features to enable or disable them. You can also do the following from here:

• Use the Search bar to locate a particular permission in the list.
• If available, click the list next to a specific feature to adjust the user role to configure for that feature. For example, Administrator, Reviewer, or User role.
• Click See Details to view the list of granular permissions associated with this feature and their settings. They are propagated from the Object Security, Tab Visibility, and Other Settings tabs. To collapse the details panel, click the double arrow button. The panel includes:
  • User role for the feature is reflected in the panel heading. For example, the heading of “User Import Unstructured Data” indicates the permissions listed are for the User role.
  • Ability to enable or disable the feature’s toggle key from here in addition to doing so from the main Features dialog.
  • Current state of each granular permission for the feature. A blue check mark indicates the selected group has permission to use this feature (enabled). A red circle with a slash indicates the selected group does not have permission to use it (disabled). The state permissions may change based on the toggle key setting.

Frequently asked questions

Granular permissions

Saving permissions for a group

In the Workspace Security dialog you can switch between the Object Security, Tab Visibility, and Other Settings tabs before saving modified security permissions for a selected group. If you modify security settings on any of these three tabs, and try to close the dialog or click the Group Management tab, Relativity prompts you with the following options:

• Save—saves all permissions changes and applies them to the selected group.
• Revert—discards all unsaved permissions changes and reverts to the group's last saved permissions.
• Cancel—cancels the attempted dialog close or tab change action.

After making security changes on the Object Security, Tab Visibility, and Other Settings tabs, click Save at any time to apply the selected permissions settings.