8.1 Customizing the Branding of Self Service Password Reset

Self Service Password Reset includes a flexible theme mechanism that allows for maximum customization of look and branding of the Self Service Password Reset application for your users. You can make the following changes:

  • Change the look and feel of the Self Service Password Reset user interface. Self Service Password Reset provides several standard themes. Each theme is an extension or modification of the default theme.

  • Determine whether to display or hide certain options, buttons, and messages on the user interface.

  • Customize the password guide text.

  • Determine the theme’s language.

You customize Self Service Password Reset through the Configuration Editor. You can also view a video about how to customize the theme for Self Service Password Reset. To view the video, see How to Create a Custom Theme in Self Service Password Reset.

To configure user interface settings:

  1. Log in to Self Service Password Reset at https://dns-name/sspr as an administrator.

  2. In the toolbar, click your name.

  3. Click Configuration Editor.

  4. Click Settings > User Interface > Look & Feel.

  5. Configure the following settings:

    Interface Theme

    Select an appropriate theme from the list.

    If you select Embedded, the system uses the Embedded CSS style sheet and the Embedded Mobile CSS style sheet to manage the custom CSS tags. Self Service Password Reset expects the themes to be available at the URL paths:

    • @PwmContextPath@/public/resources/[theme]/style.css

    • @PwmContextPath@/public/resources/[theme]/mobileStyle.css

    You can add additional themes using the Custom Resource Bundle option. You can also overwrite the default theme by specifying the URL parameter of the theme. For example:

    https://www.example.com:@PwmContextPath@?theme=sterile
    Embedded CSS Stylesheet

    Specify the contents of the custom CSS style sheet.

    To implement this setting, you must set Embedded as theme under User Interface > Theme. The contents of this setting can be served from the URL of /public/resources/themes/embed/ssprStyle.css.

    Embedded Mobile CSS Stylesheet

    Specify the contents of the custom mobile CSS style sheet.

    To implement this setting, you must set Embedded as theme under User Interface > Theme. The contents of this setting can be served from the URL of /public/resources/themes/embed/ssprMobileStyle.css.

    Embedded JavaScript

    Provide a Javascript to include a particular content in all pages inside an HTML tag near the bottom of the page.

    Custom Resource Bundle

    Select Custom to upload a custom ZIP file containing static HTTP resources that Self Service Password Reset serves from the HTTP path /public/resources/ that it adds to the configuration.

    The maximum ZIP file size is 10MB. Files included are types of HTML, text, images, and so forth. Self Service Password Reset does not perform any server-side processing when serving these files.

  6. Click Settings > User Interface > UI Features.

  7. Configure the following settings:

    Enable Showing Masked Fields

    Enable this option if you want to allow users to toggle the Show/ Hide button wherever required. This setting applies to all HTML masked password fields, regardless of the actual data type.

    Mask Password Fields

    Enable this option to hide the input fields with a standard password masking.

    Mask Response Fields

    Enable this setting to mask the challenge-response answers with standard password masking. This setting applies to both setup responses and forgotten password response entry screens.

    Show Cancel Button

    Enable this option to display the Cancel button to users wherever applicable.

    When users click Cancel, the system sends users to the forward URL (or logout URL if the password has been modified). The Cancel button does not appear on the Change Password screen if:

    • The password is expired

    • JavaScript is not enabled in the browser

    Show Success Pages

    Select this option to enable Self Service Password Reset to display success messages when an activity completes successfully.

    Show Login Page Options

    Select this option to display the Forgotten Password and other options on the Login page.

    Show Logout Button

    Select this option to display the Log Out button to an authenticated user.

    Show Home Button

    Select this option to display the Home button to an authenticated user.

    Show Idle Timeout Counter

    Select this option to display the user's remaining idle time. When that time reaches zero, the system redirects the user to the logout page.

  8. In the toolbar, click Save changes.