Difference between revisions of "Template:Networking rutos manual hotspot"

From Teltonika Networks Wiki
(Created page with "{{Template:Networking_rutos_manual_fw_disclosure | fw_version = {{{series}}}_R_00.02.03.1 | series = {{{series}}} }} ==Summary== '''Hotspot''' is a service that provides...")
 
(change user scripts, minor changes)
Line 1: Line 1:
 
{{Template:Networking_rutos_manual_fw_disclosure
 
{{Template:Networking_rutos_manual_fw_disclosure
 
| fw_version = {{{series}}}_R_00.02.03.1
 
| fw_version = {{{series}}}_R_00.02.03.1
−
| series     = {{{series}}}
+
| series = {{{series}}}
 
}}
 
}}
  
Line 12: Line 12:
 
{{{name}}} devices are able to create Hotspot on either Wireless or LAN interface.
 
{{{name}}} devices are able to create Hotspot on either Wireless or LAN interface.
  
−
Wireless <b>Hotspots</b> are essentially Wireless Access Points - they provide network and/or internet access to other WiFi devices. The difference is that Hotspots are a lot more versatile when it comes to managing, monitoring and authenticating the wireless network's users. For example, while Wireless APs can be password protected, with Hotspots you can configure different users with different names, passwords, even data limits and data speeds and more. This chapter is an overview of the '''Wireless Hotspot''' function in {{{name}}} routers. In Services > Hotspot > General tab first choose interface on which you want Hotspot to operate, press '''Add''' and after new hotspot instance appears click on [[File:Networking_rutx_manual_edit_button_v1.png]] to start configuration.
+
Wireless <b>Hotspots</b> are essentially Wireless Access Points - they provide network and/or internet access to other
 +
WiFi devices. The difference is that Hotspots are a lot more versatile when it comes to managing, monitoring and
 +
authenticating the wireless network's users. For example, while Wireless APs can be password protected, with Hotspots
 +
you can configure different users with different names, passwords, even data limits and data speeds and more. This
 +
chapter is an overview of the '''Wireless Hotspot''' function in {{{name}}} routers. In Services > Hotspot > General tab
 +
first choose interface on which you want Hotspot to operate, press '''Add''' and after new hotspot instance appears
 +
click on [[File:Networking_rutx_manual_edit_button_v1.png]] to start configuration.
  
 
[[File:Network_rutxxx_manual_hotspot_hotspot_instances.png]]
 
[[File:Network_rutxxx_manual_hotspot_hotspot_instances.png]]
−
|  
+
|
 
{{{name}}} devices are able to create Hotspot on LAN interface.
 
{{{name}}} devices are able to create Hotspot on LAN interface.
  
Line 23: Line 29:
 
==General Settings==
 
==General Settings==
  
−
The '''General Settings''' window is where most of the Hotspot configurations take place. This section will be divided into sub-sections because configuration for Local authentication and with Radius Server are almost identical, just when Radius is chosen extra tab appears.
+
The '''General Settings''' window is where most of the Hotspot configurations take place. This section will be divided
 +
into sub-sections because configuration for Local authentication and with Radius Server are almost identical, just when
 +
Radius is chosen extra tab appears.
  
 
====General====
 
====General====
 
----
 
----
−
[[File:Network_rutxxx_manual_hotspot_general_settings_radius.png]]
+
[[File:Network_rutxxx_manual_hotspot_general_settings_v1.png|border|class=tlt-border]]
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
−
    <tr>
+
<tr>
−
        <th>field name</th>
+
<th>field name</th>
−
      <th>value</th>
+
<th>value</th>
−
      <th>description</th>
+
<th>description</th>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
      <td>Enable</td>
+
<td>Enable</td>
−
      <td>off {{!}} on; Default: '''on'''</td>
+
<td>off {{!}} on; default: '''on'''</td>
−
      <td>Toggles WiFi Hotspot instance ON or OFF.</td>
+
<td>Toggles WiFi Hotspot instance ON or OFF.</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
      <td>Hotspot Network</td>
+
<td>Hotspot Network</td>
−
      <td>IP; Default: '''192.168.2.0/24'''</td>
+
<td>IP; default: '''192.168.2.0/24'''</td>
−
      <td>Defines IP and subnet of Hotspot Network</td>
+
<td>Defines IP and subnet of Hotspot Network.</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
    <td>IP Adress</td>
+
<td>IP Adress</td>
−
        <td>ip; Default: '''192.168.2.254'''</td>
+
<td>ip; default: '''192.168.2.254'''</td>
−
        <td>Defines the IP address of your Hotspot router in network</td>
+
<td>Defines the IP address of your Hotspot router in network.</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
      <td>Authentication mode</td>
+
<td>Authentication mode</td>
−
      <td>Radius {{!}} Local user {{!}} {{#ifeq:{{{mobile}}}|1| SMS OTP {{!}}}} MAC auth ; Default: '''Local users'''</td>
+
<td>Radius {{!}} Local user {{!}} {{#ifeq:{{{mobile}}}|1| SMS OTP {{!}}}} MAC auth ; default: '''Local users'''
−
      <td>Authentication mode defines how users will connect to the Hotspot</td>
+
</td>
−
    </tr><tr><td>Allow signup
+
<td>Authentication mode defines how users will connect to the Hotspot.</td>
−
</td><td>off | on; Default: '''off'''</td><td>Allows users to sign up to hotspot via landing page.</td></tr><tr>
+
</tr>
−
        <td>Landing Page</td>
+
<tr>
−
        <td>Internal {{!}} External; Default: '''Internal'''</td>
+
<td>Allow signup
−
        <td>If external Landing Page is chosen, new section, to enter website address, will appear, e.g. http://www.example.com</td>
+
</td>
−
    </tr>
+
<td>off | on; default: '''off'''</td>
−
    <tr>
+
<td>Allows users to sign up to hotspot via landing page.</td>
−
        <td>UAM Port</td>
+
</tr>
−
        <td>integer; Default: '''3990'''</td>
+
<tr>
−
        <td>Port to bind for authenticating clients</td>
+
<td>Landing Page</td>
−
    </tr>
+
<td>Internal {{!}} External; default: '''Internal'''</td>
−
    <tr>
+
<td>If external Landing Page is chosen, new section, to enter website address, will appear, e.g.
−
        <td>UAM Secret</td>
+
http://www.example.com</td>
−
        <td>string; Default: " "</td>
+
</tr>
−
        <td>Shared secret between uamserver and hotspot.</td>
+
<tr>
−
    </tr>
+
<td>UAM Port</td>
−
    <tr>
+
<td>integer; default: '''3990'''</td>
−
        <td>Success page</td>
+
<td>Port to bind for authenticating clients.</td>
−
        <td>Success Page {{!}} Original URL {{!}} Custom; Default: '''Success page'''</td>
+
</tr>
−
        <td>Location to return to after successful authentication</td>
+
<tr>
−
    </tr>
+
<td>UAM Secret</td>
 +
<td>string; default: <b>none</b></td>
 +
<td>Shared secret between uamserver and hotspot.</td>
 +
</tr>
 +
<tr>
 +
<td>Success page</td>
 +
<td>Success Page {{!}} Original URL {{!}} Custom; default: '''Success page'''</td>
 +
<td>Location to return to after successful authentication.</td>
 +
</tr>
 
</table>
 
</table>
  
Line 80: Line 96:
 
----
 
----
  
−
[[File:Network_rutxxx_manual_hotspot_advanced_settings_radius.png]]
+
[[File:Network_rutxxx_manual_hotspot_advanced_settings_v1.png|border|class=tlt-border]]
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
−
    <tr><td>Additional interfaces</td><td>Available interfaces; Default: '''none'''
+
<tr>
−
</td><td>Shows additional interfaces that can be attached to hotspot instance</td></tr><tr>
+
<td>Additional interfaces</td>
−
    <td>Logout address</td>
+
<td>Available interfaces; default: '''none'''</td>
−
        <td>ip; Default: '''1.0.0.0'''</td>
+
<td>Shows additional interfaces that can be attached to hotspot instance.</td>
−
        <td>An address that can be used by users to logout from the Hotspot session</td>
+
</tr>
−
    </tr>
+
<tr>
−
    <tr>
+
<td>Logout address</td>
−
        <td>Protocol</td>
+
<td>ip; default: '''1.0.0.0'''</td>
−
        <td>HTTP {{!}} HTTPS; Default: '''HTTP'''</td>
+
<td>An address that can be used by users to logout from the Hotspot session.</td>
−
        <td>Protocol to be used for landing page</td>
+
</tr>
−
    </tr><tr><td>Enable TOS</td><td>off {{!}} on; Default '''off'''</td><td>Enables Terms of Service (ToS) requirement. Cient device will be able to access the Internet only after agreeing ToS.
+
<tr>
−
</td></tr><tr>
+
<td>Protocol</td>
−
        <td>HTTPS to landing page redirect</td>
+
<td>HTTP {{!}} HTTPS; default: '''HTTP'''</td>
−
        <td>off {{!}} on; Default '''off'''</td>
+
<td>Protocol to be used for landing page.</td>
−
        <td>Redirect initial pre-landing page HTTPS requests to hotspot landing page</td>
+
</tr>
−
    </tr>
+
<tr>
−
    <tr>
+
<td>Enable TOS</td>
−
    <td>DNS server 1</td>
+
<td>off {{!}} on; default: '''off'''</td>
−
        <td>ip; Default: '''8.8.8.8'''</td>
+
<td>Enables Terms of Service (ToS) requirement. Cient device will be able to access the Internet only after
−
        <td>Additional DNS servers that are to be used by the Hotspot.</td>
+
agreeing ToS.</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
    <td>DNS server 2</td>
+
<td>Trial access</td>
−
        <td>ip; Default: '''8.8.4.4'''</td>
+
<td>off {{!}} on; default: '''off'''</td>
−
        <td>Additional DNS servers that are to be used by the Hotspot.</td>
+
<td>Enables trial internet access for a specific group.</td>
−
    </tr></table>
+
</tr>
 +
<tr>
 +
<td><span style="color: tomato;">Trial access: </span>Group</td>
 +
<td>User group; default: '''default'''</td>
 +
<td>Group of trial users.</td>
 +
</tr>
 +
<tr>
 +
<td>HTTPS to landing page redirect</td>
 +
<td>off {{!}} on; default: '''off'''</td>
 +
<td>Redirect initial pre-landing page HTTPS requests to hotspot landing page.</td>
 +
</tr>
 +
<tr>
 +
<td>DNS server 1</td>
 +
<td>ip; default: '''8.8.8.8'''</td>
 +
<td>Additional DNS servers that are to be used by the Hotspot.</td>
 +
</tr>
 +
<tr>
 +
<td>DNS server 2</td>
 +
<td>ip; default: '''8.8.4.4'''</td>
 +
<td>Additional DNS servers that are to be used by the Hotspot.</td>
 +
</tr>
 +
</table>
  
 
====Radius====
 
====Radius====
 
----
 
----
  
−
'''Radius''' authentication mode uses an external Radius servers, to which you have to provide an address to, instead of using the router's Local Authentication. If you are using Local authentication, you can skip straight to [[{{{name}}}_Hotspot#Walled_Garden|Walled Garden]].
+
'''Radius''' authentication mode uses an external Radius servers, to which you have to provide an address to, instead of
 +
using the router's Local Authentication. If you are using Local authentication, you can skip straight to
 +
[[{{{name}}}_Hotspot#Walled_Garden|Walled Garden]].
  
−
[[File:Network_rutxxx_manual_hotspot_radius_settings_radius.png]]
+
[[File:Network_rutxxx_manual_hotspot_radius_settings_v1.png|border|class=tlt-border]]
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
−
    <tr>
+
<tr>
−
    <td>RADIUS server #1</td>
+
<td>RADIUS server #1</td>
−
        <td>ip; Default: " "</td>
+
<td>ip; default: <b>none</b></td>
−
        <td>The IP address of the RADIUS server #1 that is to be used for Authenticating your wireless clients </td>
+
<td>The IP address of the RADIUS server #1 that is to be used for Authenticating your wireless clients.</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
    <td>RADIUS server #2</td>
+
<td>RADIUS server #2</td>
−
        <td>ip; Default: " "</td>
+
<td>ip; default: <b>none</b></td>
−
        <td>The IP address of the RADIUS server #2 that is to be used for Authenticating your wireless clients </td>
+
<td>The IP address of the RADIUS server #2 that is to be used for Authenticating your wireless clients.</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
      <td>Authentication port</td>
+
<td>Authentication port</td>
−
      <td>integer [0..65535]; Default: '''1812'''</td>
+
<td>integer [0..65535]; default: '''1812'''</td>
−
      <td>RADIUS server authentication port</td>
+
<td>RADIUS server authentication port.</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
      <td>Accounting port</td>
+
<td>Accounting port</td>
−
      <td>integer [0..65535]; Default: '''1813''' </td>
+
<td>integer [0..65535]; default: '''1813''' </td>
−
      <td>RADIUS server accounting port</td>
+
<td>RADIUS server accounting port.</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
    <td>NAS identifier</td>
+
<td>NAS identifier</td>
−
        <td>string; Default: " "</td>
+
<td>string; default: <b>none</b></td>
−
        <td>NAS-Identifier is one of the basic RADIUS attributes</td>
+
<td>NAS-Identifier is one of the basic RADIUS attributes.</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
    <td>Radius secret key</td>
+
<td>Radius secret key</td>
−
        <td>string; Default: " "</td>
+
<td>string; default: <b>none</b></td>
−
        <td>The secret key is a password used for authentication with the RADIUS server</td>
+
<td>The secret key is a password used for authentication with the RADIUS server.</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
      <td>Swap octets</td>
+
<td>Swap octets</td>
−
      <td>off {{!}} on; Default: '''off'''</td>
+
<td>off {{!}} on; default: '''off'''</td>
−
      <td>Swaps the meaning of input octets and output as it relates to RADIUS attributes</td>
+
<td>Swaps the meaning of input octets and output as it relates to RADIUS attributes.</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
    <td>Location name</td>
+
<td>Location name</td>
−
        <td>string; Default: " "</td>
+
<td>string; default: <b>none</b></td>
−
        <td>Custom location name for your Hotspot</td>
+
<td>Custom location name for your Hotspot.</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
    <td>Location ID</td>
+
<td>Location ID</td>
−
        <td>string; Default: " "</td>
+
<td>string; default: <b>none</b></td>
−
        <td>Custom location ID for your Hotspot</td>
+
<td>Custom location ID for your Hotspot.</td>
−
    </tr>
+
</tr>
 
</table>
 
</table>
  
Line 168: Line 207:
 
----
 
----
  
−
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 in to Address List.
+
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 in to Address List.
  
−
[[File:Network_rutxxx_manual_hotspot_general_walled_garden.png]]
+
[[File:Network_rutxxx_manual_hotspot_general_walled_garden_v1.png|border|class=tlt-border]]
  
 
====User Scripts====
 
====User Scripts====
 
----
 
----
  
−
In this tab you can add Scripts that will be executed after a session is authorized in '''Session up''' section and Scripts that will be executed after session has moved from authorized state to unauthorized in '''Session down''' section.
+
In this tab you can add Scripts that will be executed after a session is authorized in '''Session up'''
 +
section, after session has moved from authorized state to unauthorized in '''Session down''' section
 +
and after a new user has been signed up in '''User signup''' section.
  
−
[[File:Network_rutxxx_manual_hotspot_user_scripts_radius.png]]
+
[[File:Network_rutxxx_manual_hotspot_user_scripts_v1.png|border|class=tlt-border]]
  
 
==Local Users==
 
==Local Users==
Line 183: Line 225:
 
The '''Users Configuration''' tab is used to create new, unique users that can connect to the Hotspot.
 
The '''Users Configuration''' tab is used to create new, unique users that can connect to the Hotspot.
  
−
[[File:Network_rutxxx_manual_hotspot_local_users.png]]
+
[[File:Network_rutxxx_manual_hotspot_local_users_v1.png|border|class=tlt-border]]
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
−
    <tr>
+
<tr>
−
        <th>field name</th>
+
<th>field name</th>
−
      <th>value</th>
+
<th>value</th>
−
      <th>description</th>
+
<th>description</th>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
      <td>Name</td>
+
<td>Name</td>
−
      <td>string; Default: " "</td>
+
<td>string; default: <b>none</b></td>
−
      <td>A custom user name used to authenticate clients connecting to the Hotspot</td>
+
<td>A custom user name used to authenticate clients connecting to the Hotspot.</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
      <td>Password</td>
+
<td>Password</td>
−
      <td>string; Default: " "</td>
+
<td>string; default: <b>none</b></td>
−
      <td>A custom password for the specified user name</td>
+
<td>A custom password for the specified user name.</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
    <td>Group</td>
+
<td>Group</td>
−
        <td>string; Default: '''default'''</td>
+
<td>string; default: '''default'''</td>
−
        <td>After adding user select group that it will be assigned to. Group describes connection speeds and dowload/upload limits. The '''default''' group settings have no restrictions. More on User Groups in the next section</td>
+
<td>After adding user select group that it will be assigned to. Group describes connection speeds and
−
    </tr>
+
dowload/upload limits. The '''default''' group settings have no restrictions. More on User Groups in the
 +
next section.</td>
 +
</tr>
 
</table>
 
</table>
  
 
==User Groups==
 
==User Groups==
  
−
'''User Groups''' lets set different connection limitats for different users. Group '''default''' is already created and does not have any limitations set. To create new group simply enter the name and press Add.
+
'''User Groups''' lets set different connection limits for different users. Group '''default''' is already created and
 +
does not have any limitations set. To create new group simply enter the name and press Add.
  
−
[[File:Network_rutxxx_manual_hotspot_user_groups.png]]
+
[[File:Network_rutxxx_manual_hotspot_user_groups_v1.png|border|class=tlt-border]]
  
−
After adding a group it will not have any limits set, so press edit [[File:Networking rutx manual edit button v1.png]]. In following window you will be able to configure yours User Group.
+
After adding a group it will not have any limits set, so press edit [[File:Networking rutx manual edit button v1.png]].
 +
In following window you will be able to configure yours User Group.
  
−
[[File:Network_rutxxx_manual_hotspot_user_group_settings.png]]
+
[[File:Network_rutxxx_manual_hotspot_user_group_settings_v1.png|border|class=tlt-border]]
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
−
    <tr>
+
<tr>
−
        <th>field name</th>
+
<th>field name</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: " "</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 unlimited)</td>
+
<td>A timeout in seconds after which idle users are automatically disconnected from the Hotspot. (0 means
−
    </tr>
+
unlimited)</td>
−
    <tr>
+
</tr>
−
      <td>Time limit</td>
+
<tr>
−
      <td>integer; Default: " "</td>
+
<td>Time limit</td>
−
      <td>Disables hotspot user after time limit in sec is reached. (0, meaning unlimited)</td>
+
<td>integer; default: <b>none</b></td>
−
    </tr>
+
<td>Disables hotspot user after time limit in sec is reached. (0, meaning unlimited)</td>
−
    <tr>
+
</tr>
−
    <td>Download bandwidth</td>
+
<tr>
−
        <td>integer; Default: " "</td>
+
<td>Download bandwidth</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>integer; default: <b>none</b></td>
−
    </tr>
+
<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>
−
    <td>Upload bandwidth</td>
+
</tr>
−
        <td>integer; Default: " "</td>
+
<tr>
−
        <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>Upload bandwidth</td>
−
    </tr>
+
<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
−
      <td>Download limit</td>
+
Kbit/s or Mbit/s.</td>
−
      <td>integer; Default: " "</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>
+
<tr>
−
    </tr>
+
<td>Download limit</td>
−
    <tr>
+
<td>integer; default: <b>none</b></td>
−
      <td>Upload limit</td>
+
<td>A received data limit that the users assigned to this template can reach. After the data limit is reached,
−
      <td>integer; Default: " "</td>
+
the user will lose data connection. Download limit is specified in MB.</td>
−
      <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>
+
<tr>
−
    <tr>
+
<td>Upload limit</td>
−
    <td>Period</td>
+
<td>integer; default: <b>none</b></td>
−
        <td>Month {{!}} Week {{!}} Day; Default: '''Month'''</td>
+
<td>A sent data limit that the users assigned to this template can reach. After the data limit is reached, the
−
        <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>
+
user will lose data connection. Upload limit is specified in MB.</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
    <td>Start day</td>
+
<td>Period</td>
−
        <td>integer [1..31] {{!}} Monday..Sunday {{!}} integer [1..24]; Default: '''1'''</td>
+
<td>Month {{!}} Week {{!}} Day; default: '''Month'''</td>
−
        <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>
+
<td>The beginning of the period during which the restriction specified in this section will apply. After the
−
    </tr>
+
period is over, all specified limits are reset. </td>
−
    <tr>
+
</tr>
−
    <td>Expiration time</td>
+
<tr>
−
        <td>integer; Default: '''0'''</td>
+
<td>Start day</td>
−
        <td>Expiration time in sec (0 means unlimited). Only for dynamically created users.</td>
+
<td>integer [1..31] {{!}} Monday..Sunday {{!}} integer [1..24]; default: '''1'''</td>
−
    </tr>
+
<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>
 +
</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>
  
 
==Landing Page==
 
==Landing Page==
  
−
This section is used to define how your Hotspot's Landing Page will look like.  
+
This section is used to define how your Hotspot's Landing Page will look like.
  
 
===General Settings===
 
===General Settings===
Line 289: Line 342:
 
====Images====
 
====Images====
 
----
 
----
−
The <b>Images</b> section allows you to upload custom images to different objects.  
+
The <b>Images</b> section allows you to upload custom images to different objects.
  
 
[[File:Network_rutxxx_manual_hotspot_landing_page_themes_images_v1.png|border|class=tlt-border]]
 
[[File:Network_rutxxx_manual_hotspot_landing_page_themes_images_v1.png|border|class=tlt-border]]
Line 296: Line 349:
 
----
 
----
  
−
Pressing edit button [[File:Networking rutx manual edit button v1.png]] next to style settings lets you edit how your landing page will look visually using CSS syntax.
+
Pressing edit button [[File:Networking rutx manual edit button v1.png]] 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|border|class=tlt-border]]
 
[[File:Network_rutxxx_manual_hotspot_landing_page_themes_style_v1.png|border|class=tlt-border]]

Revision as of 15:29, 15 June 2020

Template:Networking rutos manual fw disclosure

Summary

Hotspot is a service that provides authentication, authorization and accounting for a network.

{{{name}}} devices are able to create Hotspot on LAN interface.

File:Network rutx10 manual hotspot hotspot instances v1.png

General Settings

The General Settings window is where most of the Hotspot configurations take place. This section will be divided into sub-sections because configuration for Local authentication and with Radius Server are almost identical, just when Radius is chosen extra tab appears.

General

File:Network rutxxx manual hotspot general settings v1.png

field name value description
Enable off | on; default: on Toggles WiFi Hotspot instance ON or OFF.
Hotspot Network IP; default: 192.168.2.0/24 Defines IP and subnet of Hotspot Network.
IP Adress 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

File:Network rutxxx manual hotspot advanced settings v1.png

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. Cient 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: default 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 servers, to which you have to provide an address to, instead of using the router's Local Authentication. If you are using Local authentication, you can skip straight to [[{{{name}}}_Hotspot#Walled_Garden|Walled Garden]].

File:Network rutxxx manual hotspot radius settings v1.png

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 in to Address List.

File:Network rutxxx manual hotspot general walled garden v1.png

User Scripts

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

File:Network rutxxx manual hotspot user scripts v1.png

Local Users

The Users Configuration tab is used to create new, unique users that can connect to the Hotspot.

File:Network rutxxx manual hotspot local users v1.png

field name value description
Name string; default: none A custom user name used to authenticate clients connecting to the Hotspot.
Password string; default: none A custom password for the specified user name.
Group string; default: default After adding user select group that it will be assigned to. Group describes connection speeds and

dowload/upload limits. The default group settings have no restrictions. More on User Groups in the

next section.

User Groups

User Groups lets set different connection limits for different users. Group default is already created and does not have any limitations set. To create new group simply enter the name and press Add.

File:Network rutxxx manual hotspot user groups v1.png

After adding a group it will not have any limits set, so press edit Networking rutx manual edit button v1.png. In following window you will be able to configure yours User Group.

File:Network rutxxx manual hotspot user group settings v1.png

field name 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 Networking rutx manual edit button v1.png 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]]

Retrieved from "https://wiki.teltonika-networks.com/index.php?title=Template:Networking_rutos_manual_hotspot&oldid=65096"