Authorization management

For every user you can define an access level, allowing it to access different pages or to perform different actions depending on its level.

You can also build custom roles with whatever permission you want, using a type and a level as specified below.

In the xml file, the role attribute is a list of permissions/roles, separated by a comma. Each one adds permissions to the user. If one is wrong, or not correctly spelled, the user is set to the lowest rights (NoRights), having access only to the dashboard and nothing else.

Pre-defined roles


Access level


All authorizations granted, can access and modify everything


Only access to administration part of rudder, can do everything within it.


Can access and modify everything but the administration part


Can only access and act on configuration section


Can access to every read only part, can perform no action


Access to information about nodes, can see their inventory, but can’t act on them


Access to information about rules, but can’t modify them

For each user you can define more than one role, each role adding its authorization to the user.

Example: "rule_only,administration_only" will only give access to the "Administration" tab as well as the Rules.

Custom roles

You can set a custom set of permissions instead of a pre-defined role.

A permission is composed of a type and a level:

  • Type: Indicates what kind of data will be displayed and/or can be set/updated by the user

    • "configuration", "rule", "directive", "technique", "node", "group", "administration", "deployment".
  • Level: Access level to be granted on the related type

    • "read", "write", "edit", "all" (Can read, write, and edit)

Depending on that value(s) you give, the user will have access to different pages and action in Rudder.

Usage example:

  • configuration_read → Will give read access to the configuration (Rule management, Directives and Parameters)
  • rule_write, node_read → Will give read and write access to the Rules and read access to the Nodes