Configuration
  • 6 Minutes to read
  • Dark
    Light
  • PDF

Configuration

  • Dark
    Light
  • PDF

Article summary

Setting up the default access rules for matters

Default matter access can be configured for organization users and portal users. Agility Blue distinguishes these users based on the roles that are applied to each user. Users that have the organization user role are categorized as organization users whereas users that only have the portal user role are categorized as portal users. Portal users are users that have access to the request portal. You can ignore settings specific to portal users If your organization doesn't license the request portal.

Default access to matters is initially granted for all user roles and all matters have default access applied unless explicitly changed at the matter level. You can change the default access for users that have either the organization user role or portal user role by navigating to the workspace settings page, clicking on the permissions section (2nd tab on the left that looks uses a lock icon), and then selecting the "Roles" tab.

The two roles can be configured to either allow or deny access to matters by default. Changing a role from allow to deny would prevent users in that role from seeing or selecting any matter by default. You would then need to update the security access state of specific matters to grant access.

Configuring individual matter security

After determining default matter access for the organization and portal user roles, you can then change the access state for specific matters by navigating to a matter's details page, clicking on the settings section (sliders icon tab towards the end on the left), and then selecting the "Security" tab.

Matters will be configured with "Default Access" when created. This means that the default access for organization and portal user roles will be applied, which can be seen in the table showing each role. To change the access state for this matter, click on the access state drop down and select between the following 7 options, depending on the level of granularity needed:

  • Default Access
    Default access for organization users and portal users can be configured on the settings page under the permissions section roles tab as previously outlined. Users with the organization administrator role will have access regardless of this setting. A table of read-only entries will indicate what the current default access is for each role.

  • Everyone
    All users have access to this matter. A table of read-only entries will list out the users with access.

  • All Organization Admins

    Users with the organization administrator role are allowed to access this matter. Users without this role will not have access to this matter. A table of read-only entries will list out the users with access.

  • All Organization Users
    Users with the organization administrator or organization user roles are allowed to access this matter. Users that only have the portal user role will not have access to this matter. A table of read-only entries will list out the users with access.

  • Select Portal Users
    In addition to users with the organization administrator and organization user roles, you can select and add portal users that are allowed to see and select this matter while creating requests from the request portal. Portal users not listed will not have access to this matter. A table of read-only entries will list out the organization users with access. A button will be available to add portal users. Portal users added to the list will be granted access to select this matter while creating requests from the portal and can be removed from the access table at any time.

  • Allow List
    An explicit list of users/teams that are allowed to access this matter (opt-in). Users or teams not listed will not have access to this matter. Users with the organization administrator role will have access regardless of this setting. A button will be available to add users or teams and a table of entries will list out the users with access.

  • Deny List
    An explicit list of users/teams that are not allowed to access this matter (opt-out). Users or teams not listed will have access to this matter. Users with the Organization administrator role will have access regardless of this setting. A button will be available to add users or teams and a table of entries will list out the users without access.

Below is an example of a matter with the access state set to “Allow List”

In this example, default access is no longer applied to the matter and only the users or teams that are added using the "Add Users/Teams" button are allowed to see this matter. To the left of the button, you can use the trash icon to remove all entries or refresh the entries using the resync icon. If a team is added, all users within that team will be considered for access. You may see a green badge with the letter "P" next to a user's name in the list of entries like in the example above. This indicates that the user is a portal-only user and only has access to the request portal. Each entry that was added through the "Add Users/Teams" button can also be individually removed using the trash icon to the right of each entry. An entry with a blue border on the left indicates that the entry was added and not generated.

Configuring security for multiple matters

Access states can be configured across multiple matters by using the multi-actions button on the matters grid. Enter multi-edit mode on the grid by clicking on the multi-edit toggle button at the top left of the grid. Select the matters that you would like to apply security to and then click on the the lighting bolt icon on the grid toolbar to bring up the multi-action window.

Choose from the dropdown list one of the following available actions:

  • Change Access State…
    You will be presented with a dropdown list of the 7 available access states that are listed in the previous section. Selecting one of these options will change the access state of your selected matters to the option you choose.

  • Apply Access State Users/Teams (Merge Existing)…
    You will be presented with a multi-selection window where the users you select will be merged with the existing user lists within each selected matter. The lists are only effective for matters that have "Select Portal Users", "Allow List", or "Deny List" access states applied.

  • Apply Access State Users/Teams (Replace Existing)…
    You will be presented with a multi-selection window where the users you select will replace any users that were previously added within each selected matter. The lists are only effective for matters that have "Select Portal Users", "Allow List", or "Deny List" access states applied.

  • Remove All Access State Users/Teams
    Choosing this action will clear out any users that were previously added to any user lists. The lists are only effective for matters that have "Select Portal Users", "Allow List", or "Deny List" access states applied.

Notice

Changing the access state to an option that supports a managed list of users will require two steps. First, you would change the access state, then you would need to reselect the matters you just changed and apply access to the list of users you would like to access those matters.

Viewing and filtering matters for access

The matters grid provides a field named "Access State" that allows you to filter for matters that have specific states, default access only, or non-default access. Use the filter menu on the column to choose which filter you would like to apply.


What's Next