Line 1: |
Line 1: |
− | {{Template:Networking_rutos_manual_fw_disclosure | + | {{Template: Networking_rutos_manual_fw_disclosure |
− | | fw_version = {{{series}}}_R_00.02.04.1 | + | | fw_version ={{Template: Networking_rutos_manual_latest_fw |
− | | series = {{{series}}} | + | | 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_rutos_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_rutos_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. | | 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 = |
| + | <u><b> |
| + | |
| + | Note:</b> Hotspot is additional software that can be installed from the <b>Services → [[{{{name}}} Package Manager|Package Manager]]</b> page.</u> |
| + | }} |
| | | |
| ==General== | | ==General== |
Line 17: |
Line 27: |
| <li>select an 'Interface';</li> | | <li>select an 'Interface';</li> |
| <li>click the 'Add' button;</li> | | <li>click the 'Add' button;</li> |
− | <li>click the 'Edit' button next to the newly added Hotspot instance.</li>
| |
| </ol> | | </ol> |
| | | |
| [[File:Networking_rutos_manual_hotspot_hotspot_instances_add_button_edit_buton_wifi_{{{wifi}}}.png|border|class=tlt-border]] | | [[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. | + | After this, a new Hotspot configuration window will appear. |
| | | |
| ====General Settings==== | | ====General Settings==== |
Line 30: |
Line 39: |
| =====General===== | | =====General===== |
| ---- | | ---- |
− | [[File:Networking_rutos_manual_hotspot_general_hotspot_instances_general_settings_general.png|border|class=tlt-border]] | + | [[File:Networking_rutos_manual_hotspot_general_hotspot_instances_general_settings_general_v2.png|border|class=tlt-border]] |
| | | |
| <table class="nd-mantable"> | | <table class="nd-mantable"> |
Line 37: |
Line 46: |
| <th>Value</th> | | <th>Value</th> |
| <th>Description</th> | | <th>Description</th> |
| + | </tr> |
| + | <tr> |
| + | <td>Configuration profile</td> |
| + | <td>Cloud4wi | Default | Hotspotsystems; default: <b>Default</b></td> |
| + | <td>Pre-configures Hotspot settings according to the selected service provider.</td> |
| </tr> | | </tr> |
| <tr> | | <tr> |
Line 60: |
Line 74: |
| <tr> | | <tr> |
| <td>Allow signup</td> | | <td>Allow signup</td> |
− | <td>off | on; default: <b>off</b></td> | + | <td>off | <span style="color: #20C0D7;"><b>on</b></span>; default: <b>off</b></td> |
| <td>Allows users to sign up to hotspot via landing page.</td> | | <td>Allows users to sign up to hotspot via landing page.</td> |
| + | </tr> |
| + | <tr> |
| + | <td><span style="color: #20C0D7;">Expiration time</span></td> |
| + | <td>integer; default: <b>0</b></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> |
| <tr> | | <tr> |
| <td>Landing Page</td> | | <td>Landing Page</td> |
− | <td>Internal | External; default: <b>Internal</b></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> | | <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> |
Line 74: |
Line 98: |
| </tr> | | </tr> |
| <tr> | | <tr> |
− | <td>UAM Secret</td> | + | <td><span style="color: #f43b1a;">UAM Secret</span></td> |
| <td>string; default: <b>none</b></td> | | <td>string; default: <b>none</b></td> |
| <td>Shared secret between uamserver and hotspot.</td> | | <td>Shared secret between uamserver and hotspot.</td> |
Line 117: |
Line 141: |
| <tr> | | <tr> |
| <td>Trial access</td> | | <td>Trial access</td> |
− | <td>off | on; default: <b>off</b></td> | + | <td>off | <span style="color: #f43b1a; font-weight: bold;">on</span>; default: <b>off</b></td> |
| <td>Enables trial internet access for a specific group.</td> | | <td>Enables trial internet access for a specific group.</td> |
| </tr> | | </tr> |
| <tr> | | <tr> |
− | <td><span style="color: tomato;">Trial access: </span>Group</td> | + | <td><span style="color: #f43b1a;">Trial access</span>: Group</td> |
− | <td>User group; default: <b>default<b/>td> | + | <td>User group; default: <b>default</b> |
| <td>Group of trial users.</td> | | <td>Group of trial users.</td> |
| </tr> | | </tr> |
| <tr> | | <tr> |
| <td>HTTPS to landing page redirect</td> | | <td>HTTPS to landing page redirect</td> |
| + | <td>off | <span style="color: #20C0D7;"><b>on</b></span>; default: <b>off</b></td> |
| + | <td>Redirect initial pre-landing page HTTPS requests to hotspot landing page.</td> |
| + | </tr> |
| + | <tr> |
| + | <td><span style="color: #20C0D7;"><b>Certificate files from device</b></span></td> |
| <td>off | on; default: <b>off</b></td> | | <td>off | on; default: <b>off</b></td> |
− | <td>Redirect initial pre-landing page HTTPS requests to hotspot landing page.</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> |
| + | <td><span style="color: #20C0D7;">SSL key file</span></td> |
| + | <td>key file; default: <b>none</b></td> |
| + | <td>Upload/select SSL key.</td> |
| + | </tr> |
| + | <tr> |
| + | <td><span style="color: #20C0D7;">SSL certificate file</span></td> |
| + | <td>certificate file; default: <b>none</b></td> |
| + | <td>Upload/select SSL certificate.</td> |
| </tr> | | </tr> |
| <tr> | | <tr> |
Line 149: |
Line 188: |
| | | |
| <table class="nd-mantable"> | | <table class="nd-mantable"> |
| + | <tr> |
| + | <th>Field</th> |
| + | <th>Value</th> |
| + | <th>Description</th> |
| + | </tr> |
| <tr> | | <tr> |
| <td>RADIUS server #1</td> | | <td>RADIUS server #1</td> |
Line 198: |
Line 242: |
| =====Walled Garden===== | | =====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. | + | 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. |
| + | |
| + | Format of address is <b>website.com</b> (does not include https://www). |
| | | |
| [[File:Networking_rutos_manual_hotspot_general_hotspot_instances_general_settings_walled_garden.png|border|class=tlt-border]] | | [[File:Networking_rutos_manual_hotspot_general_hotspot_instances_general_settings_walled_garden.png|border|class=tlt-border]] |
| | | |
− | =====User Scripts===== | + | =====URL Parameters===== |
| ---- | | ---- |
− | In this tab you can add Scripts 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 tge <b>Session down</b> section and after a new user has been signed up in the <b>User signup</b> section.
| + | 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:Networking_rutos_manual_hotspot_general_hotspot_instances_general_settings_user_scripts.png|border|class=tlt-border]] | |
− | | |
− | ==Local Users==
| |
− | | |
− | The <b>Users Configuration</b> tab is used to create new, unique users that can connect to the Hotspot.
| |
| | | |
− | [[File:Network_rutxxx_manual_hotspot_local_users_v1.png|border|class=tlt-border]] | + | [[File:Networking_rutos_manual_hotspot_general_hotspot_instances_general_settings_urlparams.png|border|class=tlt-border]] |
| | | |
| <table class="nd-mantable"> | | <table class="nd-mantable"> |
Line 221: |
Line 262: |
| </tr> | | </tr> |
| <tr> | | <tr> |
− | <td>Name</td> | + | <td>UAM IP</td> |
| + | <td>string; default: <b>none</b></td> |
| + | <td>The IP Address of the Captive Portal gateway.</td> |
| + | </tr> |
| + | <tr> |
| + | <td>UAM port</td> |
| + | <td>string; default: <b>none</b></td> |
| + | <td>The port on which the Captive Portal will serve web content.</td> |
| + | </tr> |
| + | <tr> |
| + | <td>Called</td> |
| + | <td>string; default: <b>none</b></td> |
| + | <td>The MAC address of the IP Address of the Captive Portal gateway.</td> |
| + | </tr> |
| + | <tr> |
| + | <td>MAC</td> |
| + | <td>string; default: <b>none</b></td> |
| + | <td>The MAC address of the client trying to gain Internet access.</td> |
| + | </tr> |
| + | <tr> |
| + | <td>NAS id</td> |
| + | <td>string; default: <b>none</b></td> |
| + | <td>An identification for the Captive Portal used in the RADIUS request.</td> |
| + | </tr> |
| + | <tr> |
| + | <td>Session id</td> |
| <td>string; default: <b>none</b></td> | | <td>string; default: <b>none</b></td> |
− | <td>A custom user name used to authenticate clients connecting to the Hotspot.</td> | + | <td>The unique identifer for session.</td> |
| </tr> | | </tr> |
| <tr> | | <tr> |
− | <td>Password</td> | + | <td>User url</td> |
| <td>string; default: <b>none</b></td> | | <td>string; default: <b>none</b></td> |
− | <td>A custom password for the specified user name.</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>Group</td> | + | <td>Challenge</td> |
− | <td>string; default: <b>default</b></td> | + | <td>string; default: <b>none</b></td> |
− | <td>After adding user select group that it will be assigned to. Group describes connection speeds and download/upload limits. The 'default' group settings have no restrictions. More on User Groups in the next section.</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> |
| + | <td>Custom 1</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> |
| + | <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 Groups== | + | =====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. |
| | | |
− | <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.
| + | [[File:Networking_rutos_manual_hotspot_general_hotspot_instances_general_settings_user_scripts.png|border|class=tlt-border]] |
| | | |
− | [[File:Network_rutxxx_manual_hotspot_user_groups_v1.png|border|class=tlt-border]]
| + | ==Local Users== |
| | | |
− | After adding a group it will not have any limits set, so press edit [[File:Networking rutx manual edit button v1.png]].
| + | 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. |
− | 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]] | + | <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> |
| | | |
− | <table class="nd-mantable">
| + | [[File:Networking_rutos_manual_hotspot_local_users_add_button_edit_button.png|border|class=tlt-border]] |
− | <tr>
| |
− | <th>field name</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 Kbit/s or 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
| |
− | Kbit/s or 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>Period</td>
| |
− | <td>Month {{!}} Week {{!}} Day; default: '''Month'''</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: '''1'''</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>
| |
− | <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>
| |
| | | |
| ==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.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 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_edit_button.png|border|class=tlt-border]] |
| | | |
| ====Images==== | | ====Images==== |
Line 328: |
Line 362: |
| 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==== |
| ---- | | ---- |
| | | |
Line 336: |
Line 370: |
| landing page will look visually using CSS syntax. | | 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]] |
| + | |
| + | ==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]] |
| | | |
− | In view settings you can access and modify default templates for various parts of landing page and edit their HTML code.
| + | A group's settings page will look similar to this: |
| | | |
− | [[File:Network_rutxxx_manual_hotspot_landing_page_themes_view_settings_v1.png|border|class=tlt-border]] | + | [[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== | + | ==User Management== |
| | | |
− | The <b>User management</b> section allows you to manage currently logged in users. | + | The <b>User management</b> section 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. |
| | | |
− | [[File:Network_rutxxx_manual_hotspot_landing_page_user_management_v1.png|border|class=tlt-border]] | + | [[File:Networking_rutos_manual_hotspot_user_management.png|border|class=tlt-border]] |
| | | |
| [[Category:{{{name}}} Services section]] | | [[Category:{{{name}}} Services section]] |