This documentation supports the 24.2 and consecutive patch versions of BMC Helix Single Sign-On.To view an earlier version, select the version from the Product version menu.

Rebranding the end user login page

As a BMC Helix Single Sign-On administrator, when you have fully configured a realm for authentication, you can change default branding of the BMC Helix SSO login page in accordance with your company standards and requirements. BMC Helix SSO login page is displayed to end users when they log in to any of the applications belonging to the same realm.

Important

You do not need to rebrand the login page if a realm is configured only for one of the following authentication methods: Cert, Kerberos, Preauth, SAML, and OpenID Connect. However, if these authentication methods are a part of the authentication chain, you can rebrand the login page.

Related topics

Adding-and-configuring-realms

Login-and-logout-experience-for-end-users
HTML tags

To rebrand the end user login page

  1. Log in to the BMC Helix SSO Admin Console.
  2. Click the Realm tab.

  3. In the left navigation panel of the Add Realm or Edit Realm page, click Branding to add branding details.


    Field

    Action

    Customize Login Page

    Customizes the login page.

    Once you select this option, the Preview button is enabled.

    Window Title

    Enter a title of the browser window.

    Product Name

    Enter a name of the product.

    (Version 22.3.01 and later)

    Old-style UI

    Select this check box to switch from the Adapt-based style of the login page to the user interface of the earlier BMC Helix SSO versions.

    Important: If you upgrade to BMC Helix SSO 22.3.01 and want to switch from the new interface to the old one, ensure that the system variable RSSO_DISABLE_ADAPT_WHEN_BRANDING_EXISTED is enabled. For more information, contact the BMC DevOps team.

    (Versions 22.1, 22.2, and 22.3)

    Dark mode

    Select this check box to make the color of the product name black. Best practice: We recommend changing the color to black if you are using a light background image.

    Company Logo

    Click the pencil icon to change the company logo, and upload an image which satisfies the following requirements:

    • The maximum image resolution must be 240 x 60 pixels.
    • The proportion of the width/height must be 4:1.
    • The image must have one of the following extension: jpg, jpeg, png, gif, bmp, tga, tif, tiff.

    Background Image

    Click the pencil icon to change the background image, and upload an image which satisfies the following requirements:

    • The maximum image resolution must be 1920 x 1080 pixels.
    • The proportion of the width/height must be 16:9.
    • The image must have one the following extension: jpg, jpeg, png, gif, bmp, tga, tif, tiff.

    Extended Login page information (html)

    You can add HTML related rebranding to the end user login page by using the allowed HTML tags: <a>, <b>, <blockquote>, <br>, <cite>, <code>, <dd>, <dl>, <dt>, <em>, <i>, <li>, <ol>, <p>, <pre>, <q>, <small>, <span>, <strike>, <strong>, <sub>, <sup>, <u>, <ul>.

  4. Click Preview to see the preview of the login page.
  5. Click Add or Save.

When you save the changes, the new branding options will be displayed on the end user login page.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*