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 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
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
- 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/
- Run
docker-compose up - Make your changes in Keycloak
- Press
CTRL + Cbut do NOT run docker-compose down - Uncomment the
-Dkeycloak.migration.action=export...under commands in the docker-compose file. - Comment the
-Dkeycloak.migration.action=importunder 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 downand 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
Don't forget to look in the actual Keycloak code itself because the examples are based on the implementations itself.