Setting up "autologin" for the CA Workflow worklist

Document ID : KB000054490
Last Modified Date : 14/02/2018
Show Technical Document Details

Description

This document will go over how to enable the "autologin" feature for CA Workflow version 1.0 that is embedded with Unicenter Service Desk r11.2.

Solution

There is a minimum build version requirement for CA Workflow to be at 1.0.019 build 52. The current patch release (as of the writing of this document) for the CA Workflow embedded with Service Desk is build 59. We encourage you to apply the most current build of Workflow to your Service Desk installation.

There is also a requirement the EEM (eIAM) be attached to Active Directory, and that the users who will be accessing the worklist are added to the Service Desk application group within EEM.

In order to enable the "autologin" functionality for CA Workflow worklist, the web.xml file in the wl-web.war file must be modified.

You have two choices for making the modification. This can either be done via command line using the JAVA SDK, or the file can actually be modified directly within the archive using WinZip.

To use the command line, first you must install the 1.4.2 JDK. This cannot be done with a version of Java later than 1.4.2 - the most current archived release of 1.4.2 on the Sun site is 1.4.2_18.

Once this is installed, navigate to the $NX_ROOT/site/Workflow/Server/dist directory. Here you will see two war (web archive) files: processmanager.war and wl-web.war.

Create a new temp directory here so that you have a path of $NX_ROOT/site/Workflow/Server/dist/temp

Open a command window now and navigate to this temp directory. You will also need to know the directory path where the JDK was installed. The default path for a windows installation is c:\j2sdk1.4.2_18. The examples here will use that path. The Service Desk service will need to be stopped, so from here run pdm_halt -w

Once Service Desk is shut down issue the following command:

C:\j2sdk1.4.2_18\bin\jar -xvf ..\wl-web.war

Again you should only do this from an empty directory, the path above assumes you have created such an empty directory under $NX_ROOT/site/Workflow/Server/dist and are issuing the command from this new directory.

Going into Windows Explorer you will now see in this temp directory, all the files and folders extracted from the war file (see Figure 1):

Figure 1

Figure 1:

Find web.xml and open it with a text editor and make the following modifications:

  1. Remove the comment mark to uncomment the auto login filter

  2. Add a comment mark after the "....Active Directory" (see Figure 2):

    Figure 2

    Figure 2:

  3. Remove the comment mark to uncomment the auto login filter mapping

  4. Add a comment mark after the "......automatic login." (see Figure 3):

    Figure 3

    Figure 3:

    Once the web.xml file has been modified and saved, issue the following command:

    C:\j2sdk1.4.2_18\bin\jar -cf wl-web.war *

    Again this command should be run only from the temp directory where the files were extracted. The asterisk after the file name is required to create the war file. Make sure there is a space between .war and the asterisk. A new file named wl-web.war will be created in this directory.

    You will need to rename the wl-web.war file that is currently in the $NX_ROOT/site/Workflow/Server/dist directory - make sure to rename it so that it no longer has a .war extension, otherwise it will be read as a valid web archive file and be deployed. We suggest renaming the file to wl-web.war.orig

    Copy the new wl-web.war file from $NX_ROOT/site/Workflow/Server/dist/temp into $NX_ROOT/site/Workflow/Server/dist (see Figure 4):

    Figure 4

    Figure 4:

    Restart Service Desk and open a browser and go to http://machinename:port/wl where machinename is the servername where Service Desk is installed, and the port is the port number for Service Desk and CA Workflow - by default the port is 8080.

    The first time the jsp is getting compiled it may take a couple of minutes to complete the login process, but you will see that you are automatically logged into the worklist.

    The second choice is to modify the web.xml file directly within the .war file.

    Open $NX_ROOT/site/Workflow/Server/dist/wl-web.war with WinZip - do not extract it - and locate the web.xml file (see Figure 5):

    Figure 5

    Figure 5:

    Right click on that file and open it with a text editor, and modify the file as was described above. Save the change to the file and then close the file.

    As soon as you close the file you will see the following (see Figure 6):

    Figure 6

    Figure 6:

    Select yes, the archive will be reloaded and your changes saved to it.
    Close WinZip.

    Restart Service Desk and open a browser and go to http://machinename:port/wl where machinename is the servername where Service Desk is installed, and the port is the port number for Service Desk and CA Workflow - by default the port is 8080.

    The first time the jsp is getting compiled it may take a couple of minutes to complete the login process, but you will see that you are automatically logged into the worklist.