Skip to main content
Version: 6.15.0

Keycloak Theme Configuration

SmoothGlue bundles a custom Keycloak theme to provide a unified look and feel between the various platform tools bundled with SmoothGlue Enterprise. This Keycloak theme can be configured by platform administrators depending upon requirements.

Terms of Use Banner​

Certain environments may require users to accept terms of use for the platform prior to logging in. This is common for government systems which require the US Government (USG) Information System (IS) Warning and Consent Banner to be displayed or System Use Notifications for platforms subject to NIST 800-171 03.01.09. The SmoothGlue Keycloak supports a configurable Terms of Use banner for this use case, which can be set on a per-realm basis.

Example Terms of Use Banner

To configure the terms of use banner:

  • Log into Keycloak's admin console and select the realm you wish to modify.
  • Navigate to "Realm Settings" -> "Localization" -> "Realm Overrides".
  • Click the "Add Translation" button to add a translation with the key "termsText". The value should be the text of your Terms of Use banner. This field supports HTML tags.
    • If this field's value is set to an empty string, no terms of use banner will be displayed prior to login. This is the default.

The other text on the terms of use banner page can also be configured. These include:

  • termsTitle
    • This text will be shown as a header for the terms of use banner.
    • If this field is set to an empty string, no title will be shown for the banner.
  • termsAcceptanceRequired
    • This text will be show as a footer below the terms of use, above the acceptance button.
  • acceptTerms
    • This text is shown on the button to accept the terms of use.

Example Terms of Use Banner Realm Configuration