LoginController

The LoginController contains the properties that define login options.

The LoginController can be modified or replaced. The LoginController is defined in [tomcat]/webapps/BlueZone/WEB-INF/dispatcher-servlet.xml and major aspects of its behavior can be modified by changing this definition.

The default definition is:

<bean id="login"
      name="loginController"
      class="com.bluezone.w2h.controllers.LoginController">
      <property name="bzUserDataProvider" ref="bzW2hCsvLoginDataProvider" />
      <property name="bzUserIdKey" value="BzUserId" />
      <property name="bzUserPasswordKey" value="BzUserPassword" />
      <property name="bzUserDataKey" value="BzUserData" />
      <property name="loginOkRedirect" value="splitter.bz" />
      <property name="loginFailedRedirect" value="/msg-loginFailed.html" />
      <!--
      PasswordRequired
      If false, then BzUserDataProvider.getData(loginId) is called.
      If true, then BzUserDataProvider.getData(loginId,password) is called. -->
      <property name="passwordRequired" value="false" />
      <property name="sessionCreationDenied" value="false" /> 
</bean>

LoginController properties lists the properties and their use.

Table 3: LoginController properties

Property	Usage
bzUserDataProvider	By default, this references the BzW2hCsvLoginDataProvider bean defined in applicationContext.xml. This UserDataProvider can be changed. There are two other default LoginDataProviders for connection to LDAP/ActiveDirectory and Microsoft SQL Server. Refer to User data providers for more information.
bzUserIdKey	When the user ID is received it is placed into the web application’s session context under this key.
bzUserPasswordKey	When the user password is received it is placed into the web application’s session context under this key.
bzUserDataKey	When the user’s data is retrieved from the DataProvider, it is placed into a BzW2hUserDataRow object and placed into the web application’s session context under this key.
loginOkRedirect	If the login succeeds, then the call is redirected to this file. By default, this is splitter.bz. You can modify this to point to custom code.
loginFailedRedirect	If the login fails, then the call is redirected to this file. You can modify this to point to custom code. Refer to Message pages for more information.
passwordRequired	If false, then BzUserDataProvider.getData(loginId) is called. If true, then BzUserDataProvider.getData(loginId,password) is called.
sessionCreationDenied	Advanced. If false, then the LoginController will create a web application session for this call. Default is false. If true, then the session must be created prior to the LoginController handling the request, or an error will be returned.

The four most commonly customized properties of LoginController are:

•

bzUserDataProvider

•

loginOkRedirect

•

loginFailedRedirect

•

passwordRequired