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

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

    can configure this using the user management property


    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



    There you can find

     2. Make a copy of and rename it. In

    this example, it is renamed to

     3. Move to a location outside of the


     4. Extract the files from preserving the directory structure.

     5. Modify files in the extracted PAR file.

     6. Put the modified files back into

     7. Copy back to



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


     8. In the authschemes.xml file, replace all occurrences of the string” with “” 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.


    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.


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


     1. Start the Config Tool by executing


     2. Choose the symbol for Switch to configuration editor mode.

     3. In the tree, navigate to cluster_data ? server ? persistent ?

     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

     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


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

Report this document

For any questions or suggestions please email