Skip to content

zsamji/keycloak-example-apps

 
 

Repository files navigation

About

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.

Examples

dashboard.mp4

public-nextjs

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.

Confidential-express

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.

public-fastAPI

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.

About

Example applications for integrating with keycloak

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 41.2%
  • JavaScript 36.6%
  • Vue 7.0%
  • Python 5.3%
  • Dockerfile 2.8%
  • CSS 2.5%
  • Other 4.6%