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.

    • 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 ...
    • Redirect to different page after logout

      Is there a way to have the user be redirected to a different page rather than taking them back to the webRDP gateway connection page ?   There is an "onlogout" parameter when you craft a url either by hand or on your intranet site you can supply a ...
    • 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 ...
    • Popular Articles

    • Old Browser Versions

      Question: I am using an older browser version and am having problems. What can be done ? We are not able to upgrade the browser at this time.   This is a challenge for any company that makes software that utilizes a browser. Since Stoneware does not ...
    • LCS Redirection

      Problem: How to redirect the LCS in an environment with multiple LCSs and students connecting to them. Solution(s): Create an allow.cfg on all LCS(s) (including the Master) in the network, however, even if no allow.cfg is present on an LCS, machines ...
    • Time windows allows for Service Shutdown

      Issue: Can the time windows gives a service to shut down before it kills the service be increased? Solution: Yes, the following information comes from the Microsoft URL : http://support.microsoft.com/kb/146092 To specify the wait time, do the ...
    • How to disable password saving - Internet Explorer

      Having multiple methods for saving a password in the browser can cause confusion for the user.   To disable password saving in Internet Explorer, launch Internet Explorer and perform the following steps. Click the blue Settings menu icon in the upper ...
    • How to disable password saving - Chrome

      Having multiple methods for saving a password in the browser can cause confusion for the user.  To disable password saving in Chrome, launch Chrome and perform the following steps. Click the Chrome menu button in the upper right corner of the Chrome ...
    • Recent Articles

    • SAML Service Provider

      Issue How can I use a 3rd Party service (such as ADFS, Office365, or OneLogin) to SSO into UW? Solution The SAML Service Provider (SP) features allows another Identity Provider (IDP) to single sign-on into Unified Workspace using SAML for a seamless ...
    • Lenovo Unified Workspace 7.0.0.63 Released

      Highlights of Unified Workspace 7.0.0.63 Before you install: Please view the installation notes here. 7.0.0.63 Requires new 7.0 license file. Below is a list of enhancements and fixes for Unified Workspace 7.0.0.63 New Profile Style New Login ...
    • 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 ...
    • SAML SP - Sync Directory Password

      Login script to prompt for directory password Since the user does not login into Unified Workspace with a password, we cannot capture the password to use in the @@password@@ variable.  If you would like to use the Active Directory password for other ...
    • MySQL 8 SSL

      Issue Admin is making a database connection to a MySQL 8 database.  When clicking the Ping button on the DB Connection object, the following error is presented: WARN: Establishing SSL connection without server's identity verification is not ...