This repository contains example applications to demonstrate integrating with keycloak.
To use the examples in the app, you will need to have a keycloak client setup to integrate with. If you are using keycloak to integrate with a new application you will be building, you can use our our self-service webapp to create a new client.
dashboard.mp4
This is an example application setup to use a frontend single-page application(SPA)
with a backend API. To run this example, you will need a public keycloak client you can use.
Copy the installation JSON for your client into public/keycloak.json
. To run locally
ensure that your client allows http://localhost:3000
as a valid
redirect URI. Then from examples/nextjs-example
:
- Build Image:
docker build -t kc-demo .
- Run Image:
docker run -p 3000:3000 kc-demo
Visit localhost:3000
on your machine to test it out.
This is an example express app with a confidential client. To run this example,
you will need a confidential keycloak client you can use. If you have generated one with
our self-service webapp, copy the
installation json you receive into keycloak.json
. To run locally
ensure that your client allows http://localhost:3000
as a valid
redirect URI. Then from examples/nextjs-example
:
- Build Image:
docker build -t kc-demo .
- Run Image:
docker run -p 3000:3000 kc-demo
Visit localhost:3000
on your machine to test it out.
An example python API written in fastAPI, with a vuejs SPA frontend. The fastAPI backend
uses pyjwt as an example of fetching the
json web key from the .well-known
endpoint and using it to verify a tokens signature.
To run this example, you will need a public keycloak client you can use. If you have generated one with
our self-service webapp, copy the
installation json you receive into services/frontend/public/keycloak.json
. To run locally
ensure that your client allows http://localhost:3000
as a valid
redirect URI. Then from examples/nextjs-example
:
- Run:
docker-compose up
Visit localhost:3000
on your machine to test it out.