Skip to content

How to activate Keycloak for Budgeteer

Jump to bottom Edit New page
Maxim Atanasov edited this page Dec 13, 2018 · 2 revisions

How to configure Keycloak for Budgeteer.

  1. Download Keycloak here.

  2. Go to the bin/ directory of the server distribution. To boot the server:

Linux/Unix

$ ./standalone.sh

Windows

> .\standalone.bat

  1. After the server boots, open your browser and go the http://localhost:8080/auth URL.

  2. Keycloak has no admin account by default. Therefore you have to create an admin account on the welcome page.

  3. Once you've created an admin account. You can log in to the Admin Console by clicking on the Administration Console link or by using the http://localhost:8080/auth/admin/ URL. Afterwards the Admin Page opens.

  4. Now you're in the Master realm. You can now create a new realm. Simply hover over Master and a button "Add Realm" should appear. Name your new realm demo, which is the default name for the budgeteer realm.

  5. To use Keycloak for Budgeteer, you have to create a Budgeteer client. The sidebar has the button "Clients", simply click on "Clients" and then on "Create". The default "Client ID" for Budgeteer is budgeteer. Set "Access Type" to "confidential" and type in a "Valid Redirect URL". Budgeteer has the default http://localhost:8080/* URL. Click on "Save" at the bottom of the site.

  6. Once you've completed these steps there should be a new tab called "Credentials" at the top of the site. Open the tab "Credentials" and copy the "Secret" key that is displayed next to the "Regenerate Secret" button. Go to the application.properties inside the budgeteer-web-interface subproject and replace the default "keycloak.credentials.secret" with the new key.

  7. Set the adapter.keycloak.activated property to true.

  8. Remove or comment out the line containing the spring.autoconfigure.exclude property.

  9. In the Keycloak admin console, go to "Realm Settings", open the "Login" tab and enable "User registration". Now you can either create a new User on the Login Page or create one as an admin with the admin console.

  10. Now we head to "Roles" , add a new role called "user" and add it to the Realm "Default Roles". Now every user created on the Login Page or created by an admin has the default role "user".

  11. At the end we close Keycloak and launch it again:

Linux / Unix

$ ./standalone.sh -Djboss.socket.binding.port-offset=100

Windows

> .\standalone.bat -Djboss.socket.binding.port-offset=100

Now Keycloak has the http://localhost:8180/ address. Launch your Database and afterwards the Budgeteer.

Add a custom footer
Add a custom sidebar
Clone this wiki locally