Git Product home page Git Product logo

redux-oidc's Introduction

redux-oidc

Build Status

A package for managing OpenID-Connect authentication in ReactJS / Redux apps. It wraps the popular oidc-client library to redux actions and reducers.

Description

This package handles OpenID-Connect authentication in redux apps. It enables redux apps to authenticate with an external OIDC authentication provider and handles the actions of the OpenID implicit flow.

It uses the oidc-client-js library to manage OpenID Connect functionality.

It contains the following parts:

  • CallbackComponent: A react component processing the signin callback from the OpenID-Connect provider,
  • SignoutCallbackComponent: A react component processing the signout callback from the OpenID-Connect provider,
  • reducers & actions: reducers and actions to handle OIDC events,
  • helpers: create helpers to manage the oidc-client-js library

Installation

npm install --save redux-oidc

Peer dependencies

This package wraps oidc-client-js to use with ReactJS / Redux apps. Install oidc-client like this:

npm install --save oidc-client

In addition there is a peer dependency for immutable.js, if you want to use it.

babel-polyfill

You need the babel-polyfill in your build configuration for this package to work.

Version 3 released

I've decided to overhaul the API of this library. The main changes include:

  • removed childContext from the <OidcProvider />, user manager now must be passed in as a prop,
  • immutablejs is now an optional dependency and doesn't need to be installed for those not using it,
  • dropped support for shouldValidate - the middleware now always validates the user,
  • dropped support for triggerAuthFlow - this must now be initiated by a custom action (see example app),
  • cleaner API all around

The example app is already updated to reflect these changes.

Documentation

You can find the docs for version 3 here:

Note for react-native users

This library doesn't fully support react-native apps. Please use this library instead.

Version 2

Check out the wiki for further information for Version 2 (deprecated).

Sample app

There is a sample application demonstrating the use of this package here.

Tests

npm run test

redux-oidc's People

Contributors

brandonboone avatar crowmw avatar cymen avatar danpoq avatar henrikwm avatar johnniescode avatar jonaskello avatar masonvx avatar maxmantz avatar notatestuser avatar oterral avatar salvoravida avatar woltsu avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.