Connect-unified-login-system NPM

Connect Unified Login System

connect-unified-login-system is an NPM package that helps websites seamlessly integrate with the Unified Login System for user authentication purposes. By using this package, developers can enable secure, efficient, and user-friendly authentication for their applications.

Features

Simple integration with the Unified Login System.
Facilitates secure authentication using unique public keys.
Streamlined communication with the Unified Login System's API.
Supports JWT token-based authentication for backend validation.

Installation

Install the package via npm:

npm install connect-unified-login-system

Usage

Import the package and use it in your code to connect to the Unified Login System.

Example:

import { connectToUnifiedLoginSystem } from 'connect-unified-login-system';

const handleUnifiedLoginSystem = async () => {
    const publicKey = "xx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"; // Replace with your own public key
    
    try {
        const response = await connectToUnifiedLoginSystem({ publicKey });
        if (response.isError) {
            console.error("Error from Unified Login System:", response.msg);
        } else {
            console.log("User Data:", response);
            // Send authToken to your backend for validation
        }
    } catch (error) {
        console.error("Error connecting to Unified Login System:", error);
    }
};

handleUnifiedLoginSystem();

API

`connectToUnifiedLoginSystem({ publicKey, isProd })`

Parameters

publicKey (string, required): Your unique public key provided by the Unified Login System. It is used to authenticate your application.
isProd (boolean, optional): If you want to return response to your Production URL provide true.

Returns

A Promise that resolves to an object containing user data or an error message.

Example Successful Response

{
    "name": "John Doe",
    "emailId": "john.doe@example.com",
    "isError": false,
    "authToken": "ey..." // JWT token to pass to your backend for validation
}

Example Error Response

{
    "isError": true,
    "msg": "Popup was blocked. Please allow popups for this site."
}

How It Works

The package opens a popup window where the user can log in to the Unified Login System.
On successful login and granting permission, the system sends user data (name, email) and an authToken back to your website via the popup.
You can send the authToken to your backend for validation using the Unified Login System's third-party token authentication API.
If the user closes the popup or denies permission, you will receive an error response.