Administrator Manual
The Users

The user is the manager’s customer who will take advantage of the offered services by connecting to the hotspot or through PPPoE. 
The creation of the users, depending on what you specified in the domain that contains them, can be made in several ways:

Mode

Description

From user

The user, who connects to a HGW, by pressing the “register” button, runs the registration procedure set out in the domain and eventually by paying the product using “ Vouchers” or payment gateway.

From operator

An operator of the manager asks the customer for the data and manually creates users by filling out the form.

From card

Using the procedure “ Managing Cards“, the manager can generate cards with your username and password to be delivered to its customers.

From external procedure

By using the APIs available in HSNM. In this way, for example, a management software for a hotel can create the user account during client registration.

From import

Using the “ Utility Functions“, you can import an Excel (XLSX) file with data of the users to be created.

From printers

Automatic import of the users created on MikroTik RouterOS by printers (Ticket printer).

From external Apps

Automatic import of the users created on MikroTik RouterOS by external applications or tools.

The Context Dropdown menu

By clicking the context properties button of the desired user, you expand the context dropdown menu that, in addition to the “Edit” group, contains several options in the Admin group.

The “Admin” Section

Contains the following options:

Option

Description

Dashboard

Selecting the branch, you will open the user’s dashboard with the following tiles: the main chart, context data, connections, traffic, and sold GW.
For further details about the content of the various tiles, please refer to the Tile Types of the Dashboards paragraph.

Disconnect User

Disconnects the user from the gateway (if accessible) and radius.

If the gateway is not reachable from HSNM, the following error will appear: “Warning! The gateway is not reachable and therefore, it is not possible to disconnect the user. Anyway, it has been disclosed in the data of the radius”.

This option is displayed only if the gateway is a MikroTik type, the system user has permission to manage the user data, and the user is connected.

Locate the User on the WiFi Heatmap

Searches and displays the heatmap with gateways and access points where users performed their last WiFi connection.

Print card

Print a card for the user with the login credentials.

Recharge

Goes to a page allowing you to assign a new product to the user. Assigning a new product, the user does not lose any credit of time or residual traffic of the previous product.

Sales to User

Shows a table, grouped by product, the costs and revenues obtained by the managers from the connectivity sales to the selected user.

Send credentials

Allows you to send the credentials to the user through SMS/e-mail depending on the settings of the domain

Data Management Tool

Opens the page for managing user-wide data. 

 User connection Log

The page shows the logs of the user’s connections. The list includes the following values: Connection ID; date/starting time; date/end time; duration in hours, minutes and seconds; up-download traffic; assigned IP address; MAC address; gateway’s name, NAS ID; gateway’s MAC address; causes of disconnection.

The “Cause of Disconnection” column can list a variety of reasons, including:

  • “User-Request”: the user asked for disconnection (for example, the button “LOGOFF” has been pressed in the APP of the state of connection).
  • “Lost-Carrier”: the carrier has been lost, which happens when the device is disconnected from the WiFi or has a weak WiFi signal and cannot keep the radius connection active.
  • “Lost-Service”: it is very similar to the “Lost-Carrier” cause, it is due to connection problems, and it happens when the connection is interrupted.
  • “Idle-Timeout”: it has reached the time of inactivity defined in the product assigned to the user. 
  • “History”: the record has been compressed and grouped to save space as defined in the “ System Settings” in the “keep the data for user connection for x time” field.
  • “Session-Timeout”: the user has reached the maximum connection time for the current session.
  • “Admin Reset”: the administrator resets the port or the session.
  • “Admin Reboot”: the administrator terminates the service on the gateway, i.e. he reboots the gateway.
  • “Port Error”: the gateway detected an error on the port that had prompted the session to terminate.
  • “NAS Error”: the gateway detected an error (different from the port), prompting the session to terminate.
  • “NAS Request”: the gateway terminated the session for other reasons not listed and not due to an error. In some cases when the gateway is rebooted.
  • “NAS Reboot”: the gateway terminated the session not due to administrative reboot (“crash”).
  • “Service Unavailable”: the gateway could not supply the required service.
  • “Callback”: the gateway terminates the current session to perform the call for a new session.
  • “User Error”: the user’s input is in error, causing the session closure.
  •  “Host Request”: the session is normally closed from the remote host. 
  • “Registration”: the user profile registration has been performed.
  • “Forced closure 1”: occurs and is written when the user has been disconnected due to the “Consider Users Disconnected After” option defined in the domain.
  • “Forced closure 2”: occurs and is written when the gateway stops sending updates to the device (Interim Update), leading to the device being considered disconnected. In this case, a connection remains open without having received the “STOP” and “Cause of Logout” commands.
  • “Forced closure 3”: occurs and is written when a device attempts to connect to the HSNM, and connection remains open for the same device without the “STOP” and “Cause of Logout” commands.
  • “Forced closure 4”: this occurs and is written when a user logs in again with a device that has an open connection that did not receive a ‘STOP’ command and the corresponding ’cause of disconnection’ before the ‘Forced closure 2’ event is generated.

The contextual menu is accessible for every single row that has a MAC Address, it allows access to the following options:

  • Disassociates this device from the user: it allows disassociating the device with the user’s MAC Address. (Visible only if the MAC Address has not been already disassociated).
  • Disassociates this device from the users of the domain: it allows disassociating the device with the MAC Address of the row from all the users of all the domains. (Visible only if the MAC Address has not been already disassociated).
  • Disassociates this device: it allows disassociating the device with a MAC Address of the row from all the users of all the domains. (Visible only if the MAC Address has not been already disassociated and the user logging in to the backend is an admin user).
  • Riassociates this device to the user: it allows reassociating the device with the MAC Address to the user. (Visible only if the MAC Address has not been already disassociated).
  • Reassociates this device to the users of the domain: it allows reassociating the device with the MAC Address of the row to the users of the domain. (Visible only if the MAC Address has not been already disassociated).
  • Reassociates this device: it allows reassociating the device with the MAC Address of the row to all the users of all the domains. (Visible only if the MAC Address has not been already disassociated and the user logging in to the backend is an admin user).

Warning! If you disassociate a user created from the Complementary Access (the name is given from the MAC address) the user will be deleted.

Logs of the User WiFi Connections

The page shows the log of user WiFi connections.
The list shows the following values:

  • Connection ID
  • Start date/time
  • End date/time
  • Duration in hours, minutes and seconds
  • Up and down traffic
  • Name of the gateway
  • Name of the access point
  • MAC Address
  • NAS ID/MAC address of the gateway or access point
  • Cause of disconnection

The “Cause of disconnection” column shows the values as described for the “ Log of User Connections”.

The “Sales and Payment” group

Contains the following options:

Option Description
Recharge

It goes to a page where you can allocate a new product to the user. When assigning a new product, the user retains their existing time credit and residual traffic from the previous product.

Sales to User

It shows a table grouped by product, the costs and revenues obtained by the managers from the connectivity sales to the selected user.