Skip to content

Users & Roles

DATAZONE Control features a role-based access control system. Users are assigned roles that define specific permissions for modules and functions.

Managing Users

Access user management via Settings > Users.

Creating a User

  1. Click Add User
  2. Enter the following information:
FieldDescription
UsernameUnique login name
Display NameName shown in the interface
EmailEmail address
PasswordInitial password
RolesAssign one or more roles

Editing a User

  1. Click on a user in the list
  2. Modify the desired fields
  3. Save the changes

Deactivating a User

Deactivated users can no longer log in but remain in the system (e.g., for audit purposes).

Managing Roles

Predefined Roles

RoleDescription
AdminFull access to all functions
OperatorManagement of hosts and execution of actions
ViewerRead-only access

Creating a Role

  1. Navigate to Settings > Roles
  2. Click Create Role
  3. Assign a name
  4. Assign permissions

Permissions

Permissions can be configured granularly per module and function:

Module Permissions

PermissionDescription
opnsense.viewView OPNsense module
opnsense.editEdit firewalls
opnsense.tunnelsCreate tunnels
opnsense.shellShell access
pve.viewView PVE module
pve.editEdit PVE hosts
pbs.viewView PBS module
linux.viewView Linux module
linux.editEdit Linux servers
windows.viewView Windows module
windows.editEdit Windows servers

Function Permissions

PermissionDescription
scripts.manageCreate and edit scripts
scripts.executeExecute scripts
reports.manageManage report templates
reports.generateGenerate reports
checks.manageManage health checks
groups.manageManage groups
settings.manageModify system settings
users.manageManage users and roles
audit.viewView audit log

Example Roles

Monitoring Team:

  • All *.view permissions
  • checks.manage
  • reports.generate

Network Admin:

  • opnsense.view, opnsense.edit, opnsense.tunnels, opnsense.shell
  • scripts.execute

Windows Admin:

  • windows.view, windows.edit, windows.tunnels, windows.shell
  • scripts.execute

Multi-Factor Authentication (MFA)

Enabling MFA

  1. Click on your username (top right)
  2. Select User Settings
  3. Click Enable MFA
  4. Scan the QR code with an authenticator app
  5. Enter the 6-digit code to confirm

Supported Apps

  • Google Authenticator
  • Microsoft Authenticator
  • Authy
  • Any TOTP-compatible app

Resetting MFA

As an administrator, you can reset MFA for other users:

  1. Open the user in the management panel
  2. Click Reset MFA
  3. The user can set up MFA again on their next login

Security Recommendation

Enable MFA for all users with administrative privileges. This protects against unauthorized access even if passwords are compromised.

DATAZONE Control Documentation