PingDirectory

Using custom rebranding

You can customize several visual elements of the console, including branding elements such as contact information or logos.

About this task

You can use the command line to configure the PingDirectory suite of products.

Tomcat 10 currently has an issue where Spring applications (such as this console) will not run correctly. Use Tomcat 9 or earlier.

Steps

  1. To customize the console, open the application.yml file and set <branding.custom-folder> to a local filepath that is not a subdirectory of the console application directory.

    This path should contain the elements for the console to display.

  2. Set the custom branding filepath on any PingDirectory suite of products console with the following dsconfig command:

    dsconfig set-web-application-extension-prop \
    --extension-name Console \
    --set init-parameter:branding.custom-folder=<path to folder>

Customizing text information

About this task

To customize text information, such as contact information or company names:

Steps

  1. Make a copy of the branding.properties.template file and rename it to branding.properties.

  2. Make the desired changes to the copy.

  3. Place the copy in the folder specified by the <branding.custom-folder> setting.

  4. Restart the console.

Customizing the color scheme or logos

About this task

To customize the color scheme or logos used by the console:

Steps

  1. Make a copy of the branding.css.template file and rename it to branding.css.

  2. Make the desired changes.

  3. Place the copy in the folder specified by the <branding.custom-folder> setting.

Customizing the page icon

About this task

To customize the page icon used by the console:

Steps

  1. Name the desired icon favicon.ico.

    The icon must be in .ico format.

  2. Place favicon.ico in the folder specified by the <branding.custom-folder> setting.