Add and edit roles with Splunk Web
When you create users, you can assign roles that determine the level of access that users have to Splunk Enterprise, and the tasks that they can perform. Splunk Enterprise comes with a set of default roles that you can use. You can also create your own.
For information about roles and how capabilities and permissions are inherited, see About role-based user access.
Custom roles that inherit from Admin or Power users do not automatically inherit management access. For information about granting management access to custom roles, see Add access controls to custom roles.
Add or edit a role
Create or edit roles for your Splunk platform implementation on the Roles page in Settings.
- Click Settings > Access Controls.
- Click Access controls page click Roles.
- Click New or select and edit an existing role. Role names must use lowercase characters only. They cannot contain spaces, colons, or forward slashes.
- In the Restrict search terms section, you can restrict the scope of the searches that users with the role can run. You can restrict the search terms they can use, set limits on search time, and set both user-level and role-level concurrent search limits.
Search term restrictions offer limited security. A user can override some search term restrictions if they create a calculated field that references a field name listed here as a restricted term.
- In the Inheritance section, identify other roles that your role can inherit properties and capabilities from. A user assigned to multiple roles inherits properties from the role with the broadest permissions. See Role inheritance in the About role-based user access topic for more information.
- In the Capabilities section, choose any individual capabilities you want to provide to this role. See About defining roles with capabilities for more information.
- In Indexes searched by default, specify the indexes that this role will automatically search if no index is specified in the search. You can specify both event and metric indexes. If a user with the role runs an event search without a specified index, the search pulls events from the default event indexes assigned to the role. If a user with the role runs a metrics search without a specified index, the search pulls events from the default metrics indexes assigned to the role.
- In Indexes, select event and metric indexes the user is allowed to search. If you add at least one index, a user with this role will only be able to conduct searches on the index or indexes selected. If you do not specify any indexes at all, the user assigned to the role is able to search all indexes.
- Click Save.
Updates to the search term restrictions for a role do not take effect until you restart your Splunk platform implementation. If you do not restart Splunk, your Splunk platform will not enforce your search term restriction updates.
For more information about restarting Splunk, see Start and Stop Splunk Enterprise in the Admin Manual.
Search filter format
The "Restrict search terms" field can include any of the following search terms:
- search fields
When you specify search term restrictions for event data, use the
key::value syntax, when possible, to restrict search terms to indexed fields. Normal field values can be overwritten with user knowledge objects. The
key::value syntax only applies to indexed fields.
You can use wildcards. Use
OR to allow multiple terms, or
AND to make the filter more restrictive.
The search terms cannot include:
- saved searches
- time operators
- regular expressions
- any fields or modifiers that you can override from the Splunk Web search bar
Special syntax rules for search filters of metric data
Search filters that limit user access to metric data do not follow the same rules as search filters for event data.
Search filters for metric data must use the
key=value comparison syntax. Metrics search cannot utilize the
Search filters for metric data can filter dimensions but not metric names. For example, you can set up search filters for dimensions like
server=athens but not metric names like
Add and edit users
Add and edit roles with authorize.conf
This documentation applies to the following versions of Splunk® Enterprise: 7.1.0, 7.1.1, 7.1.2, 7.1.3, 7.1.4, 7.1.5, 7.1.6, 7.1.7, 7.1.8, 7.1.9, 7.2.0, 7.2.1, 7.2.2, 7.2.3, 7.2.4, 7.2.5, 7.2.6, 7.2.7, 7.2.8, 7.2.9