Authenticate users with OpenID Connect authentication service (f.e. Keycloak) in browser, Electron, or Capacitor app
Main features:
- TypeScript support
- ESModule support
- Working with React, Angular and other popular front-end libraries
- Working in browser, Electron and Capacitor applications
- Logging user in using redirect to the auth service
- Getting user info claims
- Supplying access token for requests to the back-end
- Automatic refreshing of the access token with refresh token when it expires
- Logging user out from the application and from the auth service
How to use
1. Install library using npm
npm install tcomad-oidc --save
2. Import AuthService
import {AuthService} from "tcomad-oidc";
3. Initialize AuthService
new AuthService(config);
Config object fields:
- authority: URL to the authentication service (f.e. http://[host]/realms/[realm-name])
- clientId: ID of the application registered within authentication service
- (OPTIONAL) errorHandler: callback function that will be called in case of auth errors
- Defaults to (error) => console.log(error)
- (OPTIONAL) autoLogin: Determines whether authentication should start automatically when page loaded
- (OPTIONAL) electronRedirectUrl: URL which must be used to return user to Electron app
- (OPTIONAL) capacitorRedirectUrl: URL which must be used to return user to Capacitor app
4. Start login
Login will be started automatically if it was configured to do so, if no, you can start it by
authService.login()
5. Check login status
You can check login status with
authService.isLoggedIn()
6. Get user info claims
To get user info claim you can use
authService.getUserInfo("name")
7. Get access token to make requests
You can get user access token with
authService.getToken()
8. Force refresh
You can force lib to refresh tokens and user info with:
authService.tryToRefresh()
9. Logout user
You can log out user from your application and authentication service with
authService.logout()
Download Details:
Author: Misha999777
Source Code: https://github.com/Misha999777/tcomad-oidc
License: MIT license
#electron #javascript