Show TOC

Procedure documentationConfiguring the Logon Screen Locate this document in the navigation structure

 

Use this procedure to configure some parts of the logon screen of SAP NetWeaver Application Server (AS) Java to match the branding used by your company or provide more services to your users.

  • Branding

    The logon screen uses two images and a cascading style sheet to branding the logon screen. See the description of the logon screen layout below.

  • Certificate logon

    You can enable a certificate logon link. If you configure your AS Java to support logon with X.509 certificates, users can log on with their certificate. Users no longer need to provide user ID and password.

    For more information, see Using Client Certificates for User Authentication.

For more information about how to configure other services on the logon screen, such as logon help for forgotten passwords or self-registration, see the following:

Layout of the Logon Screen

One half of the logon screen displays a branding image. The other half of the logon screen displays a branding image for text at the top of the screen. This image is used to display the product name. Below appears the user ID and password entry fields, the Log On button, and optional links for logon support, certificate logon, and self-registration.

This graphic is explained in the accompanying text.

Logon Screen of the AS Java

Prerequisites

  • You have determined that you only need to make minor adjustments in the branding of the logon screen, if any. You can perform more extensive customization of the logon screen for the SAP NetWeaver Portal.

    For more information, see Customizing the Logon Screens.

  • This procedure requires you to restart the AS Java, so you should plan for the required downtime while the AS Java restarts

Procedure

  1. Determine the options you want to configure.

  2. Edit the user management engine (UME) properties as required.

    For more information, see Editing UME Properties.

    • To change the branding images and style sheet:

      You can use any URL, but if you log on with HTTPS, external links may generate a warning about nonsecure items. The content delivered by the URL always has the Multipurpose Internet Mail Extensions (MIME) type image.

      Do not refer to the local file system, as this means the browser of remote clients attempt to find the image on their local file system.

      Recommendation Recommendation

      We recommend that you deploy your images as an application (in your own namespace) or in a publicly accessible location, such as a Web server or file share, where all your clients have access rights.

      If your users only access the AS Java as a portal, deploy the images as a portal application.

      End of the recommendation.

      • For branding-image.jpg, the property is ume.logon.branding_image.

      • For branding-text.gif, the property is ume.logon.branding_text.

      • For the cascading style sheet, the property is ume.logon.branding_style.

        Begin the entry with a forward slash (/) to begin from the root node of the AS Java, followed by the application and the path to the resource. For example: /my_app/resource/my_image.gif. Without the forward slash (/) the AS Java assumes the resource is part of the root node of the logon application under the following path:

        <installation directory>/j2ee/cluster/apps/sap.com/com.sap.security.core.logon/servlet_jsp/logon_ui_resources/root/

        Note Note

        The portal does not use the cascading style sheet defined by this property.

        End of the note.

    • To enable certificate logon link, set the UME property ume.logon.allow_cert.

  3. Restart the AS Java.