Skip to content

garronej/oidc-spa

 
 

Repository files navigation

oidc-spa


Home - Documentation

An OIDC client tailored for Single Page Applications, particularly suitable for Vite projects.
This library is intended for scenarios such as integrating your application with Keycloak.

In straightforward terms, this library is ideal for those seeking to enable user login/registration in their web application. When used in conjunction with Keycloak (for example), it enables you to offer a modern and secure authentication experience with minimal coding effort. This includes options for signing in via Google, X, GitHub, or other social media platforms. We provide comprehensive guidance from beginning to end.

  • 🎓 Accessible to all skill levels; no need to be an OIDC expert.
  • 🛠️ Easy to set up; eliminates the need for creating special /login /logout routes.
  • 🎛️ Minimal API surface for ease of use.
  • 🕣 Easy implementation of auto logout. Are you still there? You will be logged out in 10...9...
  • ✨ Robust yet optional React integration.
  • 📖 Comprehensive documentation and project examples: End-to-end solutions for authenticating your app.
  • ✅ Best in class type safety: Enhanced API response types based on usage context.

Comparison with Existing Libraries

While oidc-client-ts serves as a comprehensive toolkit, our library aims to provide a simplified, ready-to-use adapter that will pass any security audit and that will just work out of the box on any browser.
We utilize oidc-client-ts internally but abstract away most of its intricacies.

react-oidc-context is a React wrapper around oidc-client-ts.
oidc-spa also feature a carefully crafted React API that comes with example integration with:

Beside the fact that this lib only works with Keycloak it is also likely to be deprecated.

🚀 Quick start

Heads over to the documentation website 📘!

Showcases

This library powers the authentication of the following platforms:

Onyxia

image

The French Interministerial Base of Free Software

image

About

Mirror for deploying the example on Vercel for free

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 100.0%