724-746-5500 | blackbox.com
Page 126
724-746-5500 | blackbox.com
Chapter 9: Common Configuration Examples
Foreground Color: The foreground color controls the color of the text that appears on the page. By default, it is white (RGB
255, 255, 255), which shows up clearly against the dark blue of the default background image smartpath_3d.jpg. If you
change the background image to something with lighter colors, such as blackbox_hex_light.jpg, you can make the foreground
color darker to provide greater contrast.
Header Image: This image file is empty and acts as a shim or spacer to offset the form from the top of the page. By default,
the head image is smartpath_spacer.png, and it is 200 x 103 px at 72 dpi. If you want to increase or decrease the space above
the form, you can replace this with a different .png file. The file format is Portable Network Graphics (PNG) because it supports
transparency. You can also replace it with a file containing an image if you prefer.
Footer Image: By default, this is a graphic of the Black Box logo. The file name is blackbox_logo_reverse.png and its
dimensions are 111 x 48 px at 72 dpi. If you replace this with a different image, make sure it has the same or nearly the same
dimensions to avoid distortion.
Use Policy: This is a text file that states the company policy for network usage. A user can view the policy by clicking the
"Acceptable Use Policy" link on the registration page during the captive web portal registration process. A generic policy is
provided in the "use-policy.txt" file. You can export this file, edit it, and import the edited file, or replace it with a completely
different file.
NOTE: You can check how your customizations affect page appearance by clicking Preview.
4. In a similar manner, you can also modify the automatically generated pages that appear after a successful login and after an
unsuccessful one. These pages appear after a user successfully registers or fails to register. The file names are success.html and
failure.html and are called by the internal script reg.php. The background image, foreground color, header image, and footer
image function similarly to those on the Login page. You can specify the same images or different ones on the result pages,
and you can use preloaded images or import others to use instead.
NOTICE: The main difference between the success page and the login page is the notice that is displayed to users. By default, the
notice is “You are now connected to the wireless network.” You can modify this to a different message as long as it has
fewer than 256 characters. You can click inside the text box and edit the text on-screen or copy text from an external
source and paste it into the text box.
NOTE: In addition to modifying the images and text for the preloaded HTML files and importing new image files, you can also
import entire Web pages. In the sections for the login page, success page, and failure page, select Import custom Web
pages, click Add/Remove, browse to the files that you want to import, and then click Upload.
You can also export the default captive Web portal HTML and image files from SmartPath EMS VMA and use them for ref-
erence when designing new ones. To do that, click the Export option at the top of the Configuration > Advanced
Configuration > Authentication > Captive Web Portals > New page.
9.3.4 Configuring a Captive Web Portal
In this example, you configure a captive Web portal to provide guests with wireless network access. The configuration includes
the following elements:
• Captive Web Portal—Define a captive Web portal that uses self-registration, the auto-generated Web pages provided in
SmartPath EMS VMA, and external DHCP and DNS servers.
• QoS Rate Limiting—To preserve bandwidth for employees, reduce the rate limit for guests somewhat.
• Firewall Policy—To maintain security, restrict visitors to accessing just the public network.
• User Profile—Apply the QoS rate limiting and firewall policy to the user profile that the SmartPath AP applies to traffic from
successfully registered users.
• SSID—Configure an SSID that secures wireless traffic with a preshared key and permits access to the public network only
through the captive Web portal.
• WLAN Policy—Add the SSID to a WLAN policy.