14.4 Customizing Branding on User-Facing Pages

CloudAccess allows you to customize user-facing pages, such as the login page, so users see your company branding instead of the default branding. After you have customized those pages, you can modify them as needed to meet new company requirements. Customizing the user pages does not affect any pages in the administration console itself.

If you implement custom branding in your CloudAccess environment and then re-run the initialization process to modify the DNS server or make other changes to an existing cluster, branding is reset to the default settings. Before you re-run the initialization process on an existing cluster, ensure that you back up your customized branding files so that you can reuse them.

IMPORTANT:Performing advanced branding customization requires advanced JavaServer Pages (JSP) knowledge. Before you make any changes, ensure that you have a good snapshot of your appliance that you can revert to if necessary. If you upload a bad branding file and are unable to log in to the administration console, you can re-run the appliance initialization to restore the default login pages. For more information, see Initializing the Appliance.

To customize branding for users:

  1. (Conditional) If you plan to perform extensive rebranding, take a snapshot of the appliance.

  2. Log in with an appliance administrator account to the administration console at https://appliance_dns_name/appliance/index.html.

  3. On the toolbar, click the Tools icon, then click End user branding.

  4. (Conditional) If you want to customize the user login page, complete the following steps:

    1. Click Basic Customization.

    2. Change the title and background colors by specifying HTML color codes.

    3. Change the default image by either not showing the image, or uploading a new image.

      The image size on the user landing and logout pages is always scaled to 60 x 60. On the login page, if the specified image is between a minimum of 60 x 60 and a maximum of 300 x 300, CloudAccess displays the image “as is.” If the image is outside this range, CloudAccess scales it to the nearest minimum or maximum value.

    4. Click OK to save the changes and then click Apply.

  5. (Conditional) If you want to perform more extensive rebranding, complete the following steps:

    1. Click Advanced Customization.

    2. Click Download default end user login code.

    3. Save the file to your local computer.

    4. Save a backup copy of the file.

    5. Unzip the downloaded file and locate the .jsp files in the osp\jsp subdirectory.

    6. Modify the desired JSP pages. The default text for the login page is located in the osp\resources\oidp_custom_resources_en_US.properties file.

      For more information about the JSP files, see Section A.0, Performing Advanced Branding.

    7. Zip up the files again. Include only the images and jsp directories, but ensure that you keep them in the original osp directory.

    8. Log in to the CloudAccess console again.

    9. On the toolbar, click the Tools icon, then click End user branding.

    10. (Conditional) If you are customizing pages for the first time, click Browse, then browse to and select the modified file.

    11. (Conditional) If you are updating previously customized pages, delete the name of the existing file. Click Browse, then browse to and select the .zip file that contains the newly modified.jsp files.

    12. Wait until the Delete button appears, then click OK.

      If rebranding was unsuccessful, an error message will appear.

    13. Click Apply.

      The pages now display the branding you customized in the .jsp files.