Utility "wb-homeui-users"

From Wiren Board
This is the approved revision of this page, as well as being the most recent.
Other languages:


Purpose

wb-homeui-users is a console utility for managing users of the web interface on Wiren Board controllers.

Is used for:

  • creating and deleting user accounts;
  • changing passwords and user roles;
  • obtaining a list of current users.

The utility is useful if you:

  • forgot the administrator password;
  • want to grant a colleague access to the web interface;
  • want to restrict the permissions of a specific user.

Usage examples

Displaying Help

wb-homeui-users -h

Viewing the User List

wb-homeui-users list

Adding a User

wb-homeui-users add <username> <password> <admin|user|operator>

Where:

  • <username> – username;
  • <password> – password;
  • <admin|user|operator> – role (see below).

Example:

wb-homeui-users add ivan mysecurepass1 admin

Modifying a User

wb-homeui-users modify <username> [--password <new_password>] [--name <new_name>] [--type admin|user|operator]

Changing the password:

wb-homeui-users modify ivan --password newpass2025

Changing the role:

wb-homeui-users modify ivan --type user

Removing a User

wb-homeui-users remove <username>

Example:

wb-homeui-users remove ivan

Deleting the last administrator is not allowed. The message Can't delete the last admin will be displayed.

User Roles

A role is assigned when creating or modifying a user:

  • admin - full access, including system settings;
  • user - view and control only, without the ability to modify the configuration;
  • operator - device control, but without access to system settings.

Common Errors

  • attempting to delete the last administrator:
Can't delete the last admin
  • incorrect argument order:
invalid choice: 'password' (choose from 'admin', 'user', 'operator')