With the exception of app-html5 and app-profile-html5, all examples are deployed as a WAR. These examples assume that a Keycloak server is running on localhost:8180 and a WildFly server is running on localhost:8080.
If you want to change the address of the Keycloak server, edit the keycloak.json file in each example's WEB-INF directory. If you want to change the address of the WildFly server, edit each example's client detail in the UI of the Keycloak server.
To install and run all the WAR-based examples:
- Download this keycloak-examples repository.
- Download and unzip the plain keycloak distribution. Do not download the demo dist.
- Download an unzip WildFly.
- Download the Keycloak OIDC adapter for WildFly. Unzip this adapter on top of WildFly.
- Download the Keycloak SAML adapter for WildFly. Unzip this adapter on top of WildFly. It's OK to overwrite modules.
- cd <Keycloak Home>/bin
- standalone(.bat or .sh) -Djboss.socket.binding.port-offset=100
- In your browser, go to http://localhost:8180/auth/admin/index.html
- Login with admin/admin and change the password when prompted.
- In the upper lefthand corner, click on Master->Add Realm
- Click "Select File" and choose examples-realm.json from the root of the keycloak-examples repo from step 1.
- cd <WildFly Home>/bin
- standalone(.bat or .sh)
- With WildFly running, open a new command prompt and cd <WildFly Home>/bin again. Then execute the following three commands to finish adapter install.
- jboss-cli -c --file=adapter-install.cli
- jboss-cli -c --file=adapter-install-saml.cli
- jboss-cli -c --command=:reload
- At the root of the keycloak-examples repo, run mvn wildfly:deploy
The Examples realm you imported has two users, secure-user and admin-user. Both use "password" as the password.
You can run each example with the following URLs: