User Tools

Site Tools


KeexyBox - Manage users

For KeexyBox, a user is a person who can enter a login and password on the device he uses to connect it to the Internet. An Internet browser must be at least available on the device. A user can use the same credentials to connect multiples devices to the Internet. If you do not want to have entering a login and password to connect a device to the Internet go to this topic: Manage devices. Or since version 21.04.1, it is possible to disable the captive portal to prevent users from authenticating to access the Internet.

To manage users:

  1. Use your browser and connect to the KeexyBox Management Web interface.
  2. On left menu, go to Connection settings → Users.
  3. You will be redirected to the Users page.

Add a user

  1. Click on at the top of Users page.
  2. Click on Save.

Modify a user

  1. On the Users page, identify in the list the user you wish to edit.
  2. Click on Edit button.
  3. Click on Save.

Edit a user

Display nameThe user name to display.
EmailThe user Email address (optional).
LoginLogin to connect to the Internet.
PasswordLogin password (leave it blank if you do not want to change it in case of modification)
Confirm passwordConfirmation of login password (leave it blank if you do not want to change it)
ProfileSet the connection profile.
LanguageSelect the language of the user.
ExpirationDefine an expiration date for the account (Leave blank for no expiration).
EnableCheck this box to enable the user otherwise uncheck it.
AdminCheck this box if you want to grant privileges to user to manage KeexyBox.

Delete a user

  1. On the Users page, identify in the list the user you wish to delete.
  2. Click on delete button.
  3. You will get a message asking you to confirm the deletion. Answer yes.

Connected user will be disconnected and then deleted.

:!: Note that the default administrator account of KeexyBox cannot be deleted.

Export/Import users

KeexyBox allows you to export or import users from CSV files.

Exporting or Importing users can be useful in the following cases:

  • To backup the list of KeexyBox users.
  • To massively create users.
  • To make massive changes to users.
  • To import users to another KeexyBox.

Export users to CSV file

  1. Click on at the top of Users page.
  2. Save the file wherever you want on your device.

Import users from CSV file

You must first prepare a CSV file containing the list of users. We recommend that you export the list of KeexyBox's users in order to have a template for creating the import file.

The fields of the CSV file are described below.

usernameLogin for the Internet connection. If a login has the same name in KeexyBox, all settings will be overwritten with the values from the CSV file.
displaynameUsername name to display.
passwordThe password can be encrypted or in clear. If the length is less than 60, the password defined will be considered as clear and if it is equal to 60 as encrypted.
profilenameThe name of the profile. If the profile does not exist on KeexyBox, the user will be set to the default profile.
langThe language displayed on KeexyBox Web interface for the user. If the language is unknown by KeexyBox the default KeexyBox langage will be set.
enabled1 to enable the user, 0 or empty to disable the user.
admin1 to set the user as admin otherwise 0 or empty.

:!: Do not change the position of the fields.

When your file is ready:

  1. Click on at the top of Users page.
  2. On Select csv file click on Browse.
  3. Select the CSV file to import.
  4. Click on Save.

Bulk action on users

Bulk actions allows you to massively doing actions on users. On the Users page:

  1. Check boxes to the left of listed users.
  2. At the bottom of the page, on the selection menu (select action), choose one of the available actions.
  3. Click on Run to confirm the action.

The available actions are discribed below:

  • Disable: This action allows you to disable selected users.
  • Enable: This action allows you to enable selected users.
  • Change the profile: This action allows change the profile of selected users.
  • Delete: This action allows you to delete selected users.

About KeexyBox Project:

users_manage.txt · Last modified: 2021/05/04 13:31 by paul