Appboard/2.4/builder/system administration/login page/custom - Revision history

imported>Jason.nicholls: /* Required Fields and Submission */

2014-07-17T10:24:16Z

Required Fields and Submission

← Older revision		Revision as of 10:24, 17 July 2014
Line 18:		Line 18:
	== Required Fields and Submission ==		== Required Fields and Submission ==

	The following fields are required:		The following fields are required to log into AppBoard:

	* '''login''': set to ''yes''. Typically this is a hidden field		* '''login''': set to ''yes''. Typically this is a hidden field
Line 26:		Line 26:

	The form is then <tt>POST</tt>ed to: <tt>/enportal/servlet/pd</tt>. Using <tt>GET</tt> is also possible but not recommended as all all requests are logged and get requests include all parameters, which means user passwords would also get logged.		The form is then <tt>POST</tt>ed to: <tt>/enportal/servlet/pd</tt>. Using <tt>GET</tt> is also possible but not recommended as all all requests are logged and get requests include all parameters, which means user passwords would also get logged.


	== Included Login Pages ==		== Included Login Pages ==

imported>Jason.nicholls at 10:22, 17 July 2014

2014-07-17T10:22:46Z

← Older revision		Revision as of 10:22, 17 July 2014
Line 16:		Line 16:


	~~== Included Login Pages ==~~		== Required Fields and Submission ==

	The login pages shipped with AppBoard all follow the same structure. A main <tt>login.jsp</tt> Java Server Page which performs browser version checking, auto-fills previous values, handles error responses, presents a HTML form for the user to complete. Along with the JSP there will be other supporting images and CSS resources.

	=== Required Fields and Submission ===

	The following fields are required:		The following fields are required:
Line 27:		Line 23:
	* '''userid''': This would be a visible field to allow a user to enter their user name.		* '''userid''': This would be a visible field to allow a user to enter their user name.
	* '''password''': This would be a visible password field to allow a user to enter their password.		* '''password''': This would be a visible password field to allow a user to enter their password.
	* '''domainSelect''': Another text input with the ~~default~~ login ~~pages but could be hidden or modified~~ to be ~~a drop-down etc..~~.		* '''domainSelect''': Another text input to allow a user to enter their domain.

			The form is then <tt>POST</tt>ed to: <tt>/enportal/servlet/pd</tt>. Using <tt>GET</tt> is also possible but not recommended as all all requests are logged and get requests include all parameters, which means user passwords would also get logged.


			== Included Login Pages ==

			The login pages shipped with AppBoard all follow the same structure. A main <tt>login.jsp</tt> Java Server Page which performs browser version checking, auto-fills previous values, handles error responses, presents a HTML form for the user to complete. Along with the JSP there will be other supporting images and CSS resources.

	The form is then <tt>POST</tt>ed to: <tt>/enportal/servlet/pd</tt>. Using <tt>GET</tt> is also possible but not recommended as by default the full get request including parameters are logged, in which case user passwords would also get logged.

	=== Browser Type Checking ===		=== Browser Type Checking ===

imported>Jason.nicholls: /* Minimal Login Page */

2014-07-17T10:20:15Z

Minimal Login Page

← Older revision		Revision as of 10:20, 17 July 2014
Line 132:		Line 132:
	<table>		<table>
	<tr><td>User Name:</td> <td><input type="text" name="userid" size="28" maxlength="80"></td></tr>		<tr><td>User Name:</td> <td><input type="text" name="userid" size="28" maxlength="80"></td></tr>
	<tr><td>Password:</td> <td><input type="~~text~~" name="password" size="28" maxlength="80"></td></tr>		<tr><td>Password:</td> <td><input type="password" name="password" size="28" maxlength="80"></td></tr>
	<tr><td>Domain:</td> <td> <input type="text" name="domainSelect" size="28" maxlength="80"></td></tr>		<tr><td>Domain:</td> <td> <input type="text" name="domainSelect" size="28" maxlength="80"></td></tr>
	<tr><td colspan="2" align="center"> <input type="submit" value=”login”></td></tr>		<tr><td colspan="2" align="center"> <input type="submit" value=”login”></td></tr>
Line 140:		Line 140:
	</html>		</html>
	</code>		</code>


	=== Setting a Default Domain ===		=== Setting a Default Domain ===

imported>Jason.nicholls: /* Examples */

2014-07-17T10:18:56Z

Examples

@@ Line 103: / Line 103: @@
 == Examples ==
 === Minimal Login Page ===
@@ Line 143: / Line 154: @@
 In addition, if this field should be completely hidden then change the <tt>type</tt> attribute from <tt>text</tt> to <tt>hidden</tt>. In this case though some additional HTML and/or CSS changes may be necessary to improve the aesthetic of the form.

imported>Jason.nicholls at 10:03, 17 July 2014

2014-07-17T10:03:48Z

@@ Line 130: / Line 130: @@
 </code>
-{|class="wikitable" border="1" style="background-color:#eeeeee;"
+=== Setting a Default Domain ===
-=== Login Form ===
+# First make a new copy of an existing login page to start modifying.
-The login page must contain an HTML form with the parameters described in the following table:
+# Edit <tt>login.jsp</tt>
-{|class="wikitable" border="1" style="background-color:#eeeeee;"
+In addition, if this field should be completely hidden then change the <tt>type</tt> attribute from <tt>text</tt> to <tt>hidden</tt>. In this case though some additional HTML and/or CSS changes may be necessary to improve the aesthetic of the form.
+# First make a new copy of an existing login page to start modifying.
+# All shipped login pages use a logo in the following location: <tt>images/logo.png</tt>.
-=== Hard-coding a Default Domain ===
+# Create a new logo. The simplest way to go is to view the default logo to check the dimensions, and create a new image with the same dimensions with your new logo.
-AppBoard/enPortal requires three elements for a User to successfully log in to the system: Username, Password, and Domain.  In some cases, all of the Users may be in a single Domain, and it may be a nuisance for the User to have to enter the Domain in order to log in.  In this case, you can pre-fill a Domain name in the login form, or even hide the field completely and just have the Login Page auto-submit the hard-coded value for everyone who submits a login request.
+# Replace the logo.png with your new logo.
+# Set the system login page to use your new login page.

imported>Jason.nicholls at 09:51, 17 July 2014

2014-07-17T09:51:25Z

← Older revision		Revision as of 09:51, 17 July 2014
Line 20:		Line 20:
	The login pages shipped with AppBoard all follow the same structure. A main <tt>login.jsp</tt> Java Server Page which performs browser version checking, auto-fills previous values, handles error responses, presents a HTML form for the user to complete. Along with the JSP there will be other supporting images and CSS resources.		The login pages shipped with AppBoard all follow the same structure. A main <tt>login.jsp</tt> Java Server Page which performs browser version checking, auto-fills previous values, handles error responses, presents a HTML form for the user to complete. Along with the JSP there will be other supporting images and CSS resources.

			=== Required Fields and Submission ===

			The following fields are required:

			* '''login''': set to ''yes''. Typically this is a hidden field
			* '''userid''': This would be a visible field to allow a user to enter their user name.
			* '''password''': This would be a visible password field to allow a user to enter their password.
			* '''domainSelect''': Another text input with the default login pages but could be hidden or modified to be a drop-down etc...

			The form is then <tt>POST</tt>ed to: <tt>/enportal/servlet/pd</tt>. Using <tt>GET</tt> is also possible but not recommended as by default the full get request including parameters are logged, in which case user passwords would also get logged.

	=== Browser Type Checking ===		=== Browser Type Checking ===

imported>Jason.nicholls: /* Minimal Login Page */

2014-07-17T09:45:20Z

Minimal Login Page

← Older revision		Revision as of 09:45, 17 July 2014
Line 109:		Line 109:
	<input name="login" type="hidden" value="yes">		<input name="login" type="hidden" value="yes">

	<table ~~border="1"~~ >		<table>
	<tr><td>User Name:</td> <td><input type="text" name="userid" size="28" maxlength="80"></td></tr>		<tr><td>User Name:</td> <td><input type="text" name="userid" size="28" maxlength="80"></td></tr>
	<tr><td>Password:</td> <td><input type="text" name="password" size="28" maxlength="80"></td></tr>		<tr><td>Password:</td> <td><input type="text" name="password" size="28" maxlength="80"></td></tr>

imported>Jason.nicholls: /* Minimal Login Page */

2014-07-17T09:44:59Z

Minimal Login Page

← Older revision		Revision as of 09:44, 17 July 2014
Line 99:		Line 99:

	<code>[html,N]		<code>[html,N]
			<html>
			<head>
			<title>Minimal Login Page</title>
			</head>
			<body>
			<h1>Minimal Login Page</h1>

	~~<html>~~		<form name="loginForm" method=post action="/enportal/servlet/pd">
	~~<head>~~		<input name="login" type="hidden" value="yes">
	~~<title>Basic Enportal Login page</title>~~
	~~</head>~~		<table border="1" >
	~~<body>~~		<tr><td>User Name:</td> <td><input type="text" name="userid" size="28" maxlength="80"></td></tr>
	~~<P>Basic enPortal Login Page</P>~~		<tr><td>Password:</td> <td><input type="text" name="password" size="28" maxlength="80"></td></tr>
	<form name="loginForm" method=post action="/enportal/servlet/pd">		<tr><td>Domain:</td> <td> <input type="text" name="domainSelect" size="28" maxlength="80"></td></tr>
	<input name="login" type="hidden" value="yes">		<tr><td colspan="2" align="center"> <input type="submit" value=”login”></td></tr>
	<table border="1" >		</table>
	<tr><td>~~UserID~~:</td> <td><input type="text" name="userid" size="12" maxlength="15"></td></tr>		</form>
	<tr><td>~~Pwd~~:</td> <td><input type="text" name="password" size="12" maxlength="15"></td></tr>		</body>
	<tr><td>Domain:</td> <td> <input type="text" name="domainSelect" size="12" maxlength="80"></td></tr>
	<tr><td colspan="2" align="center"> <input type="submit" value=”login”></td></tr>
	</table>
	</form>
	</body>
	</html>		</html>

	</code>		</code>


	=== Login Page Elements ===		=== Login Page Elements ===

imported>Jason.nicholls: /* Auto-fill User Name and Domain Fields */

2014-07-17T09:41:20Z

Auto-fill User Name and Domain Fields

← Older revision		Revision as of 09:41, 17 July 2014
Line 52:		Line 52:
	=== Auto-fill ''User Name'' and ''Domain'' Fields ===		=== Auto-fill ''User Name'' and ''Domain'' Fields ===

	{{Note\|Modern browsers often will auto-fill forms on behalf of the user already making this section redundant. Also realize that even if the JSP auto-fill code is disabled the browser may still auto-fill forms. In the case of the browser auto-filling form fields it is necessary to modify the form inputs and specify the <tt>autocomplete="off"</tt> attribute.}}		{{Note\|1=Modern browsers often will auto-fill forms on behalf of the user already making this section redundant. Also realize that even if the JSP auto-fill code is disabled the browser may still auto-fill forms. In the case of the browser auto-filling form fields it is necessary to modify the form inputs and specify the <tt>autocomplete="off"</tt> attribute.}}

	If a user has previously logged into AppBoard then it's possible for the server to retrieve the users ''User Name'' and ''Domain'' last used via cookies stored in the browser. This is implemented in the default JSP pages by first loading some utilities:		If a user has previously logged into AppBoard then it's possible for the server to retrieve the users ''User Name'' and ''Domain'' last used via cookies stored in the browser. This is implemented in the default JSP pages by first loading some utilities:
Line 74:		Line 74:
	user = JSPUtilities.toHTMLString(user);		user = JSPUtilities.toHTMLString(user);
	domain = JSPUtilities.toHTMLString(domain);		domain = JSPUtilities.toHTMLString(domain);


	=== Handling Errors ===		=== Handling Errors ===

imported>Jason.nicholls at 09:36, 17 July 2014

2014-07-17T09:36:04Z

Show changes