Custom login page

Custom login page

NOTE:
As of 6.4.0.26, the custom login page must reside on your webNetwork server.
The following line must also be included in the login form:
<input type="hidden" name="csrfToken" value="<c:out value='${csrfToken}'/>"/>


While we currently allow CSS customization of the login page, a customer can only go so far with that.  For the most part, they can only change the login box size, logo, colors, fonts, etc.  If they want a completely custom login page, there are two options.


1. Embed loginForm.jsp into an existing or custom page.  loginForm.jsp (located under /webserv) contains the logic to display a login form (i.e. – username, password) and a submit button.  If the style of the login form needs to be changed, it can be done so through the Profile Editor.


2. Customize our login pages.  This method is not recommended because if they change our files, then they will lose them after an upgrade.  They can rename all of the affected files to avoid this, but even that has its issues.  If they want to go this route, here is what they will need to change:

1. LoginPolicy.jsp.  This page is loaded directly after index.jsp.  It is the starting point for customizations to the login page.  This is the page that will load if Login Policies are enabled. If not, NoLoginPolicy.jsp will load, which I am not covering in this document.  This page has very little in it; instead, it pulls from different JSPF (JSP Fragment) files to do its work.  It was done this way, so that changes can be made to the fragments, and those changes will show up in all of the ‘login pages’, such as Reset Password.
2. commonHeadWebOS.jspf – located under /webserv/WEB-INF/jspf, this file contains some header tags, page title, stylesheet includes, and dojo javascript includes.  No actual page markup is in this file.
3. Next, LoginPolicy.jsp has one css selector in a <style/> block.  This is used to override the default height of the login box.  This value can be changed in the Profile Editor, via a setting (as of 5.3).
4. commonContentHeaderWebOS.jspf – this jsp fragment includes the first actual html that can be modified. This includes the first portion of the dojo login box html, as well as the company logo.  Most dojo settings in here can be customized via Settings in the Profile Editor, or through style in Login Pages section.  If customers choose, they can edit this file to make changes to all login pages.  
5. loginForm.jspf -  This file will read the LoginPolicy and output the appropriate inputs and a submit button.  This file should not be edited.  The style of the inputs and button can be edited from the Profile Editor
6. commonContentFooterWebOS.jspf – this file contains the closing html of the login page.  The login box is closed out and the copyright text is output.  The very last <div/>  in there corresponds to the LoginBox div in commonContentHeaderWebOS.jspf.  So, customers should be careful to close any tags in here, that weren’t closed in commonContentHeaderWebOS.jspf.  

Of course, customers don’t have to follow this convention.  They can just edit LoginPolicy.jsp to whatever they want, as long as they keep loginForm.jsp.  However, if they do this, none of the other login pages, error pages, etc will match their new style.

    Can't find the KB

    Unable to find the KB to address your issue ?  

      • Recent Articles

      • Lenovo Unified Workspace End-of-Life Questions and Answers

        Will the shutdown of LUW servers and access to downloads affect my server licensing? No, the shutdown of the customer servers and access to the product and licensing downloads will not affect your server licensing. This license is downloaded and ...
      • How do I determine my Unified Workspace license expiration date?

        The best method for determining the licensing information including the expiration date of your Unified Workspace license: Login to your 8090 management console on each server This may take remoting into each LUW server and relay, opening a browser, ...
      • Lenovo Unified Workspace 7.0.2.13 Released

        Highlights of Unified Workspace 7.0.2.13 Before you install: Please view the installation notes here. 7.0.2.13 requires a 7.0 license file. Below is a list of enhancements and fixes released in Unified Workspace 7.0.2.13 Fixed external storage ...
      • LanSchool Documentation Guides

        LanSchool Classic Teacher Console The LanSchool Teacher Console is the interface teachers will use to manage their classroom and students. It contains all the tools necessary for a teacher to effectively interact with students and create a ...
      • Lenovo Unified Workspace 7.0.1.41 Released

        Highlights of Unified Workspace 7.0.1.41 Before you install: Please view the installation notes here. 7.0.1.41 requires a 7.0 license file. Below is a list of enhancements and fixes for Unified Workspace 7.0.1.41 Updated Log4j Updated Java Updated ...
      • Related Articles

      • Customize mobile login page

        With the release of 6.5.7.28 mobile login pages have been updated to use the same style (template) as your chosen desktop login page. If you have your desktop login page customized (images, colors, etc...) you will notice the mobile login page does ...
      • Change Login Page Template

        Question How do I change the Login Page style my system is using? Solution UW offers multiple Login Page styles, called Templates.  The active template can be changed using the Customization Center inside of the webAdmin Dashboard. note: Be careful ...
      • Redirect password change to custom page

        Issue Customer would like the Change Password option to open their own password change application, not the one built into Unified Workspace. Solution There are two ways to accomplish this. Change stoneware/webserv/apps/selfService/ChangePassword.jsp ...
      • How to fix customized login and profile after upgrading to v7.0

        With the release of 7.0 the default login page has been modified to simplify the customization process. If you are having an issue with the login page not displaying, after upgrading to v7.0, you will need to delete the custom CSS code and start from ...
      • Add Additional Information link to login box

        Issue I would like to add my own informational link to the login page. Solution You can add an Additional Information link to the login box, that can bring up the information you would like to display. There are two methods to enable the display of ...