Skip to main content
Version: 5.6

User Roles

Starting with version 5.2.0, OPC Router 5 supports user authorization via user roles.

There are three roles:

  • Observer – can view information
  • Editor – can edit projects and runtime functions
  • Admin – has full access to all settings and administrative functions

Important for Existing Installations

note

Users from older versions are automatically assigned the Admin role.

Windows Login and Windows Groups

When users log in to the Management interface via Windows authentication, their role is determined by the associated Windows group.

There are three Windows groups for this purpose1:

  • OPC-Router-5-AdministratorsAdmin role
  • OPC-Router-5-EditorsEditor role
  • OPC-Router-5-ObserversObserver role

This means:

  • A user does not necessarily have to be created directly in OPC Router.
  • It is sufficient to assign the user to the appropriate group in Windows.
  • Upon login, OPC Router automatically assigns the appropriate role.

Which group should I use?

For easy reference:

  • Observer: for users who are supposed to view the runtime status and download log files, but are not allowed to make any changes
  • Editor: for users who are allowed to edit connections and projects and publish them to the runtime
  • Admin: for users who are also supposed to manage system settings, users, certificates, licenses, and plug-ins

Notes on role assignment

If a user is a member of multiple OPCRouter Windows groups, OPC Router automatically assigns the highest applicable role. The roles are prioritized as follows: Admin, Editor, Observer.

Example: If a user is a member of both OPCRouter-Observer and OPCRouter-Editors, then they are assigned the Editor role.

Permissions Overview

PermissionObserverEditorAdmin
View runtime statustruetruetrue
Manage connectionsfalsetruetrue
Manage connection templatesfalsetruetrue
Manage instances of connection templatesfalsetruetrue
Manage plug-insfalsefalsetrue
Download log filestruetruetrue
Generate diagnostic reportsfalsetruetrue
Publish to the runtimefalsetruetrue
Control the runtime servicefalsetruetrue
Import projectsfalsefalsetrue
Export projectsfalsetruetrue
Manage general optionsfalsefalsetrue
Manage licensefalsefalsetrue
Manage database optionsfalsefalsetrue
Manage redundancy settingsfalsefalsetrue
Manage store-and-forwardfalsefalsetrue
Manage certificatesfalsefalsetrue
Manage Dynamic Instances APIfalsefalsetrue
Manage dependency storefalsefalsetrue
Manage notificationsfalsefalsetrue
Manage usersfalsefalsetrue
Use expert modefalsefalsetrue

Recommendation for Administrators

Assign roles using the appropriate Windows groups whenever possible. This is easier to manage than maintaining individual users separately.

Typical procedure:

  1. Create users in Windows or use them from Active Directory
  2. Add users to the appropriate OPCRouter group
  3. Have users log in to the OPC Router
  4. The role is automatically applied

This allows users to obtain the appropriate access easily and securely.


1 The separate Windows groups OPC-Router-5-Administrators, OPC-Router-5-Editors, and OPC-Router-5-Observers are only available starting with Version 5.4 MR 19, Version 5.5 MR 07, and Version 5.6 MR 01. In older versions, this division is not yet available; only the Windows group OPC-Router-5-Administrators exists.