Custom login page

Custom login page

As of, 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 Released

        Highlights of Unified Workspace Before you install: Please view the installation notes here. requires a 7.0 license file. Below is a list of enhancements and fixes for Unified Workspace Fixed external storage providers oauth ...
      • Lenovo Unified Workspace Released

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

        Unfortunately, Lenovo Software does not have an alternative product in which to migrate. To our knowledge, there just isn't any other single product out there that can do all that Lenovo Unified Workspace (LUW) was able to do. In searching for ...
      • Retiring Unified Workspace

        Lenovo and Stoneware are committed to providing the highest quality products and services to our customers. As part of our continued focus on innovation, we will be retiring Unified Workspace (formerly Stoneware webNetwork), effective January 31, ...
      • Assigned tiles not showing due to missing back-link

        Question We have several staff members that can't see a specific assigned tile/link. The tile has many group assignments the user is a member of, but when I view User Access and look at the assigned Link Sources, the tile/link is not listed. Issue ...
      • Related Articles

      • Customize mobile login page

        With the release of 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 ...