Cp-auth-service NPM

Virava

Virava is a lightweight service designed to handle authentication inside a web application.

Dependencies

Getting started with Virava

This guide explains how to set up your project to begin using Virava. It includes information on prerequisites, installing and configuring Virava.

1. Install Virava

To install Virava you will need to have npm previously installed and then type in a terminal:

npm install virava

This will add project dependencies to package.json.

2. Usage

Virava currently supports 2 ways of handling authentication depending on the API used. One uses Keycloak and its default flow. The other - a custom Backend REST API.

All of them share similar approach. It is recommended to use the factory class to instantiate the Virava. Depending on the flow you are using you should cast the service instantiated so you can get additional/correct methods.

Keycloak approach:

import { AuthServiceFactory, ServiceType, KeycloakServiceDefault } from 'virava';

const authService = AuthServiceFactory.create(ServiceType.DEFAULT) as KeycloakServiceDefault;

Then you will need to add the configuration for the service (again depending on the flow).

import { KeycloakConfigDefault } from 'virava';

const config: KeycloakConfigDefault = {
  clientId:'',
  baseUrl: '',
  realm: '',
  tokenStorageKey: '', //optional
  refreshTokenStorageKey: '', //optional
  expirationDateStorageKey: '', //optional
  expirationRefreshDateStorageKey: '', //optional
  redirectUri: '' //optional
};

authService.init(config);

Custom approach:

import { AuthServiceFactory, ServiceType, KeycloakServiceCustom } from 'virava';

const authService = AuthServiceFactory.create(ServiceType.CUSTOM) as KeycloakServiceCustom;

Then you will need to add the configuration for the service (again depending on the flow).

import { KeycloakConfigCustom } from 'virava';

const config: KeycloakConfigCustom = {
  clientId: '',
  baseUrl: '',
  realm: '',
  tokenStorageKey: '', //optional
  refreshTokenStorageKey: '', //optional
  expirationDateStorageKey: '', //optional
  expirationRefreshDateStorageKey: '', //optional
  gatewayBaseUrl: ''
};

authService.init(config);

3. Start using Virava

To start using Virava simply import your instance of authService and trigger some of it's methods:

Keycloak Default pages approach:

/**
 * Initialises the auth service configuration. It returns Promise.
 */
authService.init(configuration);

/**
 * Redirects the user to the keycloak login page. It returns Promise.
 */
authService.login();

/**
 * Redirects the user to the register page. It returns Promise.
 */
authService.register(email, password, confirmPassword);

/**
 * Returns a boolean if the user is authenticated or not.
 */
authService.isAuthenticated();

/**
 * Logouts user and remove tokens from `localStorage`. It returns Promise.
 */
authService.logout();

Keycloak Custom pages approach:

/**
 * Initialises the auth service configuration.
 */
authService.init(configuration);

/**
 * This method is designed to work with Direct Access Grant flow of OAuth. It returns Promise.
 */
authService.login(username, password);

/**
 * This method registers the user. It returns Promise.
 */
authService.register(email, password, confirmPassword);

/**
 * This method resets user's password. It returns Promise.
 */
authService.resetPassword(email);

/**
 * This method changes the user's password. It returns Promise.
 */
authService.changePassword(email, currentPassword, newPassword, confirmPassword);

/**
 * This method refreshes the token and sets the new ones in `localStorage`. It returns Promise.
 */
authService.refreshToken();

/**
 * Logouts user and remove tokens from `localStorage`. It returns Promise.
 */
authService.logout();