Table of Contents
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:
- Use your browser and connect to the KeexyBox Management Web interface.
- On left menu, go to
Connection settings → Users
. - You will be redirected to the
Users
page.
Add a user
- Click on at the top of
Users
page. - Click on
Save
.
Modify a user
- On the
Users
page, identify in the list the user you wish to edit. - Click on
Edit
button. - Click on
Save
.
Edit a user
Field | Description |
---|---|
Display name | The user name to display. |
The user Email address (optional). | |
Login | Login to connect to the Internet. |
Password | Login password (leave it blank if you do not want to change it in case of modification) |
Confirm password | Confirmation of login password (leave it blank if you do not want to change it) |
Profile | Set the connection profile. |
Language | Select the language of the user. |
Expiration | Define an expiration date for the account (Leave blank for no expiration). |
Enable | Check this box to enable the user otherwise uncheck it. |
Admin | Check this box if you want to grant privileges to user to manage KeexyBox. |
Delete a user
- On the
Users
page, identify in the list the user you wish to delete. - Click on
delete
button. - 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
- Click on at the top of
Users
page. - 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.
Field | Description |
---|---|
username | Login 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. |
displayname | Username name to display. |
password | The 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. |
profilename | The name of the profile. If the profile does not exist on KeexyBox, the user will be set to the default profile. |
lang | The language displayed on KeexyBox Web interface for the user. If the language is unknown by KeexyBox the default KeexyBox langage will be set. |
enabled | 1 to enable the user, 0 or empty to disable the user. |
admin | 1 to set the user as admin otherwise 0 or empty. |
Do not change the position of the fields.
When your file is ready:
- Click on at the top of
Users
page. - On
Select csv file
click onBrowse
. - Select the CSV file to import.
- Click on
Save
.
Bulk action on users
Bulk actions allows you to massively doing actions on users. On the Users
page:
- Check boxes to the left of listed users.
- At the bottom of the page, on the selection menu
(select action)
, choose one of the available actions. - 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: