LearnMake KEYCLOAK

Baseline setup with reference-apps using KEYCLOAK!
See also medium-article

LEARN - MAKE - SHOW - SHARE

Prerequisites

In order to build and run this app you need to have a couple of things installed:

• The Docker Toolbox or native Docker, whatever you prefer. See Docker and Docker-Compose
• (for dev) An IDE for the development, like Atom or IntelliJ
• (for dev) Node.js, npm, and Yarn installed, see package.json for the required versions.
• (for dev) Get familiar with VueJS.
• (for dev) Get familiar with Spring Boot

Keycloak instance with Docker

Building and running via Docker and Docker-Compose:

$ docker-compose up --build   

  # NOTE: in linux-env you might have permission problems with 'docker-data-*' folders      
  # to fix; stop docker-compose, set permissions as below, then run docker-compose again.    
$ sudo chown 1001:1001 -R docker-data-*  

  # to shut it down, ctrl+c and   
$ docker-compose down   

docker-compose up gets Keycloak instance up and running in your local environment.
Now you can access Keycloak admin panel via http://localhost:8081
the default admin username+passwd is inside docker-compose.yaml

After you login, you need to setup a Realm and Client!
NB! By default, docker-compose while starting should also reimport default config like realm, client and users.

If you still want to do this manually:
To learn more about creating a realm/clients/users, see https://www.keycloak.org/docs/latest/server_admin/index.html#admin-console
p.s. You can also reuse the first part of baeldung-tutorial*.

Here is just an outline of what you need to do for running these examples:

• create a realm named KeycloakExampleApp
• turn off the requirement of ssl for this realm (realmsettings -> login -> require ssl -> none)
• create a client named login-app with default Client ID openid-connect and AccessType as public. And also set Valid Redirect URIs as http://localhost:8081/* which is the base URI of keycloak server.
• create a user Role (Roles -> add role)
• create a user named myuser with password mypass (Users -> add user). Make sure to activate, Role Mapping to userrole.

the resulting keycloak.json should yield:

{
  "realm": "KeycloakExampleApp",
  "auth-server-url": "http://localhost:8081/auth",
  "ssl-required": "none",
  "resource": "login-app",
  "public-client": true,
  "confidential-port": 0
}

NB! Client settings requires Valid Redirect URIs for each of the reference-app, see

After you've done all the config, now you can use Reference Apps which are listed below.

Separately building & running Reference Apps

See list of reference implementations

• KEYCLOAK using Spring Boot
• KEYCLOAK using Node.js/Vue.js
• KEYCLOAK using Golang
• more...MiP...