The Cyboinsect uses Keycloak. Out of the box, the UI provided by Keycloak is quite different from the rest of Theme I Build. But Keycloak allows a customer to provide alternative themes to replace the default Keycloak themes. We use this mechanism to provide an Cyboinsect theme.
The following themes can be replaced.
- login
- regitser
- forgot-password
- change password
- admin
This projects contains a theme that can be used to replace the login theme to provide an experience that is consistent with Cyboisect.
Since Keycloak supports Freemarker, a template file is provided along with css styles and images.
- After installing Keycloak, navigate to the themes directory as in e.g.
~/development/keycloak-8.0.0.Final/themes
- Create a directory named Cyboinsect.
- Copy the login directory from this project to a login directory in the Alfresco theme directory you just created
- Start Keycloak
NOTE: These instructions assume you are using a Keycloak realm named cyboinsect such as is created by the Cyboinsect Team. But you can also apply the theme to the default realm or some other realm.
- Navigate to the admin console for the realm as in e.g.
http://localhost/auth/admin/master/console/#/realms/cyboinsect
- Choose the Cyboinsect theme as illustrated. Click Save.
- Login to a page in the Cyboinsect realm that requires authentication (e.g. http://localhost/auth/realms/cyboinsect/account) and you should see a form like this.
If you want to learn more about how to customize Keycloak themes, go here.