DOC

Customizing the Logon Screens

By Kathryn Holmes,2014-03-17 15:23
6 views 0
Customizing the Logon Screens

    Customizing the Logon Screens Use

    The portal is shipped with a standard set of logon screens. These include the screen in which

    users enter their user ID and password, the screen for requesting help from an administrator,

    and so on. If required, you can change these screens to reflect your company’s look and feel.

    To do this, you have to 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.

    If you want to change only the branding image displayed in the logon screen, you

    can configure this using the user management property

    ume.logon.branding_image

    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.

    Procedure

    Make a Copy of the Standard Logon Component and Modify It

     1. Navigate to

    \j2ee\cluster\server\apps\sap.com\irj\s

    ervlet_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

    .

     4. Extract the files from my.new.logon.par preserving the directory structure.

     5. Modify files in the extracted PAR file.

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

     7. Copy my.new.logon.par back to

    \j2ee\cluster\server\apps\sap.com\irj\s

    ervlet_jsp\irj\root\WEB-INF\deployment\pcd.

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

    UIs

     8. In the authschemes.xml file, replace all occurrences of the string

    com.sap.portal.runtime.logon” with “my.new.logon” in the tags

     and save the file. Edit the authschemes.xml file as described in

    Changing the authschemes.xml File.

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

    Result

    The modified logon screens are displayed at logon.

    Changing the authschemes.xml File Use

    You can change the authschemes.xml file using the Config Tool of SAP Web Application

    Server Java. When you edit the file, you should download the file to a local directory, edit it, and

    when uploading the edited file, create a new node in the configuration tree for it. In this way you

    do not loose the original version of the file.

    Prerequisites

    All dispatcher and server nodes in the cluster are shut down.

    Procedure

     1. Start the Config Tool by executing

    \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 Download and 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:

    1. a. Select the node com.sap.security.core.ume.service.

     b. Choose the symbol for Create a node below the selected node ().

    3. c. Select the type File-entry. 2. 4. d. Choose Upload and select the file from your local directory.

    5. e. Enter the name for the entry, for example,

    authschemes_productive.xml. By default, the name of the uploaded file is used.

    6. f. Choose Create.

    7. g. 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 described in Editing UME

    Properties.

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

Report this document

For any questions or suggestions please email
cust-service@docsford.com