Expressing our Experience

Steps to customize Portal Logon Screen

AS JAVA

This article is about how to customize the portal screen to reflect your company requirements?

 In order to make it work, you must modify the Java Server Pages (JSPs) of the logon component shipped by SAP and reconfigure user management to use the modified logon component.

 The standard logon component containing the code and resources used by the logon screens is shipped in a portal archive (PAR) file named com.sap.portal.runtime.logon.par

 The changes you make to the logon screens can be overwritten during an upgrade. For this reason you should always make a copy of any file before changing it. After an upgrade you have to reconfigure your changes.

Make a Copy of the Standard Logon Component and Modify It

    1.      Navigate to   <J2EE_Engine_Instance>\j2ee\cluster\server<X>\apps\sap.com\irj\servlet_jsp\irj\root\WEB-INF\deployment\pcd.

There you can find com.sap.portal.runtime.logon.par.bak.

       2.      Make a copy of com.sap.portal.runtime.logon.par.bak and rename it. In this example, it is renamed to my.new.logon.par.

       3.      Move my.new.logon.par to a location outside of the <J2EE-Engine_Instance>.

       4.      Extract the files from my.new.logon.parpreserving the directory structure.

       5.      Modify files in the extracted PAR file.(Portal team / Development team will perform the changes as per business requirement)

       6.      Put the modified files back into my.new.logon.par.

       7.      Copy my.new.logon.par back to <J2EE_Engine_Instance>\j2ee\cluster\server<X>\apps\sap.com\irj\servlet_jsp\irj\root\WEB-INF\deployment\pcd

Modify authschemes.xml to reference the new PAR file containing the modified logon UIs

 In the authschemes.xml file, replace all occurrences of the string “com.sap.portal.runtime.logon” with “my.new.logon” in the tags <frontendtarget> and save the file. Edit the authschemes.xml file as described below

1. Start the Config Tool by executing <SAPJ2EEEngine_installation>\j2ee\configtool\configtool.bat.
2. Choose the symbol for Switch to configuration editor mode.
3. In the tree, navigate to cluster_data ® server ® persistent ® com.sap.security.core.ume.service.
4. To switch to edit mode, choose  (Switch between view and edit mode).
5. In the tree, select authschemes.xml and choose  (Show the details of the selected node).
6. Choose Downloadand save the file to a local directory.
7. Edit the file locally.
8. Create a new node in the configuration tree for the edited file as follows:

• Select the node com.sap.security.core.ume.service.
• Choose the symbol for Create a node below the selected node
• Select the type File-entry.
• Choose Upload and select the file from your local directory.

• Enter the name for the entry, for example, authschemes_quality.xml. By default, the name of the uploaded file is used.

• Choose Create.
• Choose Close window.

The new node appears in the configuration tree.

For UME to use the new file, you have to change the value of the property login.authschemes.definition.file to the name of the new authschemes file. Change the property as below

 Start the Config Tool by executing <SAPJ2EEEngine_installation>\j2ee\configtool\configtool.bat.

In the tree, navigate to Global server configuration ® services ® com.sap.security.core.ume.service.

The list ofUMEproperties appears.

 To change the value of a property:

 Select the property in the list.

 In Value at the bottom of the screen, enter the new value “authschemes_quality.xml” that you want to assign to the property.

 Choose Set.

Restart the nodes in the cluster for the changes to take effect.

Result

The modified logon screen is now displayed during the logon.

Thanks

Saravanan Arunachalam