Changes

no edit summary
Line 1: Line 1: −
{{Template:Networking_rutos_manual_fw_disclosure
+
{{Template: Networking_device_manual_fw_disclosure
| fw_version = {{{series}}}_R_00.02.03.1
+
| series = {{{series}}}
| series     = {{{series}}}
+
| name  = {{{name}}}
 +
| fw_version ={{Template: Networking_device_manual_latest_fw
 +
| series = {{{series}}}
 +
| name  = {{{name}}}
 +
}}
 
}}
 
}}
 +
{{#ifeq: {{{series}}} | RUT9 |<br><i><b>Note</b>: <b>[[{{{name}}} Hotspot (legacy WebUI)|click here]]</b> for the old style WebUI (FW version {{Template: Networking_device_manual_latest_fw | series = RUT9XX}} and earlier) user manual page.</i>|}}
 +
{{#ifeq: {{{series}}} | RUT2 |<br><i><b>Note</b>: <b>[[{{{name}}} Hotspot (legacy WebUI)|click here]]</b> for the old style WebUI (FW version {{Template: Networking_device_manual_latest_fw | series = RUT2XX}} and earlier) user manual page.</i>|}}
 +
==Summary==
   −
==Summary==
+
On Teltonika Networks devices a <b>Hotspot</b> is a service that provides authentication, authorization and accounting for a network. This chapter is an overview of the Hotspot section for {{{name}}} devices.
 +
{{#switch: {{{series}}}
 +
  | #default =
 +
  | RUT36X|RUT9|TCR1|RUT2|RUT2M|RUT9M|TRB1|TRB2|TRB5|TRB2M|OTD140|RUT361 =  
 +
<u><b>
   −
'''Hotspot''' is a service that provides authentication, authorization and accounting for a network.
+
Note:</b> Hotspot is additional software that can be installed from the <b>System → [[{{{name}}} Package Manager|Package Manager]]</b> page.</u>
 +
}}
   −
{{#ifeq:{{{wifi}}}|1
+
==General==
|
  −
{{{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.
+
===Hotspot Instances===
 +
----
 +
The <b>Hotspot Instances</b> 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:
   −
[[File:Network_rutxxx_manual_hotspot_hotspot_instances.png]]
+
<ol>
|
+
    <li>select an 'Interface';</li>
{{{name}}} devices are able to create Hotspot on LAN interface.
+
    <li>click the 'Add' button;</li>
 +
</ol>
   −
[[File:Network_rutx10_manual_hotspot_hotspot_instances_v1.png|border|class=tlt-border]]
+
[[File:Networking_rutos_manual_hotspot_hotspot_instances_add_button_edit_buton_wifi_{{{wifi}}}.png|border|class=tlt-border]]
}}
     −
==General Settings==
+
After this, a new Hotspot configuration window will appear.
   −
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 Settings====
 +
----
 +
The <b>General Settings</b> 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====
+
=====General=====
 
----
 
----
[[File:Network_rutxxx_manual_hotspot_general_settings_radius.png]]
+
{{#switch: {{{series}}}
 +
  | #default = [[File:Networking_rutos_manual_hotspot_general_hotspot_instances_general_settings_general_v2.png|border|class=tlt-border]]
 +
  | TRB1 | TRB2 | TRB5 | TRB2M = [[File:Networking_rutos_manual_hotspot_general_hotspot_instances_general_settings_general_trb.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>Enable</td>
+
<td>Configuration profile</td>
      <td>off {{!}} on; Default: '''on'''</td>
+
<td>Cloud4wi | Default | Hotspotsystems | Purple portal; default: <b>Default</b></td>
      <td>Toggles WiFi Hotspot instance ON or OFF.</td>
+
<td>Pre-configures Hotspot settings according to the selected service provider.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>Hotspot Network</td>
+
<td>Enable</td>
      <td>IP; Default: '''192.168.2.0/24'''</td>
+
<td>off | on; default: <b>on</b></td>
      <td>Defines IP and subnet of Hotspot Network</td>
+
<td>Turns the Hotspot instance on or off.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
    <td>IP Adress</td>
+
<td>Hotspot Network</td>
        <td>ip; Default: '''192.168.2.254'''</td>
+
<td>ip/netmask; default: <b>{{#switch: {{{series}}} | #default = 192.168.2.0/24 | TRB1 | TRB2 | TRB5 | TRB2M = 192.168.3.0/24}}</b></td>
        <td>Defines the IP address of your Hotspot router in network</td>
+
<td>IP address and subnet of the Hotspot network.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>Authentication mode</td>
+
<td>IP Address</td>
      <td>Radius {{!}} Local user {{!}} {{#ifeq:{{{mobile}}}|1| SMS OTP {{!}}}} MAC auth ; Default: '''Local users'''</td>
+
<td>ip; default: '''{{#switch: {{{series}}} | #default = 192.168.2.254 | TRB1 | TRB2 | TRB5 | TRB2M = 192.168.3.254}}'''</td>
      <td>Authentication mode defines how users will connect to the Hotspot</td>
+
<td>Defines the IP address of your Hotspot router in network.</td>
    </tr><tr><td>Allow signup
  −
</td><td>off | on; Default: '''off'''</td><td>Allows users to sign up to hotspot via landing page.</td></tr><tr>
  −
        <td>Landing Page</td>
  −
        <td>Internal {{!}} External; Default: '''Internal'''</td>
  −
        <td>If external Landing Page is chosen, new section, to enter website address, will appear, e.g. http://www.example.com</td>
   
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
        <td>UAM Port</td>
+
<td>Authentication mode</td>
        <td>integer; Default: '''3990'''</td>
+
<td>Radius | Local user | {{#ifeq:{{{mobile}}}|1|SMS OTP <nowiki>|</nowiki> |}}MAC auth ; default: <b>Local users</b></td>
        <td>Port to bind for authenticating clients</td>
+
<td>Authentication mode defines how users will connect to the Hotspot.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
        <td>UAM Secret</td>
+
<td>Allow signup</td>
        <td>string; Default: " "</td>
+
<td>off | <span style="color: #20C0D7;"><b>on</b></span>; default: <b>off</b></td>
        <td>Shared secret between uamserver and hotspot.</td>
+
<td>Allows users to sign up to hotspot via landing page.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
        <td>Success page</td>
+
<td><span style="color: #20C0D7;">Expiration time</span></td>
        <td>Success Page {{!}} Original URL {{!}} Custom; Default: '''Success page'''</td>
+
<td>integer; default: <b>0</b></td>
        <td>Location to return to after successful authentication</td>
+
<td>User credential expiration time. Applies to users who signed up via landing page.</td>
 +
    </tr>
 +
    <tr>
 +
<td><span style="color: #20C0D7;">Users group</span></td>
 +
<td>user group; default: <b>default</b></td>
 +
<td>The user group to which users signed up via landing page should be assigned to.</td>
 +
    </tr>
 +
    <tr>
 +
<td>Landing Page</td>
 +
<td>Internal | <span style="color: #f43b1a;">External</span>; default: <b>Internal</b></td>
 +
<td>If external Landing Page is chosen, new section, to enter website address, will appear, e.g., <i><nowiki>http://www.example.com</nowiki></i></td>
 +
    </tr>
 +
    <tr>
 +
<td>UAM Port</td>
 +
<td>integer; default: <b>3990</b></td>
 +
<td>Port to bind for authenticating clients.</td>
 +
    </tr>
 +
    <tr>
 +
<td><span style="color: #f43b1a;">UAM Secret</span></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: <b>Success page</b></td>
 +
<td>Location to return to after successful authentication.</td>
 
     </tr>
 
     </tr>
 
</table>
 
</table>
   −
====Advanced====
+
=====Advanced=====
 
----
 
----
 
+
[[File:Networking_rutos_manual_hotspot_general_hotspot_instances_general_settings_advanced.png|border|class=tlt-border]]
[[File:Network_rutxxx_manual_hotspot_advanced_settings_radius.png]]
      
<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>
+
<th>Field</th>
    <td>Logout address</td>
+
<th>Value</th>
        <td>ip; Default: '''1.0.0.0'''</td>
+
<th>Description</th>
        <td>An address that can be used by users to logout from the Hotspot session</td>
   
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
        <td>Protocol</td>
+
<td>Additional interfaces</td>
        <td>HTTP {{!}} HTTPS; Default: '''HTTP'''</td>
+
<td>Available interfaces; default: '''none'''</td>
        <td>Protocol to be used for landing page</td>
+
<td>Shows additional interfaces that can be attached to hotspot instance.</td>
    </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.
  −
</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>
 
     <tr>
 
     <tr>
    <td>DNS server 1</td>
+
<td>Logout address</td>
        <td>ip; Default: '''8.8.8.8'''</td>
+
<td>ip; default: '''1.0.0.0'''</td>
        <td>Additional DNS servers that are to be used by the Hotspot.</td>
+
<td>An address that can be used by users to logout from the Hotspot session.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
    <td>DNS server 2</td>
+
<td>Protocol</td>
        <td>ip; Default: '''8.8.4.4'''</td>
+
<td>HTTP | HTTPS; default: <b>HTTP</b></td>
        <td>Additional DNS servers that are to be used by the Hotspot.</td>
+
<td>Protocol to be used for landing page.</td>
     </tr></table>
+
     </tr>
 
  −
====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_radius.png]]
  −
 
  −
<table class="nd-mantable">
   
     <tr>
 
     <tr>
    <td>RADIUS server #1</td>
+
<td>Enable TOS</td>
        <td>ip; Default: " "</td>
+
<td>off | on; default: <b>off</b></td>
        <td>The IP address of the RADIUS server #1 that is to be used for Authenticating your wireless clients </td>
+
<td>Enables Terms of Service (ToS) requirement. Client device will be able to access the Internet only after agreeing ToS.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
    <td>RADIUS server #2</td>
+
<td>Trial access</td>
        <td>ip; Default: " "</td>
+
<td>off | <span style="color: #f43b1a; font-weight: bold;">on</span>; default: <b>off</b></td>
        <td>The IP address of the RADIUS server #2 that is to be used for Authenticating your wireless clients </td>
+
<td>Enables trial internet access for a specific group.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>Authentication port</td>
+
<td><span style="color: #f43b1a;">Trial access</span>: Group</td>
      <td>integer [0..65535]; Default: '''1812'''</td>
+
<td>User group; default: <b>default</b></td>
      <td>RADIUS server authentication port</td>
+
<td>Group of trial users.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>Accounting port</td>
+
<td>HTTPS to landing page redirect</td>
      <td>integer [0..65535]; Default: '''1813''' </td>
+
<td>off | <span style="color: #20C0D7;"><b>on</b></span>; default: <b>off</b></td>
      <td>RADIUS server accounting port</td>
+
<td>Redirect initial pre-landing page HTTPS requests to hotspot landing page.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
    <td>NAS identifier</td>
+
<td><span style="color: #20C0D7;"><b>Certificate files from device</b></span></td>
        <td>string; Default: " "</td>
+
<td>off | on; default: <b>off</b></td>
        <td>NAS-Identifier is one of the basic RADIUS attributes</td>
+
<td>Specified whether to upload key & certificate files from computer or to use files generated on this device via the <i>System → Administration → <b>[[{{{name}}} Administration#Certificates|Certificates]]</b></i> page.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
    <td>Radius secret key</td>
+
<td><span style="color: #20C0D7;">SSL key file</span></td>
        <td>string; Default: " "</td>
+
<td>key file; default: <b>none</b></td>
        <td>The secret key is a password used for authentication with the RADIUS server</td>
+
<td>Upload/select SSL key.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>Swap octets</td>
+
<td><span style="color: #20C0D7;">SSL certificate file</span></td>
      <td>off {{!}} on; Default: '''off'''</td>
+
<td>certificate file; default: <b>none</b></td>
      <td>Swaps the meaning of input octets and output as it relates to RADIUS attributes</td>
+
<td>Upload/select SSL certificate.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
    <td>Location name</td>
+
<td>DNS server 1</td>
        <td>string; Default: " "</td>
+
<td>ip; default: <b>8.8.8.8</b></td>
        <td>Custom location name for your Hotspot</td>
+
<td>Additional DNS servers that are to be used by the Hotspot.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
    <td>Location ID</td>
+
<td>DNS server 2</td>
        <td>string; Default: " "</td>
+
<td>ip; default: <b>8.8.4.4</b></td>
        <td>Custom location ID for your Hotspot</td>
+
<td>Additional DNS servers that are to be used by the Hotspot.</td>
 
     </tr>
 
     </tr>
 
</table>
 
</table>
   −
====Walled Garden====
+
=====Radius=====
----
  −
 
  −
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]]
  −
 
  −
====User Scripts====
   
----
 
----
 +
<b>Radius</b> 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.
   −
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.
+
[[File:Networking_rutos_manual_hotspot_general_hotspot_instances_general_settings_radius.png|border|class=tlt-border]]
 
  −
[[File:Network_rutxxx_manual_hotspot_user_scripts_radius.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.png]]
      
<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>
 +
<td>RADIUS server #1</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>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>Name</td>
+
<td>RADIUS server #2</td>
      <td>string; Default: " "</td>
+
<td>ip; default: <b>none</b></td>
      <td>A custom user name used to authenticate clients connecting to the Hotspot</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>Password</td>
+
<td>Authentication port</td>
      <td>string; Default: " "</td>
+
<td>integer [0..65535]; default: <b>1812</b></td>
      <td>A custom password for the specified user name</td>
+
<td>RADIUS server authentication port.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
    <td>Group</td>
+
<td>Accounting port</td>
        <td>string; Default: '''default'''</td>
+
<td>integer [0..65535]; default: <b>1813</b> </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>RADIUS server accounting port.</td>
 +
    </tr>
 +
    <tr>
 +
<td>NAS identifier</td>
 +
<td>string; default: <b>none</b></td>
 +
<td>NAS-Identifier is one of the basic RADIUS attributes.</td>
 +
    </tr>
 +
    <tr>
 +
<td>Radius secret key</td>
 +
<td>string; default: <b>none</b></td>
 +
<td>The secret key is a password used for authentication with the RADIUS server.</td>
 +
    </tr>
 +
    <tr>
 +
<td>Swap octets</td>
 +
<td>off | on; default: <b>off</b></td>
 +
<td>Swaps the meaning of input octets and output as it relates to RADIUS attributes.</td>
 +
    </tr>
 +
    <tr>
 +
<td>Location name</td>
 +
<td>string; default: <b>none</b></td>
 +
<td>Custom location name for your Hotspot.</td>
 +
    </tr>
 +
    <tr>
 +
<td>Location ID</td>
 +
<td>string; default: <b>none</b></td>
 +
<td>Custom location ID for your Hotspot.</td>
 
     </tr>
 
     </tr>
 
</table>
 
</table>
   −
==User Groups==
+
=====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 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.
+
Format of address is <b>website.com</b> (does not include https://www).
   −
[[File:Network_rutxxx_manual_hotspot_user_groups.png]]
+
[[File:Networking_rutos_manual_hotspot_general_hotspot_instances_general_settings_walled_garden.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.
+
=====URL Parameters=====
 +
----
 +
The <b>URL parameters</b> section becomes visible when <b>Landing page</b> is selected as <b>External</b> in [[{{{name}}}_Hotspot#General_2|General settings]] section.
   −
[[File:Network_rutxxx_manual_hotspot_user_group_settings.png]]
+
[[File:Networking_rutos_manual_hotspot_general_hotspot_instances_general_settings_urlparams.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>UAM IP</td>
      <td>integer; Default: " "</td>
+
<td>string; 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>The IP Address of the Captive Portal gateway.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>Time limit</td>
+
<td>UAM port</td>
      <td>integer; Default: " "</td>
+
<td>string; default: <b>none</b></td>
      <td>Disables hotspot user after time limit in sec is reached. (0, meaning unlimited)</td>
+
<td>The port on which the Captive Portal will serve web content.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
    <td>Download bandwidth</td>
+
<td>Called</td>
        <td>integer; Default: " "</td>
+
<td>string; 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>The MAC address of the IP Address of the Captive Portal gateway.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
    <td>Upload bandwidth</td>
+
<td>MAC</td>
        <td>integer; Default: " "</td>
+
<td>string; default: <b>none</b></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>The MAC address of the client trying to gain Internet access.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>Download limit</td>
+
<td>NAS id</td>
      <td>integer; Default: " "</td>
+
<td>string; default: <b>none</b></td>
      <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>An identification for the Captive Portal used in the RADIUS request.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>Upload limit</td>
+
<td>Session id</td>
      <td>integer; Default: " "</td>
+
<td>string; default: <b>none</b></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>
+
<td>The unique identifer for session.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
    <td>Period</td>
+
<td>User url</td>
        <td>Month {{!}} Week {{!}} Day; Default: '''Month'''</td>
+
<td>string; default: <b>none</b></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>
+
<td>The URL which the user tried to access before he were redirected to the Captive Portal's URL's pages.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
    <td>Start day</td>
+
<td>Challenge</td>
        <td>integer [1..31] {{!}} Monday..Sunday {{!}} integer [1..24]; Default: '''1'''</td>
+
<td>string; default: <b>none</b></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>A challenge that should be used together with the user's password to create an encrypted phrase used to log on.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
    <td>Expiration time</td>
+
<td>Custom 1</td>
        <td>integer; Default: '''0'''</td>
+
<td>string; default: <b>none</b></td>
        <td>Expiration time in sec (0 means unlimited). Only for dynamically created users.</td>
+
<td>Add custom name and custom value which will be displayed in url parameters.</td>
 +
    </tr>
 +
    <tr>
 +
<td>-</td>
 +
<td>SSID | Hostname | FW version | --Custom--; default: <b>SSID</b></td>
 +
<td>-</td>
 +
    </tr>
 +
    <tr>
 +
<td>Custom 2</td>
 +
<td>string; default: <b>none</b></td>
 +
<td>Add custom name and custom value which will be displayed in url parameters.</td>
 +
    </tr>
 +
    <tr>
 +
<td>-</td>
 +
<td>SSID | Hostname | FW version | --Custom--; default: <b>SSID</b></td>
 +
<td>-</td>
 
     </tr>
 
     </tr>
 
</table>
 
</table>
 +
 +
=====User Scripts=====
 +
----
 +
In this section you can add custom <b>Scripts</b> that will be executed after a session is authorized in the <b>Session up</b> section, after session has moved from authorized state to unauthorized in the <b>Session down</b> section and after a new user has been signed up in the <b>User signup</b> section.
 +
 +
[[File:Networking_rutos_manual_hotspot_general_hotspot_instances_general_settings_user_scripts.png|border|class=tlt-border]]
 +
 +
==Local Users==
 +
 +
The <b>Local Users</b> 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.
 +
 +
<ol>
 +
    <li>Entering a Username, Password and clicking the 'Add' button creates a new user.</li>
 +
    <li>The 'Group' dropdown menu assigns a user to another group.</li>
 +
    <li>The 'Edit' button lets you change a user's password or assign the user to another group.</li>
 +
    <li>The 'Delete[X]' button deletes a user.</li>
 +
</ol>
 +
 +
[[File:Networking_rutos_manual_hotspot_local_users_add_button_edit_button.png|border|class=tlt-border]]
    
==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 <b>Landing Page</b> will look like to connecting users.
    
===General Settings===
 
===General Settings===
 
----
 
----
'''General Settings''' section lets you choose authentication protocol that will be used in Landing Page.
+
<b>General Settings</b> section lets you choose the authentication protocol and theme that will be used in the Landing Page. You can download more themes using the [[{{{name}}}_Package_Manager|Package Manager]]
   −
[[File:Network_rutxxx_manual_hotspot_landing_page_general_v1.png|border|class=tlt-border]]
+
[[File:Networking_rutos_manual_hotspot_landing_page_general_settings_v1.png|border|class=tlt-border]]
    
===Themes===
 
===Themes===
 
----
 
----
The <b>Themes</b> section shows all available landing page themes and allows you to edit them.
+
The <b>Themes</b> section displays all available Landing Page themes. In order to download a theme, click the 'Download' button, in order to edit a theme, click the 'Edit' button next to it.
   −
[[File:Network_rutxxx_manual_hotspot_landing_page_themes_v1.png|border|class=tlt-border]]
+
[[File:Networking_rutos_manual_hotspot_landing_page_themes__download_edit_button.png|border|class=tlt-border]]
    
====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:Networking_rutos_manual_hotspot_landing_page_themes_images.png|border|class=tlt-border]]
   −
====Style settings====
+
====Style Settings====
 
----
 
----
   −
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:Networking_rutos_manual_hotspot_landing_page_themes_style_settings.png|border|class=tlt-border]]
   −
====View settings====
+
====View Settings====
 
----
 
----
 +
In <b>View Settings</b> you can access and modify default templates for various parts of landing page and edit their HTML code.
 +
 +
[[File:Networking_rutos_manual_hotspot_landing_page_themes_view_settings.png|border|class=tlt-border]]
 +
 +
====Custom Theme====
 +
----
 +
To use custom theme you can download default theme and edit it's content. Then use upload button to upload it.
 +
 +
[[File:Networking rutos manual hotspot landing page themes upload custom v1.png|border|class=tlt-border]]
 +
 +
==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
 +
 +
<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>
 +
 +
[[File:Networking_rutos_manual_hotspot_user_groups_edit_button.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_v2.png|border|class=tlt-border]]
 +
 +
<table class="nd-mantable">
 +
    <tr>
 +
        <th>Field</th>
 +
        <th>Value</th>
 +
        <th>Description</th>
 +
    </tr>
 +
    <tr>
 +
        <td>Idle timeout</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>
 +
    </tr>
 +
    <tr>
 +
        <td>Time limit</td>
 +
        <td>integer; default: <b>none</b></td>
 +
        <td>Disables hotspot user after time limit in sec is reached. (0, meaning unlimited)</td>
 +
    </tr>
 +
    <tr>
 +
        <td>Download bandwidth</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 Mbit/s.</td>
 +
    </tr>
 +
    <tr>
 +
        <td>Upload bandwidth</td>
 +
        <td>integer; default: <b>none</b></td>
 +
        <td>Maximum upload bandwidth that the users assigned to this template can achieve. Bandwidth can be specified in Mbit/s.</td>
 +
    </tr>
 +
    <tr>
 +
        <td>Download limit</td>
 +
        <td>integer; default: <b>none</b></td>
 +
        <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>Upload limit</td>
 +
        <td>integer; default: <b>none</b></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>
 +
        <td>Warning</td>
 +
        <td>integer; default: <b>none</b></td>
 +
        <td>Send an SMS warning to hotspot user after warning value of download or upload data in MB is reached. Only works with SMS OTP authentication.</td>
 +
    </tr>
 +
    <tr>
 +
        <td>Period</td>
 +
        <td>Month | Week | Day; default: <b>Month</b></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>
 +
        <td>Start day</td>
 +
        <td>integer [1..31] | Monday..Sunday | integer [1..24]; default: <b>1</b></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>
 +
    </tr>
 +
</table>
 +
 +
==User Management==
 +
 +
The <b>Current Hotspot Users</b> tab displays the status and session statistics of currently logged in users. You can also "kick" (deauthenticate) a user by clicking the 'Logout' button next to it.
   −
In view settings you can access and modify default templates for various parts of landing page and edit their HTML code.
+
[[File:Networking_rutos_manual_hotspot_user_management_current_hotspot_users.png|border|class=tlt-border]]
   −
[[File:Network_rutxxx_manual_hotspot_landing_page_themes_view_settings_v1.png|border|class=tlt-border]]
     −
==User management==
+
The <b>Registered Hotspot Users</b> tab displays the data of unique users that have registered to the hotspot before.
   −
The <b>User management</b> section allows you to manage currently logged in users.
+
[[File:Networking_rutos_manual_hotspot_user_management_registered_hotspot_users.png|border|class=tlt-border]]
   −
[[File:Network_rutxxx_manual_hotspot_landing_page_user_management_v1.png|border|class=tlt-border]]
+
{{#switch: {{{series}}} | TRB1 | TRB2 | TRB5 | RUT30X | TAP100 | TAP200 | OTD140 | TRB2M | RUT301 =
 +
| RUTX | RUTM | RUT36X | TCR1 | RUT9 | RUT9M | RUT2 | RUT2M | RUT361 | #default = {{#switch: {{{name}}} | RUTX08 | RUTX09 | RUTM08 | RUTM09 = | #default =
 +
{{Template:Networking_rutos_manual_hotspot_2.0
 +
| series = {{{series}}}
 +
| name = {{{name}}}
 +
| wifi = {{{wifi}}}
 +
}}}}}}
    
[[Category:{{{name}}} Services section]]
 
[[Category:{{{name}}} Services section]]

Navigation menu