Site Tools


splashd

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
splashd [2024/04/28 15:21] – -formatting hogwildsplashd [2024/11/27 02:10] (current) hogwild
Line 1: Line 1:
 ====== Captive Portal ====== ====== Captive Portal ======
  
-The Captive Portal works in a similar way to a WiFi hotspot in a public place. Captive Portal presents WiFi users with a simple webpage, prompting them to agree to terms before being allowed to access the network. If the user clicks on "**OK, I agree!**", the gateway daemon changes firewall rules on the gateway so that traffic passes for that client (based on its IP/MAC address). This prevents users from accessing the Internet without agreeing to certain Terms of Use.+The Captive Portal works in a similar way to a WiFi hotspot in a public place. It presents WiFi users with a simple webpage, and prompted to agree to terms before gaining access to the network. If the user clicks on "**OK, I agree!**", the gateway daemon changes firewall rules on the gateway and traffic passes for that client (based on its IP/MAC address). This prevents users from accessing the Internet without agreeing to Terms of Use. 
 + 
 + \\
  
 The Captive Portal module is called "NoCatSplash". Older versions were named "NoCatAuth". The Captive Portal module is called "NoCatSplash". Older versions were named "NoCatAuth".
  
-Captive Portal is ideal for public/semi-public networks to remind end users of the legal responsibilities linked to Internet access. The requirements are simple. That means it can also be useful in when you simply want people to know whose network they are using. (Default: Disabled).+Captive Portal is ideal for public/semi-public networksto remind users of the legal responsibilities linked to Internet access. The requirements are simple. That means it can also be useful when you simply want people to know whose network they are using. (Default: Disabled).
  
-**Enable function:** Checking this (and Save) makes FreshTomato users see a Welcome banner when they try to access the Internet.+ \\
  
-**Interface:** Selects one of the bridge interfaces on which Captive Portal will listen for connections.+**Enable function:** makes FreshTomato users see a Welcome banner when they try to access the Internet.
  
-**Gateway Name:** Here, specify the name of the gateway that will appear in the Welcome banner.+ \\
  
- \\  [[https://wiki.freshtomato.org/lib/exe/detail.php?id=captive_portal&media=f81bc4e3e20ed262717281fd5a2e57b4.png|{{:f81bc4e3e20ed262717281fd5a2e57b4.png}}]]+**Interface:** lets you select a bridge interface on which Captive Portal will listen for connections.
  
  \\  \\
  
-**Captive Site Forwarding:** Forces the "homepage" (see definition below) to appear until the user agrees to the Welcome Banner terms.+**Gateway Name:** lets you specify the name of the gateway to appear in the Welcome banner.
  
-**Home page:** This is the URL that will appear after the user agrees to the Welcome Banner terms.+ \\ [[https://wiki.freshtomato.org/lib/exe/detail.php?id=captive_portal&media=f81bc4e3e20ed262717281fd5a2e57b4.png|{{:f81bc4e3e20ed262717281fd5a2e57b4.png?406}}]]
  
-**Welcome html Path:** This is the path to the location of the Welcome banner .html page.+ \\
  
-**Logged Timeout:** The time period (seconds) during which no Welcome banner appears when you access the device. (Default: 3600s).+**Captive Site Forwarding:** makes the "homepage" appear until the user agrees to the Welcome Banner terms.
  
-**Idle Timeout:** The period, in seconds, before the client sees the splash screen again, and must agree to the terms again to regain network access.+ \\
  
-**Max Missed ARP:** How many times a client can be missing from the ARP cache before the connection is closed. (Default: 5).+**Home page:** the URL that will appear after the user agrees to the Welcome Banner terms.
  
-**Log Info Level:** How much detail will be included in log messages from this module.+ \\ 
 + 
 +**Welcome html Path:** the path to the location of the Welcome banner .html page. 
 + 
 + \\ 
 + 
 +**Logged Timeout:** the period (in seconds) during which no Welcome banner appears when you access the device. \\ (Default: 3600s). 
 + 
 + \\ 
 + 
 +**Idle Timeout:** the period, (seconds), before the client sees the splash screen again, and agrees to the terms again. 
 + 
 + \\ 
 + 
 +**Max Missed ARP:** how many times a client can be missing in the ARP cache before the connection is closed. \\ (Default: 5). 
 + 
 + \\ 
 + 
 +**Log Info Level:** specifies how much detail will be included in log messages from this module.
  
   * Level 0=Silent.    * Level 0=Silent. 
   * Level 10=Verbose.   * Level 10=Verbose.
  
-(Default: 2).+ \\ (Default: 2).
  
  \\  \\
  
-**Gateway Port:** This is the port to be used by the Captive Portal for page redirection. (Ports 1 to 65534). (Default: 5280).+**Gateway Port:** the port the Captive Portal will use for page redirection. (Ports 1 to 65534).
  
-**Excluded/Included ports to be redirected: **Here, enter the port numbers you wish to be:+(Default5280).
  
-  * Included (defines port numbers the user is allowed to use after login) or; + \\ 
-  Excluded (defines port numbers the user //is not//  allowed to use after login) \\ and which FreshTomato redirects away from the client).+ 
 +**Excluded/Included ports to be redirected: **the port numbers you wish to be either:
  
  \\  \\
  
-Leave blank spaces between port numbers when configuring them.+  * Included - defines port numbers a user is allowed to use after login 
 +  * Excluded - defines port numbers a user //is not//  allowed to use after login) \\ and which FreshTomato redirects away from the client).
  
-Using Included //and// Excluded ports at the same time is not advised. It can cause conflicts relating to whether ports are allowed or not.+ \\
  
-**URL excluded from the portal:**  Here, enter URLs or links that can be accessed without the Welcome screen appearing.  \\ URLs entries must be separated by spaces.+Separate port numbers with blank spaces when configuring them. Do not use Included //and// Excluded ports simultaneously. It can cause conflicts relating to whether ports are allowed or not.
  
-**MAC address whitelist:**  Here, enter the MAC addresses of clients to be excluded from Portal functions. \\ These devices will have no barriers to Internet access. MAC Addresses must be separated by spaces.+ \\ 
 + 
 +**URL excluded from the portal:**  enter URLs/links that can be accessed without the Welcome screen appearing.  \\ Entries must be separated by spaces. 
 + 
 + \\ 
 + 
 +**MAC address whitelist:**  enter the MAC addresses of clients to exclude from Portal functions. \\ These devices will have no barriers to Internet access. Entries must be separated by spaces. 
 + 
 + \\
  
-**Customized Splash File Path:**  Here you can upload a personal Welcome banner which will override the default one.+**Customized Splash File Path:** lets you upload a personal Welcome banner to override the default one.
  
  \\  \\
splashd.1714314094.txt.gz · Last modified: 2024/04/28 15:21 by hogwild