PingID Administration Guide

Customizing the PingID enrollment page (legacy)

Customize the look and feel of the PingID mobile app enrollment page for the PingID user.

About this task

Configure the enrollment page by adding your organization’s logo, changing the background appearance, and adding a background image or changing the color to reflect your organization’s branding.

  • The legacy enrollment page is now in maintenance mode, and only critical bugs related to the page will be handled. The option of using the legacy enrollment page will be removed completely on July 1, 2022, and any organizations still using the legacy enrollment page will automatically be migrated to the enhanced enrollment page. It is therefore recommended that you use the new enrollment page. For details on customizing the new enrollment page, see Customizing the PingID Enrollment page.

  • PingID Authenticator supports Content Security Policy (CSP) to prevent unverified scripts from running in the PingID environment. CSP-supported browsers will not execute custom scripts defined in the enrollment page. To benefit from the latest security enhancements, always update your web browsers to include the latest security features and security patches.

Steps

  1. Go to Setup → PingID → Branding → Enrollment.

A screen capture of the PingID Enrollment branding and settings configuration workflow.
  1. Customize one or more of the following elements:

    Option Description

    Logo

    Select the icon you want to apply to the swipe screen and enrollment page.

    • No Logo: (default): do not apply a logo.

    • Corporate Logo: Use the corporate logo configured in your PingOne dock settings. If you have not assigned a logo in the dock settings, this option is unavailable. For more information, see Customize the Dock Settings in the PingOne Administration Guide.

    • Upload Logo: To add a logo, click Upload Logo, navigate to the icon file you want to use, and then click Open. The logo can be a JPEG, JPG, GIF, or PNG file with a maximum size of 5 MB.

      The logo configuration applies to both the swipe screen and the enrollment page.

    Download Link Button

    Customize the look and feel of the Get Download Link button.

    • To change the button background color, click the left color picker and select the background color or enter the relevant hex number.

    • To change the button text color, click the right color picker and select the text color or enter the relevant hex number.

    • Click Reset to restore the default values.

    Background Color

    Customize the background color of the enrollment page, click theBackground Color color picker and, select the background color or enter the relevant hex number.

    This option is only available if a background image is not selected. Click Reset to restore the default setting.

    Background Image

    Set a background image for the enrollment page.

    1. Click Remove to remove any existing image.

    2. Click Select File, navigate to the icon file you want to use, and then click Open.

      The logo can be a JPEG, JPG, GIF, or PNG file with a maximum size of 5 MB.

    3. Text Color: Select Dark or Light to customize the text color appearing in the Enrollment page.

  2. PingID provides customizable message texts for each of the supported languages. To customize messages on the enrollment page, see Customizing the enrollment page text by language locale.

    When the end user’s machine’s locale is set to one of PingID’s supported languages, the user receives enrollment messages in that locale’s language. If the user’s locale is not a language supported by PingID, then the user receives enrollment messages in English.

  3. Click Preview Full Size to preview the changes as they will appear on your organization’s enrollment screen.

    A screen capture of customizing the background and preview window for the PingID enrollment page.
    A screen capture of the preview of a customized PingID enrollment page and mobile app download invite.

    Click Save.

Clicking Discard Changes in the PingID Home, Swipe Screen, or Enrollment windows discards any changes made in all of the windows since the last save.