Template:Networking rutos manual hotspot: Difference between revisions

From Teltonika Networks Wiki
Line 228: Line 228:
==User Groups==
==User Groups==


<b>User Groups</b> provides the possibility to set different connection limits for different users. A group called 'default' is already created and does not have any limitations set by default. You can edit this group or create a new by entering a custom name and clicking the 'Add' button.
<b>User Groups</b> provides the possibility to set different connection limits for different users. A group called 'default' is already created and does not have any limitations set by default. You can  


[[File:Network_rutxxx_manual_hotspot_user_groups_v1.png|border|class=tlt-border]]
<ol>
    <li>create a new group by entering a custom Name and clicking 'Add'</li>
    <li>or configure the existing rule by clicking the 'Edit' button next to it.</li>
</ol>


After adding a group it will not have any limits set, so press edit [[File:Networking rutx manual edit button v1.png]].
[[File:Networking_rutos_manual_hotspot_user_groups_edit_button.png|border|class=tlt-border]]
In following window you will be able to configure yours User Group.


[[File:Network_rutxxx_manual_hotspot_user_group_settings_v1.png|border|class=tlt-border]]
A group's settings page will look similar to this:
 
[[File:Networking_rutos_manual_hotspot_user_groups_group_default_settings.png|border|class=tlt-border]]


<table class="nd-mantable">
<table class="nd-mantable">
<tr>
    <tr>
<th>field name</th>
<th>Field</th>
<th>value</th>
<th>Value</th>
<th>description</th>
<th>Description</th>
</tr>
    </tr>
<tr>
    <tr>
<td>Idle timeout</td>
<td>Idle timeout</td>
<td>integer; default: <b>none</b></td>
<td>integer; default: <b>none</b></td>
<td>A timeout in seconds after which idle users are automatically disconnected from the Hotspot. (0 means
<td>A timeout in seconds after which idle users are automatically disconnected from the Hotspot. (0 means unlimited.)</td>
unlimited)</td>
    </tr>
</tr>
    <tr>
<tr>
<td>Time limit</td>
<td>Time limit</td>
<td>integer; default: <b>none</b></td>
<td>integer; default: <b>none</b></td>
<td>Disables hotspot user after time limit in sec is reached. (0, meaning unlimited)</td>
<td>Disables hotspot user after time limit in sec is reached. (0, meaning unlimited)</td>
    </tr>
</tr>
    <tr>
<tr>
<td>Download bandwidth</td>
<td>Download bandwidth</td>
<td>integer; default: <b>none</b></td>
<td>integer; default: <b>none</b></td>
<td> Maximum download bandwidth that the users assigned to this template can achieve. Bandwidth can be specified in Kbit/s or Mbit/s.</td>
<td> Maximum download bandwidth that the users assigned to this template can achieve. Bandwidth can be specified
    </tr>
in Kbit/s or Mbit/s.</td>
    <tr>
</tr>
<td>Upload bandwidth</td>
<tr>
<td>integer; default: <b>none</b></td>
<td>Upload bandwidth</td>
<td>Maximum upload bandwidth that the users assigned to this template can achieve. Bandwidth can be specified in Kbit/s or Mbit/s.</td>
<td>integer; default: <b>none</b></td>
    </tr>
<td>Maximum upload bandwidth that the users assigned to this template can achieve. Bandwidth can be specified in
    <tr>
Kbit/s or Mbit/s.</td>
<td>Download limit</td>
</tr>
<td>integer; default: <b>none</b></td>
<tr>
<td>A received data limit that the users assigned to this template can reach. After the data limit is reached, the user will lose data connection. Download limit is specified in MB.</td>
<td>Download limit</td>
    </tr>
<td>integer; default: <b>none</b></td>
    <tr>
<td>A received data limit that the users assigned to this template can reach. After the data limit is reached,
<td>Upload limit</td>
the user will lose data connection. Download limit is specified in MB.</td>
<td>integer; default: <b>none</b></td>
</tr>
<td>A sent data limit that the users assigned to this template can reach. After the data limit is reached, the user will lose data connection. Upload limit is specified in MB.</td>
<tr>
    </tr>
<td>Upload limit</td>
    <tr>
<td>integer; default: <b>none</b></td>
<td>Period</td>
<td>A sent data limit that the users assigned to this template can reach. After the data limit is reached, the
<td>Month | Week | Day; default: <b>Month</b></td>
user will lose data connection. Upload limit is specified in MB.</td>
<td>The beginning of the period during which the restriction specified in this section will apply. After the period is over, all specified limits are reset. </td>
</tr>
    </tr>
<tr>
    <tr>
<td>Period</td>
<td>Start day</td>
<td>Month {{!}} Week {{!}} Day; default: '''Month'''</td>
<td>integer [1..31] | Monday..Sunday | integer [1..24]; default: <b>1</b></td>
<td>The beginning of the period during which the restriction specified in this section will apply. After the
<td>Choices changes depending on what 'Period' was chosen. Specifies which day of the month, week or hour of the day the limits will be reset.</td>
period is over, all specified limits are reset. </td>
    </tr>
</tr>
    <tr>
<tr>
<td>Expiration time</td>
<td>Start day</td>
<td>integer; default: <b>0</b></td>
<td>integer [1..31] {{!}} Monday..Sunday {{!}} integer [1..24]; default: '''1'''</td>
<td>Expiration time in sec (0 means unlimited). Only for dynamically created users.</td>
<td>Choices changes depending on what '''Period''' was chosen. Specifies which day of the month, week or hour of
    </tr>
the day the limits will be reset.</td>
</tr>
<tr>
<td>Expiration time</td>
<td>integer; default: '''0'''</td>
<td>Expiration time in sec (0 means unlimited). Only for dynamically created users.</td>
</tr>
</table>
</table>



Revision as of 12:08, 26 August 2020

Template:Networking rutos manual fw disclosure

Summary

On Teltonika Networks devices a Hotspot is a service that provides authentication, authorization and accounting for a network. This chapter is an overview of the Hotspot section for {{{name}}} devices.

General

Hotspot Instances


The Hotspot Instances section displays the main parameters of your Hotspot. By default, a Hotspot instance does not exist on the device. To create a new instance and begin configuration:

  1. select an 'Interface';
  2. click the 'Add' button;
  3. click the 'Edit' button next to the newly added Hotspot instance.

[[File:Networking_rutos_manual_hotspot_hotspot_instances_add_button_edit_buton_wifi_{{{wifi}}}.png|border|class=tlt-border]]

After this you should be redirected to the Hotspot's configuration page.

General Settings


The General Settings window is where most of the Hotspot configuration takes place. Look to the sub-sections below for information on configuration fields found in the General Settings sections.

General

Field Value Description
Enable off | on; default: on Turns the Hotspot instance on or off.
Hotspot Network ip/netmask; default: 192.168.2.0/24 IP address and subnet of the Hotspot network.
IP Address ip; default: 192.168.2.254 Defines the IP address of your Hotspot router in network.
Authentication mode Radius | Local user | MAC auth ; default: Local users Authentication mode defines how users will connect to the Hotspot.
Allow signup off | on; default: off Allows users to sign up to hotspot via landing page.
Landing Page Internal | External; default: Internal If external Landing Page is chosen, new section, to enter website address, will appear, e.g., http://www.example.com
UAM Port integer; default: 3990 Port to bind for authenticating clients.
UAM Secret string; default: none Shared secret between uamserver and hotspot.
Success page Success Page | Original URL | Custom; default: Success page Location to return to after successful authentication.
Advanced

Field Value Description
Additional interfaces Available interfaces; default: none Shows additional interfaces that can be attached to hotspot instance.
Logout address ip; default: 1.0.0.0 An address that can be used by users to logout from the Hotspot session.
Protocol HTTP | HTTPS; default: HTTP Protocol to be used for landing page.
Enable TOS off | on; default: off Enables Terms of Service (ToS) requirement. Client device will be able to access the Internet only after agreeing ToS.
Trial access off | on; default: off Enables trial internet access for a specific group.
Trial access: Group User group; default: defaulttd> Group of trial users.
HTTPS to landing page redirect off | on; default: off Redirect initial pre-landing page HTTPS requests to hotspot landing page.
DNS server 1 ip; default: 8.8.8.8 Additional DNS servers that are to be used by the Hotspot.
DNS server 2 ip; default: 8.8.4.4 Additional DNS servers that are to be used by the Hotspot.
Radius

Radius authentication mode uses an external RADIUS server, to which you have to provide an address to, instead of using the router's Local Authentication. If you are using Local authentication, this section is not visible.

Field Value Description
RADIUS server #1 ip; default: none The IP address of the RADIUS server #1 that is to be used for Authenticating your wireless clients.
RADIUS server #2 ip; default: none The IP address of the RADIUS server #2 that is to be used for Authenticating your wireless clients.
Authentication port integer [0..65535]; default: 1812 RADIUS server authentication port.
Accounting port integer [0..65535]; default: 1813 RADIUS server accounting port.
NAS identifier string; default: none NAS-Identifier is one of the basic RADIUS attributes.
Radius secret key string; default: none The secret key is a password used for authentication with the RADIUS server.
Swap octets off | on; default: off Swaps the meaning of input octets and output as it relates to RADIUS attributes.
Location name string; default: none Custom location name for your Hotspot.
Location ID string; default: none Custom location ID for your Hotspot.
Walled Garden

You can add a list of addresses that users connected to the Hotspot will be able to reach without any authentication. By default this list is empty. Simply write addresses into the Address List.

User Scripts

In this section you can add custom Scripts that will be executed after a session is authorized in the Session up section, after session has moved from authorized state to unauthorized in the Session down section and after a new user has been signed up in the User signup section.

Local Users

The Local Users section is used to create and manage users that can connect to the Hotspot. The elements comprising the Local Users page are explained in the list and figure below.

  1. Entering a Username, Password and clicking the 'Add' button creates a new user.
  2. The 'Group' dropdown menu assigns a user to another group.
  3. The 'Edit' button lets you change a user's password or assign the user to another group.
  4. The 'Delete[X]' button deletes a user.

User Groups

User Groups provides the possibility to set different connection limits for different users. A group called 'default' is already created and does not have any limitations set by default. You can

  1. create a new group by entering a custom Name and clicking 'Add'
  2. or configure the existing rule by clicking the 'Edit' button next to it.

A group's settings page will look similar to this:

Field Value Description
Idle timeout integer; default: none A timeout in seconds after which idle users are automatically disconnected from the Hotspot. (0 means unlimited.)
Time limit integer; default: none Disables hotspot user after time limit in sec is reached. (0, meaning unlimited)
Download bandwidth integer; default: none Maximum download bandwidth that the users assigned to this template can achieve. Bandwidth can be specified in Kbit/s or Mbit/s.
Upload bandwidth integer; default: none Maximum upload bandwidth that the users assigned to this template can achieve. Bandwidth can be specified in Kbit/s or Mbit/s.
Download limit integer; default: none A received data limit that the users assigned to this template can reach. After the data limit is reached, the user will lose data connection. Download limit is specified in MB.
Upload limit integer; default: none A sent data limit that the users assigned to this template can reach. After the data limit is reached, the user will lose data connection. Upload limit is specified in MB.
Period Month | Week | Day; default: Month The beginning of the period during which the restriction specified in this section will apply. After the period is over, all specified limits are reset.
Start day integer [1..31] | Monday..Sunday | integer [1..24]; default: 1 Choices changes depending on what 'Period' was chosen. Specifies which day of the month, week or hour of the day the limits will be reset.
Expiration time integer; default: 0 Expiration time in sec (0 means unlimited). Only for dynamically created users.

Landing Page

This section is used to define how your Hotspot's Landing Page will look like.

General Settings


General Settings section lets you choose authentication protocol that will be used in Landing Page.

File:Network rutxxx manual hotspot landing page general v1.png

Themes


The Themes section shows all available landing page themes and allows you to edit them.

File:Network rutxxx manual hotspot landing page themes v1.png

Images


The Images section allows you to upload custom images to different objects.

File:Network rutxxx manual hotspot landing page themes images v1.png

Style settings


Pressing edit button next to style settings lets you edit how your landing page will look visually using CSS syntax.

File:Network rutxxx manual hotspot landing page themes style v1.png

View settings


In view settings you can access and modify default templates for various parts of landing page and edit their HTML code.

File:Network rutxxx manual hotspot landing page themes view settings v1.png

User management

The User management section allows you to manage currently logged in users.

File:Network rutxxx manual hotspot landing page user management v1.png

[[Category:{{{name}}} Services section]]