User management

This plugin allows to manage rudder users and and add extended authorizations for them. Users also gain the possibility to have a personal API token with the same rights that they have themself.

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 to read given items

    • write can create/delete items

    • edit can modify existing items

    • all

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

← Scale out relay servers Vault →