Setting workspace permissions

Permissions can be set based on the features using the Features tab or by using the granular settings on the Object Security tab, Tab Visibility tab, or Other Settings 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. Manage workspace permissions highlighted in Relativity Utilities options list
  4. Do any of the following:
  1. Click Revert All if you need to undo all your unsaved toggle key changes. The features will return to their original toggle key settings.
  2. Click Review and Save after modifying settings.
  3. Review the unsaved changes displayed on the Review Permissions Changes modal.

Review Permissions Changes with features changes and granular permissions changes listed

  • 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.
  1. Click Save to finalize the changes.

Note: 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.
Note: Copying permissions from one group to another will cause all permissions to be overwritten. This includes item level security permissions for the target group.
    Copy group permissions
  • 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.

Note: 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).

    Note: 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.

    Note: For more scenario examples, see Permissions scenarios

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.
    Selecting multiple groups to add to a workspace

Adding groups to a workspace

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

Note: 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.

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.

Features tab

You can set permissions based on features in the system using the Features tab. Rather than managing specific permissions by navigating through the three tabs (Object Security, Tab Visibility, Other Settings) individually, permissions can be set based on features in the system using the Features tab. Examples of features include Preservation, Production, Imaging, and Configure Doc Review.

Each feature listed consists of a collection of the required permissions for that feature from the other three tabs. Once you enable a feature, its associated permissions are automatically enabled.

Note: Adjusting the settings for individual permissions requires accessing their respective source tabs (Object Security, Tab Visibility, Other Settings). Editing them from the Features tab is not possible.

Setting permissions at the feature level is intuitive and simplifies the management of permissions within Relativity. With one click, the necessary permissions can be enabled or disabled for a particular feature.

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:

Features tab showing See Details panel for Imaging

  • 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 Collapse double arrow icon 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 Blue check mark indicating enabled indicates the selected group has permission to use this feature (enabled). A red circle Red circle with slash through it indicating disabled 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

Object Security tab

Use the Object Security tab to manage the following object-level permissions for a selected group:

Object security tab

  • None Object - access denial—denies users access to the object.
  • View Object permission - view—view the object. This is the lowest level object permission.
  • Edit Object permission - edit, view object—edit and view the object.
  • Delete Object permission - Delete, edit, view—delete, edit, and view the object.
  • Add Object permission - Add—add new objects. This icon turns blue when the setting is unsaved; once you click Save, the blue icon becomes grey. This icon turns green when you give users this permission both when the setting is unsaved and saved.
  • Edit Security Object permission - edit security of objects—grants users the ability to edit the security of objects. This icon turns blue if you click twice indicating a not applicable status.

See Object list for a list of securable objects.

Assigning object-level permissions

To assign object-level security permissions to a group:

  1. Click the Administration tab followed by Workspace Details.
  2. Click Manage Workspace Permissions in the Relativity Utilities console.
  3. Click Edit Permissions for a group on the Group Management tab. Or, click Object Security and select a group from the Current Group drop-down menu.
  4. Click the applicable object security permission(s) you want to apply to the selected group. Icons for selected security permissions appear in color, and names of objects for which you changed security permissions appear in italic typeface until you save the modified permissions.
  5. Click Save.

Assigning mass permissions to a single group

To update multiple permissions to a single group:

  1. Click the applicable object security permissions
  2. Click the down arrow on the menu below.
  3. Select the appropriate permission type.
  4. Click Apply.

Denying object access

To deny a group any access to an object, click the Deny object access icon icon. After setting a group's permission level to None, the icon appears in color Active Deny object permissions set icon.

Tab Visibility tab

The Tab Visibility tab lists all parent and child tabs in a workspace. Combine object-level permissions and tab visibility to give users the tools they need to complete their tasks.

To grant access to workspace tabs, select all tabs you want visible for a selected group. For a complete list of tabs, see Tab Visibility.

Tab visibility tab

Selecting parent and child tabs

Indented tab names are child tabs of a parent tab. The following example shows the parent tab of Processing and its child tabs. To select a parent tab and all child tabs, click Select All (#) for the parent tab. The link changes to "Deselect all (#)", which clears all check marks.

Tab visibility

When you select at least one child tab, the related parent tab is automatically selected. If you only want the child tab selected, click the parent tab to clear its selection.

Other Settings tab

The Other Settings tab lets you control browser visibility and access to mass operations and admin operations for a group in a workspace. For a complete list of admin operations, see Workspace security. To enable these settings for a group, select the desired options.

Other Settings tab