oidc-client-ts

What is oidc-client-ts?

The oidc-client-ts package is a TypeScript library for OpenID Connect (OIDC) and OAuth2 authentication. It provides a client-side solution for handling user authentication, token management, and secure API calls.

What are oidc-client-ts's main functionalities?

User Authentication

This code demonstrates how to configure and initiate a user authentication process using the oidc-client-ts package. It sets up the UserManager with the necessary OIDC configuration and starts the sign-in redirect process.

import { UserManager, WebStorageStateStore } from 'oidc-client-ts';

const config = {
  authority: 'https://example.com/oidc',
  client_id: 'your-client-id',
  redirect_uri: 'https://yourapp.com/callback',
  response_type: 'code',
  scope: 'openid profile',
  userStore: new WebStorageStateStore({ store: window.localStorage })
};

const userManager = new UserManager(config);

userManager.signinRedirect();

Token Management

This code snippet shows how to retrieve the current authenticated user and their tokens. If the user is logged in, their information is logged to the console.

userManager.getUser().then(user => {
  if (user) {
    console.log('User logged in', user);
  } else {
    console.log('User not logged in');
  }
});

Silent Renew

This code demonstrates how to set up silent token renewal. It listens for the access token expiring event and attempts to renew the token silently without user interaction.

userManager.events.addAccessTokenExpiring(() => {
  userManager.signinSilent().then(user => {
    console.log('Silent renew successful', user);
  }).catch(err => {
    console.error('Silent renew error', err);
  });
});

Logout

This code initiates the logout process by redirecting the user to the OIDC provider's logout endpoint.

userManager.signoutRedirect();

Other packages similar to oidc-client-ts

oidc-client

The oidc-client package is a JavaScript library for OpenID Connect and OAuth2 authentication. It is the predecessor to oidc-client-ts and provides similar functionalities but is written in JavaScript instead of TypeScript.

react-oidc-context

The react-oidc-context package is a React library for integrating OIDC authentication into React applications. It provides hooks and context providers to manage authentication state within a React app, making it easier to use with React compared to oidc-client-ts.

next-auth

The next-auth package is a complete authentication solution for Next.js applications. It supports multiple authentication providers, including OIDC, and provides a higher-level abstraction compared to oidc-client-ts, making it easier to integrate into Next.js projects.

README

oidc-client-ts

Library to provide OpenID Connect (OIDC) and OAuth2 protocol support for client-side, browser-based JavaScript client applications. Also included is support for user session and access token management.

This is a forked version of the oidc-client-js library, which has been archived and is no longer maintained. This version has been refactored from JavaScript to TypeScript. Trying to keep the API as compatible as possible. The support for the outdated implicit flow has been removed.

Contributions and help is much appreciated!

Table of Contents

• Documentation
• Installation
• Building the Source
• Contributing
• License

Documentation

Some initial docs are here.

Installation

Using npm

$ npm install oidc-client-ts

Building the Source

$ git clone https://github.com/authts/oidc-client-ts.git
$ cd oidc-client-ts
$ npm install
$ npm run build

Running the Sample

Parcel project

$ npm run -w parcel-sample start

and then browse to http://localhost:1234.

Angular app

can be found here.

Running the Tests

$ npm test

Contributing

We appreciate feedback and contribution to this repo!

License

This project is licensed under the Apache-2.0 license. See the LICENSE file for more info.