Sec/User Mgmt: Add or Edit Role Dialog

Document created by RSA Information Design and Development on Aug 29, 2018Last modified by RSA Information Design and Development on Jan 23, 2019
Version 4Show Document
  • View in full screen mode

This topic introduces the Add Role and Edit Role dialogs accessible from the Admin > Security view > Roles tab.

In the Add Role and Edit Role dialogs, you can add or edit a role and the permissions assigned to it. You can also specify the query-handling attributes for role members to lock down the information that they can retrieve. The structure of these dialogs is the same. The only difference is that you either add a new role or modify an existing role.

When you change permissions for a role, the change is immediately applied to users who are assigned the particular role after the role is saved.

What do you want to do?


Quick Look

To access this view:

  1. In NetWitness Platform, go to ADMIN > Security.
    The Security view opens to the Users tab by default.
  2. Click the Roles tab.
  3. Do one of the following:
    • In the action bar, click Add icon.
      The Add Role dialog is displayed.
    • Select a role and in the action bar, click Edit icon.
      The Edit Role dialog is displayed.
      Edit role dialog

The Add Role and Edit Role dialogs include three sections: Role Info, Attributes, and Permissions.

Role Info

This is the information in the Role Info section.

Name The name of the user role.
Description An optional description of the user role.


This is the information in the Attributes section. Step 3. Verify Query and Session Attributes per Role provides more information.

Core Query Timeout (Optional) Specifies the maximum number of minutes that a user can run a query. The default value is 5 minutes. This timeout only applies to queries performed from Investigation. If this value is set, it must be zero (0) or greater. A value of zero represents no timeout.
Core Session Threshold Controls how the service scans meta values to determine session counts. This value must be zero (0) or greater. If this value is greater than zero, a query optimization will extrapolate the total session counts that exceed the threshold. When the meta value returned by the query reaches the threshold, the system will:
  • Stop its determination of the session count
  • Show the threshold and percentage of query time used to reach the threshold
The default value is 100000. The limit you specify here overrides the Max Session Export value defined in the INVESTIGATE view settings. 
Core Query Prefix (Optional) Filters query results to restrict what the role members see. By default, this is blank. For example, the 'service' = 80 query prefix prepends to any queries run by the user and the user can only access meta of HTTP sessions.


This is the information in the Permissions section. Role Permissions describes the permissions.

There are fifteen default tabs, one for each module:  Administration, Admin-server, Alerting, Config-server, Incidents, Investigation, Investigation-server, Integration-server, Live, Malware, Orchestration-server, Reports, Response-server, Security-server and Dashboard. Additional tabs may be available based on the installation. Each tab lists the permissions for a module.
List of all permissions for the module.
Checkbox that indicates if a module permission is assigned to the role.
Save Saves the role with the selected permissions assigned to it.
Cancel Cancels any work and closes the dialog.
Previous Topic:Roles Tab
Next Topic:Login Banner Tab
You are here
Table of Contents > References > Add or Edit Role Dialog