test

Sun Java System Access Manager Policy Agent 2.2 Guide for IBM WebSphere Portal Server 5.1.0.2

ProcedureTo Change the Login and Logout Link Actions for IBM WebSphere Portal Server 5.1.0.2

The Login and Logout actions within IBM WebSphere Portal Server 5.1.0.2 can be changed to better provide a seamless user experience with Single Sign-On using Access Manager. This can be achieved by implementing the steps in this task description.

  1. Ensure that the IBM WebSphere Portal Server 5.1.0.2 instance is shut down.

  2. Create backups of the applicable ToolBarInclude.jsp files.

    In this scenario, the applicable ToolBarInclude.jsp files are available within the following directory:

    WAS-base/installedApps/node_name/wps.ear/wps.war/themes/html/

    where WAS-base represents the directory within which the IBM WebSphere Portal Server 5.1.0.2 instance was installed. Notice that this task refers to both a WAS-base directory and a WPS-base directory.

  3. Modify each applicable ToolBarInclude.jsp file.

    For this task, modify each file as follows:

    Replace the href value associated with the Login link with the following value:.

    <%= wpsBaseURL %>/myportal

    The following example shows modifications that can be made to the ToolBarInclude.jsp file to change the login action:


    <%-- login button --%>
<%-- uncomment to allow log in via screen --%>
<%--
<wps:if loggedIn="no" notScreen="Login">
<td class="wpsToolBar" valign="middle" nowrap>
<a class="wpsToolBarLink" href='<%=wpsBaseURL%>/myportal'>
<wps:text key="link.login" bundle="nls.engine"/>
</a>
</td>
</wps:if>
--%>
<%--comment this to allow login via screen --%>
<wps:if loggedIn="no" notSelection="wps.Login" >
<wps:urlGeneration contentNode="wps.Login" portletWindowState="Normal">
<td class="wpsToolBar" valign="middle" nowrap>
<a href='<%=wpsBaseURL%>/myportal' class="wpsToolBarLink">
<wps:text key="link.login" bundle="nls.engine"/>
</a>
</td>
</wps:urlGeneration>
</wps:if>

    For complete details on how best to implement the preceding modification, see documentation for IBM WebSphere Portal Server 5.1.0.2.

  4. Create backups of the following file:


    WPS-base/shared/app/config/services/ConfigService.properties

    where WPS-base represents the directory within which the IBM WebSphere Portal Server 5.1.0.2 instance was installed.

  5. Modify the ConfigService.properties file as follows:

    redirect.logout

    Set the value to true.

    redirect.logout.ssl

    Set the value to true or false, depending upon the environment.

    redirect.logout.url

    Set the value to the Access Manager logout URL (AMlogout-URL).

    where AMlogout-URL represents the Access Manager logout URL. The following is a conceivable logout URL:


    http://amhost.domain.com:AMport/amserver/UI/Logout

    where AMport represents the port number of the Access Manager host.

  6. Restart the IBM WebSphere Portal Server 5.1.0.2 instance for these changes to take effect.