A Detailed Guide to Securing React applications with Keycloak
Digital technology has presented us with a myriad of applications at our disposal, and you would almost always require proper authentication to gain authorized access to the application data by having login/logout capability. If you think from a user perspective, we have several different identities and credentials to manage for different applications we access. Having a single set of credentials for all of our applications would be so convenient, isn’t it? This is what the Single Sign-On (SSO) capability provides, and it is really important for the success of an Enterprise’s Identity and Access Management (IAM).
Keycloak is an open-source platform developed and maintained by the RedHat Community.This product makes the developer’s job easy by enabling SSO for applications and authorized access to services with less/no codes.
Keycloak is an open source Identity and Access Management solution aimed at modern applications and services. It makes it easy to secure applications and services with little to no code
Some of the Keycloak features, such as Identity Brokering, User Federation, Client Adapters, Admin Console, Account Management Console, Standard Protocol, Authorization Services, Documentation and Clustering Support further enhance business applications.
In this blog, we will see how we can use Keycloak to setup identity and access management in a React application using Google as the identity provider.
GETTING STARTED WITH KEYCLOAK
In order to get started, we first need to setup Keycloak. You can follow the official getting started guide here to have this setup.
Quick steps to get started with Keycloak:
- Install and boot your keycloak server by downloading the server zip file, unzipping it and booting it using standalone.bat in windows and standalone.sh in Linux
- Once the server boots, you can open the server in your browser using http://localhost:8080/auth and see the welcome page which shows that the server is running.
- First create the admin account, using which you can login to the master realm’s administration console, from which you can create other realms and users and also register your applications to be secured by Keycloak.
The realm is like a namespace for the configuration that allows you to manage the entire metadata/configuration within different buckets called realms. By default you get the master realm, which should be used for administration purposes only, and you should avoid creating your configuration in the master. You can create multiple realms based on your requirement and create your users and register your applications within them.
- Next you can login to the admin console (http://localhost:8080/auth/admin/) using the admin account details you created in step 3.
- In the admin console, you can create a new Realm called demo from the Master drop-down menu by clicking Add Realm option.
- Include the identity provider by adding social networks like Google, using which you want to facilitate sign-in by providing the google app client id and secret key.
- For this, you need to add your application in the google developers console(https://console.developers.google.com/).
- Create a new google project.
- Setup OAuth consent screen by selecting external/internal depending on the level of google authentication you wish to apply.
- Create credentials by providing the keycloak url(http://localhost:8080/auth/realms/demo/broker/google/endpoint) as the Authorised redirect URIs. This will give you the client id and secret key which you will use in the next step for adding identity providers
- Add identity provider by using the client id and client secret you got from google console for your new application
- Now select the newly created Realm from the drop-down, you can perform the other metadata setup.
- Next, create a Client for your React application which you want to secure with Keycloak Root Url: Application Hostname
Client ID: demo
With the keycloak server setup up and running, we can start with our react application.
PROCESS TO SETUP REACT APPLICATION WITH KEYCLOAK
Now we will see the steps of setting up react application with keycloak.
- Let’s first create our application using the below command.
npx create-react-app react-keycloak-app
- Install the keycloak-js dependency
npm install keycloak-js
- The keycloak configuration can be saved as a json file under the public folder by creating a resources subfolder.
The keycloak.json is as follows:
In this example, we will include the logic of keycloak initialization and refresh in the index.js as shown below:
You will get redirected to the below login screen
Click on the google button and provide your google credentials to be authenticated and taken to the application page as shown below:
You can find the complete code on github
In this blog, we saw how to setup Keycloak server, configure it with Google as its identity provider and use it to secure a simple React application. With keycloak you can setup multiple identity providers from existing social networks or setup user defined authentication servers and use it to secure all your React applications with ease.
Originally published at https://walkingtree.tech on January 6, 2020.