Site Tools


splashd

Differences

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

Link to this comparison view

Next revision
Previous revision
splashd [2022/01/05 12:56] – created rs232splashd [2024/04/28 15:21] (current) – -formatting hogwild
Line 1: Line 1:
 ====== Captive Portal ====== ====== Captive Portal ======
  
-The **Captive Portal** module is called NoCatSplash. Older versions were named NoCatAuth. The Captive Portal works similarly to a\\  Wi-Fi hotspot in a public place.+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.
  
-Captive Portal presents users with a simple webpage, prompting them to agree to certain terms before they are allowed access to the network. If the user clisk on "**OK, I agree!**", the gateway daemon then changes the firewall rules on the gateway to pass traffic for that client (based on IP address and MAC address)This prevents users from accessing the Internet automatically without agreeing to certain terms of usage.+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 usage. The requirements are simple and can also be useful in situations where you simply want to give people an idea whose network they are using. (Default: Disabled).+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).
  
- \\ +**Enable function:** Checking this (and Save) makes FreshTomato users see a Welcome banner when they try to access the Internet. 
-[[https://wiki.freshtomato.org/lib/exe/detail.php?id=captive_portal&media=f81bc4e3e20ed262717281fd5a2e57b4.png|{{:f81bc4e3e20ed262717281fd5a2e57b4.png}}]]+ 
 +**Interface:** Selects one of the bridge interfaces on which Captive Portal will listen for connections. 
 + 
 +**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}}]]
  
  \\  \\
-**Enable function:** Checking this and clicking Save will make 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.+**Captive Site Forwarding:** Forces the "homepage" (see definition below) to appear until the user agrees to the Welcome Banner terms.
  
-**Gateway Name:** The name of the gateway that will appear in the Welcome banner.+**Home page:** This is the URL that will appear after the user agrees to the Welcome Banner terms.
  
-**Captive Site Forwarding:** When active, the 'homepage' (see definition below) will appear the user agrees to the terms in the Welcome Banner.+**Welcome html Path:** This is the path to the location of the Welcome banner .html page.
  
-**Home page:** The URL that will appear after the user agrees to the Welcome Banner terms.+**Logged Timeout:** The time period (seconds) during which no Welcome banner appears when you access the device. (Default: 3600s).
  
-**Welcome html Path:** The location of the Welcome banner .html page.+**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.
  
-**Logged Timeout:** The time period (in seconds) during which no Welcome banner will appear when you access the device. (Default: 3600s = 1 hour).+**Max Missed ARP:** How many times a client can be missing from the ARP cache before the connection is closed. (Default: 5).
  
-**Idle Timeout:** The time period, (seconds) before the client sees the splash screen again, and is forced to click 'I Agree' to the terms again to regain network access.+**Log Info Level:** How much detail will be included in log messages from this module.
  
-**Max Missed ARP:** The number of times a client can be missing from the ARP cache before the connection is closed. (Default: 5).+  Level 0=Silent.  
 +  Level 10=Verbose.
  
-**Log Info Level:** How much detail will be included in log messages from this module. Level 0=Silent, 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:** This is the port to be used by the Captive Portal for page redirection. (Ports 1 to 65534). (Default: 5280).
Line 35: Line 42:
 **Excluded/Included ports to be redirected: **Here, enter the port numbers you wish to be: **Excluded/Included ports to be redirected: **Here, enter the port numbers you wish to be:
  
-  * Included (defines which port numbers the user is allowed to use after login) or; +  * Included (defines port numbers the user is allowed to use after login) or; 
-  * Excluded (defines which port numbers the user //is not//  allowed to use after login and which FreshTomato redirects away from the client).+  * Excluded (defines port numbers the user //is not//  allowed to use after login) \\ and which FreshTomato redirects away from the client).
  
-Leave blank spaces between port numbers when configuring them. For example: "25 110 4662 4672".+ \\
  
-Using both Included and Excluded ports at the same time is not recommended. This can cause conflicts about which ports are allowed or not.+Leave blank spaces between port numbers when configuring them.
  
-**URL excluded off the portal:**  URLs/links that can be accessed without the Welcome banner screen appearing. When entering allowed URLs, \\ leave spaces between URLs. For example: [[http://www.google.com|www.google.com]] [[http://www.google.es|www.google.es]]+Using Included //and// Excluded ports at the same time is not advisedIt can cause conflicts relating to whether ports are allowed or not.
  
-**MAC address whitelist:**  Here, you enter the MAC addresses of network clients that will be excluded from the Portal functionsThese devices will have no barriers to Internet access. Leave spaces between MAC Addresses.+**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.
  
-**Customized Splash File Path:**  Here you can upload your personal Welcome banner that will overrride the default one.+**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.
  
-**WARNING: If Login Time expires, you must return to the splash page to regain network access. **\\ **After you click "OK, I Agree!", nothing indicates when your usage period will expire. **\\ **You may lose Internet Access without warning.**+**Customized Splash File Path:**  Here you can upload a personal Welcome banner which will override the default one. 
 + 
 + \\ 
 + 
 +**WARNING: If the Login Time expires, you must return to the splash page to regain network access. **\\ **After you click "OK, I Agree!", nothing indicates when your usage period will expire. **\\ **You may lose Internet Access without warning.** 
 + 
 + \\ [[https://wiki.freshtomato.org/lib/exe/detail.php?id=captive_portal&media=c89968d019cda7d23009f7f6051b8e89.png|{{:c89968d019cda7d23009f7f6051b8e89.png}}]] 
 + 
 + \\ 
 + 
 + \\
  
  \\  \\
-[[https://wiki.freshtomato.org/lib/exe/detail.php?id=captive_portal&media=c89968d019cda7d23009f7f6051b8e89.png|{{:c89968d019cda7d23009f7f6051b8e89.png}}]] 
  
  
splashd.1641387379.txt.gz · Last modified: 2022/01/05 12:56 by rs232