Role matching

The role matching feature manages the roles of imported users automatically.

DataForge uses existing Zabbix user roles when importing users. The name of the Zabbix role acts as an identifier to determine whether a corresponding role exists in DataForge. While role names may be identical, their permission sets do not necessarily match.

Role matching in DataForge can result in three outcomes:

  1. If a Zabbix role is explicitly matched with a DataForge role, the DataForge role is assigned.
  2. If a Zabbix role name exactly matches a DataForge role name, the corresponding DataForge role is assigned.
  3. If no match is found, the user defaults to the guest role in DataForge, which has minimal permissions.

Role matching rules can be viewed and edited by navigating to Administration > Zabbix servers, selecting a server, and opening Zabbix role matching. Rules apply only to the selected server.

roleMatching
Zabbix role matching

Adding role matches

To create a new role match, click New role match. This opens a dialog with two fields:

roleLink
Role match form
  • DataForge role: A role from the list of user roles created in DataForge.
  • Zabbix role: A role from those that are available on the Zabbix server.

Changing roles of imported Zabbix users

By default, roles are automatically assigned. If role matching is disabled after import, a role can be assigned manually.

To disable automatic role assignment, navigate to Imported Zabbix users and click the configuration button of a user. This opens the Zabbix user configuration:

zabbixUserSettings1
Configure Zabbix user form

Disabling Automatic role assignment makes manual role selection available. The dropdown displays all default and custom roles.

zabbixUserSettings2
Configure Zabbix user form: Manual role assignment