Customizing the web portal page

The web portal page is an HTML form that is presented to the user for interactive authentication.

Default contents are provided on the Captive Portal Page Customization tab of Configure > Security > Access Control. It is recommended that you customize the form to convey to users who see it that this logon portal is part of your network and organization. For example, you might:

  • Replace the default logo with your organization’s logo. To do that:
    • Edit the src tag and replace the png file name with your company logo file.
    • Copy your png file to /opt/WCG/config/ui_files/images.
  • Include text to explain why the user is seeing this page

The form must be a valid HTML document, defined with valid HTML syntax.

The following variables are used in the document to ensure that it is delivered to the users properly. It is recommended that you do not change their placement or usage.

  • %P is replaced with the protocol of the current transaction
  • %h is replaced with “redirect_host:8080”
  • %u is replaced with the URL request for the portal page
  • $$DOMAIN is replaced with the basic authentication domain defined in the configuration variable proxy.config.proxy.authenticate.basic.realm. (See Authentication basic realm for more information.)

When you have entered all of the syntax, click Preview to preview the page you have created. When you are happy with the way the portal page looks, click Apply to save the content to a file. If you want to return to the default, pre-defined portal page syntax, click Restore to Default Page.

The customized Captive Portal page is saved to auth_form.html, which is stored in / opt/WCG/config. In addition, css and image files can be used to define the portal page. CSS files must be stored in /opt/WCG/config/ui_files and image files must be store in /opt/WCG/config/ui_files/images, by default.

Note: The css and image files also reside in /opt/WCG/ui/ configure/auth_form and /opt/WCG/ui/configure/ auth_form/images, respectively, for use by the Preview feature. Copy any new files to those directories to use Preview.

Add a variable to records.config to use a different name for the saved Captive Portal page or store the css and image files in a different directory.

Configuration Variable Data Type Default Value Description
proxy.config.auth. form_filename STRING auth_form. html

Specifies the file that defines the Captive Portal authentication page.

Changing this filename is not recommended.
proxy.config.internal. file.path STRING /config/ ui_files

Specifies the location of any css and image files used to define the Captive Portal authentication page. The full default path is /opt/ WCG/config/ui_files. Image files are located in an /images

sub-directory.