Keycloak React.JS Demo
Demo and reference implementation for React.JS and Keycloak IAM & SSO integration.
With this approach, there's no need for 3rd party dependencies (besides the official default keycloak-js
lib) and custom components base on auth state are implemented with ease and best developer experience.
YouTube videos
There are three videos on YouTube about this demo repository and how to integrate your React.js based application with Keycloak:
Part 1: Configuration & Usage, w/o 3rd party libs
Part 2: Conditional rendering of components
Part 3: React Router Integration, depending on Keycloak Roles
Please check out also my entire Youtube Channel with various videos on Keycloak and stuff around:
Prerequisites
- based on React version >= 18 and Vite
- uses React Router v6
- Keycloak server should be a most recent one
!!! Important Notice !!!
This demo is just for showing one possibility on how to configure the app when using Keycloak and it requires a certain knowledge about Keycloak SSO (installation, operation, configuration), see http://www.keycloak.org.
Backend service
For convenience, I provide a working backend service, providing the data, running on AWS Lambda. It should work and be available out of the box.
However, there's also a swagger spec (backend-swagger-spec.yml
) providing the API of the needed backend, so you can spin up a service on your own.
The URLs in the securityDefinitions
section shows my local Keycloak setup, you have to adjust this possibly!
(Also don't forget to adjust the host/port in the setupProxy.js
file, if you run your service on ohters than default.)