Keycloak extensions

Keycloak extension examples.
Titles with * are already activated when running docker-compose up

• provider-domain *
  • example of adding new domain entities
• spi-event-listener *
  • example of a custom event listener
• spi-mail-template-override *
  • example on how to change default mail behaviour and add extra variables to it.
• spi-registration-profile
  • disable first and last name validation in the registration page
• spi-resource *
  • example of a custom REST resource
• theme-minimal *
  • a custom theme with minimal changes

Build

Build all

./mvnw clean install

Build single module

./mvnw clean install -pl provider-domain
./mvnw clean install -pl spi-event-listener
./mvnw clean install -pl spi-mail-template-override
./mvnw clean install -pl spi-registration-profile
./mvnw clean install -pl spi-resource
./mvnw clean install -pl theme-minimal

Run with Docker Compose

You need to build all modules first because we mount the jars in the docker-compose file

Run

docker-compose up

Stop

CTRL + C
docker-compose down    

• Keycloak admin will be available on http://localhost:8088/auth/
  • User -> admin
  • Password -> password
• A placeholder realm is available on http://localhost:8088/auth/realms/placeholder
  • users
    • james@placeholder.com
    • jennifer@placeholder.com
    • john@placeholder.com
    • mary@placeholder.com
    • patricia@placeholder.com
    • robert@placeholder.com
  • Password is always 'password' for those users
  • a realm role product_view is available and assigned to robert@placeholder.com
  • 2 clients are available under this realm
    • client-one - public with Direct Access Grants Enabled
    • client-two - public with Direct Access Grants Enabled
• Mailhog will be available on http://localhost:8025/

Export realms and users

• Run docker-compose up
• Make your changes in Keycloak
• Press CTRL + C but do NOT run docker-compose down
• Uncomment the -Dkeycloak.migration.action=export... under commands in the docker-compose file.
• Comment the -Dkeycloak.migration.action=import under commands in the docker-compose file.
• Run docker-compose up
• all realms and users will be exported in the _resources/demo-config/export-dir
• You can now run docker-compose down and revert the changes you made to the docker-compose file
• Copy the contents of the export dir to the import dir if you want to replace them

Other resources

Don't forget to look in the actual Keycloak code itself because the examples are based on the implementations itself.

• https://github.com/keycloak
• https://github.com/keycloak/keycloak/tree/master/examples
• https://www.keycloak.org/docs/latest/server_development/
• https://github.com/thomasdarimont/keycloak-extension-playground