Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space WSTART and version 22.1

Include Page
ADMIN:Customizing PAS
ADMIN:Customizing PAS

You can customize the PAS login page, for example to adapt it to your corporate identity. The changes must be applied in the Keycloak installation. It is possible to change the colors, the background image, the logo, font settings as well as the favicon.

Three steps are necessary to customize your PAS login page:

Step 1: Inform Scheer Support

...

Image Removed

...

Contact the Scheer support team.

Our team will provide the default theme in the PAS installation directory.

Step 2: Rework Keycloak Theme

...

Image Removed

...

In Keycloak, go to the Realm Settings menu and open tab Themes.

In field Login Theme you should now be able to select a customized entry.

If you have saved the change, you can start overriding the Keycloak theme.

...

Image Removed

...

Keycloak is based on template files. You can override the Scheer PAS template files, images and CSS.

Go to the official Keycloak documentation for further information about the Keycloak themes.

Info

Edit your Keycloak theme on your test system first.

To see the effect, you need to switch the design in Keycloak (customer folder name) and you need to disable the cache to see changes while editing the files.

Code Block
titleDisable the Cache
docker exec -it <client-name>_scheer-keycloak bash

# inside the container

sed -i 's|<staticMaxAge>2592000</staticMaxAge>|<staticMaxAge>-1</staticMaxAge>|g' /opt/jboss/keycloak/standalone/configuration/standalone-ha.xml
sed -i 's|<cacheThemes>true</cacheThemes>|<cacheThemes>false</cacheThemes>|g' /opt/jboss/keycloak/standalone/configuration/standalone-ha.xml
sed -i 's|<cacheTemplates>true</cacheTemplates>|<cacheTemplates>false</cacheTemplates>|g' /opt/jboss/keycloak/standalone/configuration/standalone-ha.xml
exit

docker restart <client-name>_scheer-keycloak

Step 3: Enable the Cache

Enable the cache after you have finished editing the theme.

Code Block
titleEnable the Cache
docker exec -it <client-name>_scheer-keycloak bash

# inside the container

sed -i 's|<staticMaxAge>-1</staticMaxAge>|<staticMaxAge>2592000</staticMaxAge>|g' /opt/jboss/keycloak/standalone/configuration/standalone-ha.xml
sed -i 's|<cacheThemes>false</cacheThemes>|<cacheThemes>true</cacheThemes>|g' /opt/jboss/keycloak/standalone/configuration/standalone-ha.xml
sed -i 's|<cacheTemplates>false</cacheTemplates>|<cacheTemplates>true</cacheTemplates>|g' /opt/jboss/keycloak/standalone/configuration/standalone-ha.xml
exit

docker restart <client-name>_scheer-keycloak

Otp
Floatingfalse
maxHLevel2

...