Configuring Interface settings - Platform - BlueCat Gateway - 25.3.0

Gateway Administration Guide
ft:locale
en-US
Product name
BlueCat Gateway
Version
25.3.0

Interface settings (on the General configuration page) let you configure BlueCat Gateway's appearance. You can add your organization's logo to Gateway and specify the theme/color palette that Gateway uses when displaying workflows that use the legacy UI.

Tip: You can further customize Gateway's appearance in the Customization section of General configuration.

To configure interface settings:

  1. Open the General configuration window, then expand the Interface section. (Click Settings at the bottom of the navigator on the left, expand Configurations, then click General configuration. Click Interface to scroll to the Interface section.)

  2. Edit the visual appearance of the UI as desired.

    For more details, see Interface settings list below.

  3. When you're done, click Save changes.

    To cancel your changes, click Cancel.

Interface settings list

The Interface section has the following settings.

Setting Description
Header logo

The logo that appears in the header at the top of the Gateway UI.

To change the header logo, either drag the logo image file onto the Import header logo box area, or click in the box area to browse to a file. You can use any image file format supported by your browser.

By default, Gateway uses the BlueCat Gateway logo.
Login page logo

The logo that appears on the login page when users log in to Gateway.

To specify the login page logo, in Login page logo, select the logo to use on the Login Page.

  • To use the BlueCat logo, select either the Light logo or the Dark logo.

    Note: If you are using the standard Light or Dark themes, use the opposite logo (such as the Dark logo with the Light theme). Otherwise, the logo will blend in with the background.

  • To use your own logo, select Custom. Then, either drag the logo image file onto the box area, or click in the box area to browse to a file.

    You can use any image file format supported by your browser.

Tip: You can also configure the Login page logo through settings in the config.json configuration file: 
{
  "login_logo_mode": "dark",
  "login_logo_custom_file": null
}
  • To use the default light or dark logo shipped with BlueCat Gateway, set login_logo_mode to either light or dark, respectively.
  • To use a custom logo, set login_logo_mode to custom and login_logo_custom_file to a path that’s relative to <Workspace folder>/resources/images. Place the custom logo image in <Workspace folder>/resources/images/login_logo_custom_file.

Import custom interface

Interface theme

The Custom interface and Interface theme settings let you specify the color and style theme used by Gateway UI workflows.

In Interface theme, you can select the the theme that you want to use.

  • The standard Light and Dark themes affect both current and legacy UI workflows.

  • Custom themes currently affect only legacy UI workflows (typically custom workflows and some adaptive plugins or applications). They do not affect workflows that use the new UI elements introduced in v23.2 or v25.2, including all built-in workflows.

To specify and use a custom theme:

  1. Either drag the theme's UI customization JSON file onto the Import custom interface box area, or click in the box area to browse to a file.

    For more details on UI customization JSON files, see Color palette UI customization files.

  2. Select the name of the desired theme in the Interface theme list.

  3. Click Save changes when you're done.