Customizing Web Authentication Pages

You can customize the following objects in the Web Authentication pages:

  • Title bar
  • Banner image (logo)
  • Header
  • Textbox
  • Login button
  • User ID label and entry field
  • Password label and entry field
  • Footer

You can use the show webauth or the show webauth vlan vlan-ID webpage command to determine what text has been configured for Web Authentication pages.

Note: The banner image does not apply to the Web Authentication maximum attempts limit page. The entry fields and Login button apply to the login page only.

The following steps customize the objects in the Web Authentication page.

  1. Customize the title bar that is displayed on all Web Authentication pages. 
    device(config-vlan-10-webauth)# webpage custom-text title "Ruckus Secure Access Page"
  2. Customize the banner image (logo) using TFTP. 
    device(config-vlan-10-webauth)# webpage logo copy tftp 10.10.5.1 ruckuslogo.gif
    To customize the banner image, use the TFTP protocol to upload an image file from a TFTP server to the ICX device. The image file can be in the .jpg, .bmp, or .gif format, and must be 64 Kb or less. If you upload a new image file, it will overwrite the existing image file.
    Note: The webpage logo copy tftp command downloads the image file and stores it in the device flash memory. Therefore, it is not necessary to follow this command with a write memory command.
  3. Align the banner image (logo). 
    device(config-vlan-10-webauth)# webpage logo align center
    By default, the logo is left-aligned at the top of the page. You can change the placement of the logo to the center or right at the top of the page.
  4. Customize the header.
    device(config-vlan-10-webauth)# webpage custom-text top "Welcome to Network One"
  5. Customize the text box.
    By default, the text box is empty and is not visible. To create a text box or to replace the existing one, upload an ASCII text file from a TFTP server to the ICX device. The text file size must not exceed 2 Kb. 
    device(config-vlan-10-webauth)# webpage terms copy tftp 10.10.5.1 policy.txt
    Note: The webpage terms copy tftp command downloads the text file and stores it in the device flash memory. Therefore, it is not necessary to follow this command with a write memory command.
  6. Customize the Login button.
    device(config-vlan-10-webauth)# webpage custom-text login-button "Press to Log In"
    The default Login button text is "Login".
  7. Remove or customize the User ID field.
    Note: Before you use the remove-userid-label, be sure the user ID and password match those stored on the authentication server.
    The following example removes the User ID field from the web page.
    device(config-vlan-10-webauth)# webpage remove-userid-label
    The following example changes the User ID label to read "username". The alphanumeric text used for the label has a maximum length of 32 characters.
    device(config-vlan-10-webauth)# webpage custom-label username-label "username"
  8. Customize the Password field.
    The following example changes the Password label to read "password to authenticate". The alphanumeric text used for the label has a maximum length of 32 characters.
    device(config-vlan-10-webauth)# webpage custom-label password-label "password to authenticate"
  9. Customize the footer. 
    device(config-vlan-10-webauth)# webpage custom-text bottom "Network One Copyright 2021"
Parent topic: Web Authentication Pages