README.md

Keycloak SPI example

A simple example project for implementing Keycloak SPIs

Webinar

This demo is also available as a free webinar (in German).

Build

For a build you need to have set up Maven, Java, and Docker.

You can build this project with Maven running:

mvn clean install

Running the demo

After you have build the Docker image, you may run the demo with Docker Compose from the root directory of the repository:

docker-compose up

This starts Keycloak and makes it available at http://localhost:8080. Use user admin and password admin for login.

It also starts an additional container named mail. You may use it to check emails send by Keycloak. The web interface will be available at http://localhost:9080.

NOTE: Make sure you have configured email settings in Keycloak correctly. Use mail as hostname and keep the port to 25 (default).

Step by step

• Step 1: Register and enable provider
• Step 2: Add some logging to check if it works
• Step 3: Reuse default provider / Provider lookup
• Step 4: Configure provider