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
Contact the Scheer support team. Our team will provide the default theme in the PAS installation directory. |
Step 2: Rework Keycloak Theme
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. | |
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. 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.
Disable 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.
Enable 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
Overview
Content Tools