SSOSdk

SSOSdk is a library that provides Single Sign-On (SSO) integration using Redis. It allows generating SSO redirection URLs and validating SSO tokens with built-in Redis-based session management.

Features

• Initialize SSO SDK with Redis integration
• Generate SSO redirection URLs
• Validate SSO tokens
• Secure token storage with expiration handling

Owner

Developed and maintained by Vasizebron Technologies.

Installation

npm install @your-org/ssosdk

Usage

Import the SSOSdk

import { SSOSdk } from '@your-org/ssosdk'

Initialize the SDK

const ssoSdk = new SSOSdk({
  REDIS_CONFIG: {
    /* Redis configurations */
  },
  SSO_CONFIG: {
    SSO_TOKEN_EXPIRY_IN_SECS: 3600,
    WEB_APP_URL: 'https://your-app.com/sso/'
  }
})

await ssoSdk.initialize()

Generate SSO Redirection URL

const { redirectionURL } = await ssoSdk.generate({
  userId: '12345',
  redirectUri: 'https://your-app.com/dashboard'
})
console.log('SSO URL:', redirectionURL)

Validate SSO Token

const userData = await ssoSdk.validate({ token: 'generated-token' })
console.log('User Data:', userData)

API Reference

initialize()

Initializes the SSO SDK instance and establishes a Redis connection.

await ssoSdk.initialize()

generate(attrs: SSOGenerateProp): Promise<SSOGenerateData>

Generates an SSO redirection URL with a unique token stored in Redis.

const { redirectionURL } = await ssoSdk.generate({ userId: '12345' })

validate(attrs: SSOValidateProp): Promise<SSOValidateData>

Validates an SSO token and retrieves the associated user data.

const userData = await ssoSdk.validate({ token: 'generated-token' })

Error Handling

The SDK throws SSOError in case of errors. Common error types:

• SSO_SDK_NOT_INITIALIZED_ERROR: SDK not initialized before calling methods.
• REDIS_ERROR: Redis operation failure.
• SSO_TOKEN_EXPIRED_ERROR: Invalid or expired SSO token.

🎯 License

This project is licensed under the MIT License.

📬 Contact

• Author: Vasanthkumar
• GitHub: @vasanthkumar10
• Email: [email protected]