The Hotspot Administration Menubar¶
This section describes the core component of the hotspot and includes pages that explain how to manage accounts, tickets and ticket rates, to create reports, and to configure the Hotspot. Although this graphic interface shares the design with the other modules, it contains an entirely new menu structure: Its complexity and the countless configuration options it offers require that a different layout be employed. The choice was to consider the hotspot as an independent module of the Endian UTM Appliance and therefore to replace the standard menubar, common to all other main sections of the Endian UTM Appliance, with a new one that consist of two parts, as shown in the figure above. The upper part does not change across the various parts of the Administration Interface and contains the ‘proper’ menu, while the lower part is a sub menu, that changes depending on which section of the Administration Interface is chosen.
Each of the four main sections allows the management of one hotspot’s component:
Accounts - Create, manage, import, and export user accounts.
Tickets - Define rates and generate tickets.
Reports - Consult the various balance, connection, and transaction logs.
Settings - Change the appearance of the web interface, set up SmartConnect™, Social accounts, enable the API, and configure all the functionalities.
On the far right, the Main Menu allows to go back to the default Dashboard and menubar.
This section of the Hotspot’s Administration Interface contains four sub-menu items, List, Import from CSV, Export as CSV, and Account Generator, that allow to create, delete, and manage the clients of the hotspot.
This page shows by default a list of the available user accounts with some information, namely Username/MAC Address, Name (The user’s full name, Enabled (the status of the account), Creation Date, and Valid until.
A few options help customise the view:
Users can be sorted by any of the fields mentioned above, except by their status.
Sort the list in ascending or descending order.
Hide from the list the disabled users, i.e., users that exists but that can not access the hotspot.
Searching for accounts is also possible, with pagination available for huge result sets.
Note
Users mentioned in this section are intended as user of the hotspot as clients who can access and browse the Internet. There are, however, two other types of users, namely Administrators and Account Editors, whose abilities and duties are described in section Hotspot User.
Several Actions are available on each account and are shown along each account on the right-hand side of the table:
assigned to it
Balance. To show the balance of the account
Connections. To show all the connections of the account.
Delete. Delete the user account.
and password) of the account. This action is not available for MAC-based account.
Note
The welcome message can be customised in the hotspot templates ().
The actions of showing the balance and connection, along with options for their management, are described under the Reports section, while the accounts’ administration (i.e., user and ticket management) composes the remainder of this section.
A new account can be created either by specifying a username and a password, or by providing the MAC address. Both actions can be carried out by clicking on the appropriate link above the accounts’ table.
The data associated with each account is divided in three types: Login Information, Account Information, and Tickets. Login information slightly differ in the two types of account, while Account Information and Tickets are exactly the same.
A click on Add Account allows the creation of a new account that requires a username and a password be. Some settings can be modified from their default values - see section Settings, which are: Expiry date (‘valid until’), whether the account is active or not, the language, and the bandwidth limit in kb/s. The Language can be chosen among those activated in .
Click on Add MAC-based Account to create a MAC-based account, which is therefore tied to a device and does not require a username and password. The remaining settings are the same as before, but MAC-based addresses can also be given a static IP address.
To each account, the following data can be associated:
This box contains the information related to the newly created account and necessary to access and use the hotspot.
Warning
Bear in mind that changing some of the account’s existing login information like the username, will cause a new account to be created.
The username associated to the account. If left blank, then a random username is generated.
The password for the new account, that can conveniently be auto-generated by the system by leaving the field blank.
Note
The password will only appear when printing the message that will be handed to the user with her credentials to access the hotspot.
The MAC address used to identify the account. Available for MAC-based accounts only.
The date when the account expires. The default value of one year, or 365 days, can be changed under Settings. To change the value for the current account, either provide the new date in the form DD.MM.YYYY or click on the … button and select the new date from the calendar pop-up.
When the checkbox is ticked, the account is active and can access the hotspot.
Choose from the drop-down menu the language in which the user will see all the hotspot’s messages.
Tick the checkbox to limit the bandwidth for the account. Two new fields allow to set both upload and download limits for the account, in KB/s. If left empty, global settings are used, if set.
If the checkbox is ticked, the user can take advantage of the Hotspot’s SmartLogin functionality. This option is not available for MAC-based accounts.
This option appears only if SmartLogin has been enabled. It is the time in days that the cookie used by smartlogin will reside on the client.
This option is only available for MAC-based accounts, which can be associated to a static IP address, specified here.
This box contains all the personal information related to the owner of the account.
The person’s title (e.g., Mrs., Dr.).
The user’s first name.
The user’s last name.
The street in which the user lives.
The ZIP code of the user’s hometown.
The city or town the user comes from.
The country the user comes from, that shall be chosen from the drop-down menu.
The E-mail address associated with the account. E-mail addresses can be changed in the account editor with no limitation.
Note
An already registered e-mail address can not be used for a new SmartConnect™ account.
The phone number associated with the account. The country code can be chosen from the drop-down menu on the left-hand side and the number must be written in the textbox on the right-hand side.
The user’s birthday.
The city or town in which the user was born.
The type of document that has been used to identify the user. Four types of documents are available from the drop-down menu: Birth Certificate, Identity Card, Passport, and Drivers License.
The ID of the document that has been used to identify the user.
Note
In some countries collecting documents may be mandatory to access public hotspots.
The issuer of the document (e.g., the City of New York).
The gender of the user. Four values are available: unknown, male, female, and other.
New in version 5.0.
The company the user belongs to.
New in version 5.0.
The job title of the user.
New in version 5.0.
An additional description for the account.
This box allows to see and manage the tickets associated with the current account and shows the following options:
The drop-down menu shows the available ticket rates and if they are time- of traffic-based.
Note
It is not possible to mix time- and traffic based tickets, hence if a user has already one or more time based ticket, no traffic based ticket can be added, and vice-versa.
Once chosen one available ticket rate, this option will appear and allows to customise the ticket validity. The available values are the same defined during the Ticket rates creation and will override the ticket’s default value (shown by the textbox and the drop down-menu underneath).
Once the ticket has been chosen, it can be associated to the current account by clicking this button.
Note
When editing an existing account it is also possible to print a welcome message containing also the credentials by clicking on the Print button: This is the same action that can be carried out from the list of the accounts.
At the bottom of the box, a small table shows all the tickets associated with the account with a couple of information for each of them. If a ticket is still valid, it can be deleted, but if it has expired, it remains there as it is already stored in the accounting for the account (see Reports for more info about balance and accounting).
If the chosen ticket is a cyclic ticket, a small form is displayed instead of the Validity drop-down menu, with the following options.
The day on which the first cycle of the ticket starts. If the ticket period is Monthly, it can only be chosen the first month of validity. For tickets with monthly cycle, indeed the start of the period is the first day of the month, while the end is the last day of the month.
The day on which the first cycle of the ticket ends. If the ticket period is Monthly, only the last month of validity can be chosen.
Below these otpions, a variable message shows the total number of cycles of the tickets, the price per cycle, and calculates the total price of the ticket. Like in the case of the normal tickets, a table maintains the list of the cyclic tickets associated with the account. For the sake of clarity, this table is kept separated from the other one.
When importing the account names from a CSV file, the filename is not important (exported files have peculiar names, see next section), but it needs a fixed format of the fields. The follow options are available:
Click on the Browse… button to select the CSV file to upload. The file must be in plain text, so ZIP archives, GPG encrypted files, and the like are not accepted.
The character used as delimiter, which is usually a comma , or a semicolon ;. If not provided, the Endian UTM Appliance will try to guess which is the correct character.
Hint
The Endian UTM Appliance uses commas to separate the fields in exported files.
Tick the checkbox to let the Endian UTM Appliance know that the first line of the CSV file contains the header of the columns and ignore it when importing it.
Note
Files that the Endian UTM Appliance fails to recognise as CSV files will be rejected with the message The given file does not seem to be in CSV format.
Click on this button to import the CSV file.
After the accounts have been imported, the page will be replaced by a new one, containing some columns (depending on how many accounts have been found in the file). The first column contains all the available fields, while the second all the fields that have been recognised in the CSV file.
Hint
If all labels in the first column have a red background, and those in the second column have a green background, the data have been correctly imported.
The remaining columns show the content of the file and how the data in the file are interpreted. All fields that have not been recognized are depicted in yellow: They can be associated with the available fields by dragging the red labels from the left-most column onto the yellow fields in the second columns.
Note
The data in these columns can not be modified, so if there’s something wrong with them, go back to the previous page to stop the import process and modify the CSV file before trying again to import it.
Below the table appears the following options:
By ticking the checkbox, before the new accounts are actually imported and stored, a summary of the accounts will be shown, divided into two parts: At the top of the page the new accounts are displayed, while on the bottom there are the accounts to be updated.
A click on this button starts the storage of the accounts in the Endian UTM Appliance and concludes the import process.
Hint
If the checkbox above is ticked, click again on this button after the summary has been show to complete the import process.
Warning
Recall that modifying one of the user’s login information causes a new account to be created. This is true also when importing accounts that only slightly differ in some login information from existing ones. Make sure to examine them prior importing them, in order to avoid potential issues later.
A list of existing accounts can be exported and saved in CSV format. When exporting the list, the fields that will appear in the exported file are fixed, so it is only possible to decide whether to open (view) the file or under which directory to save it. For convenience, the filename will be saved as accounts_YYYYMMDD_HHMM, where YYYYMMDD represents the year, month, and day, and HHMM represents the hour and minutes when the list has been exported. This choice allows the exported files to be listed in lexicographic order in the directory in which they are saved. The filenames can however be modified at will. The exported files can be used as backups and imported later.
Warning
Remember that the exported list contains also the passwords of the users in plain text, so remember to keep the list in a safe place.
The use of the account generator can prove particularly useful when there is a necessity to create a bulk of new accounts with a default ticket already assigned and can therefore be handed in to e.g., a group of users. As an example, consider the registration phase at the beginning of events like conferences or conventions, during which large groups of people need to access the hotspot and receive their credentials in a small interval of time.
This page is divided in four boxes: the first three compose the Account Generator, while the fourth one is the list of generated bulks of accounts, shown on the bottom of the page after at least some bulk has already been created.
The account generator allows to create at once a specific number of accounts by providing only some common options, grouped in three parts: Username, Password, and Settings, described below.
There are 2 different types of username generators: Sequential and Random, both of which share two common option:
The starting part of the username, shared by all accounts in the bulk. An empty prefix is also accepted.
The total length of the username.
Note
The Length must be longer that the Prefix, otherwise an error message will be displayed.
The usernames will be completed differently for the two generators. In the case of the sequential generator, increasing numbers are used, defined by the option:
The digit or number from which the sequence starts.
Hint
If more characters are needed, besides the prefix length and the sequence, to reach the required length, _strong:0s will be added. (see Example HS2).
In the case of the random generator, characters are used, chosen from the Character sets selected, among uppercase and lowercase letters, numbers, and extra characters (see below).
Here passwords associated to the accounts are generated. The following options are available.
How many character long will be the password.
Choose which categories of characters will be used to generate the random passwords, which are:
Uppercase Letters (A-Z)
Lowercase Letters (a-z)
Numbers (0-9)
Extra characters (._-+)
Note
The strength of the password depends on its length and on how many character qqsets are used. As a rule of thumb, chosing a 8 character long password and all character sets will generate 48-bit passwords, which should suffice for most uses.
Additional option about the generated accounts:
How many new accounts will be created.
Tick the checkbox to make the accounts available for immediate use.
Choose from the drop-down menu which ticket should be assigned to the accounts.
Choose for how many days will the account valid. The default value is of 1 year or 365 days.
Choose the default language that will be used to show the messages and interface to the account.
To generate users with the specified settings, click on the Generate accounts button: A sample of the first 5 username - password combinations will appear. The whole bulk will be generated only after clicking on Confirm, otherwise a click on Cancel will delete the whole operation
After the first creation of a bulk of accounts, the page will reload with a confirmation message and, beneath the account generator, a new table will show up, that contains information about the accounts created. In particular, the following columns are shown in the table:
The date on which the accounts have been generated.
The number of users that have been generated.
There are three available actions on each bulk:
Load settings, to load the setting used to create those accounts and reuse them to generate a new bulk.
Delete users, to remove all the users created in that generation. This action will only delete users who have not yet connected or who do not have credit left, while users which have already connected to the hotspot or have credit left will not be deleted.
Export as CSV to export the username / password combination in CSV format. This proves useful to print the data on prepaid cards.