Authentication Provider for Multiple Platforms

📦 Package Renamed: This package was previously published as @platform-x/hep-keyclock-adapter. Please update your dependencies to use the new name.

A simplified, easy-to-use authentication manager supporting multiple authentication providers including Keycloak, with plans for Auth0, Azure AD, and Okta.

Installation

npm install @platform-x/hep-authentication-provider

Basic Usage

import AuthenticationManager from '@platform-x/hep-authentication-provider';

// Initialize with provider and config - that's it!
const auth = new AuthenticationManager('sitename', 'Usertype');
auth.getUserList();

Available Methods

All methods automatically handle access tokens internally - no manual token management needed!

• validateUserPassword(username, password) - Validate user credentials
• createUser(userData, password) - Create new user
• updateUser(userData) - Update existing user
• deleteUser(userId) - Delete user
• getUserList(args?) - Get list of users with optional search/pagination
• getUserDetail(userId) - Get user by ID
• getUserDetailByEmail(email) - Get user by email
• validateUser(username) - Validate if user exists

Development

npm run build        # Build the project
npm run build:watch  # Watch for changes and rebuild

Supported Providers

Currently supported authentication providers:

• keycloak - Keycloak authentication server

Migration from Legacy

// New way (provider-based) import AuthenticationManager from '@platform-x/hep-authentication-provider'; const auth = new AuthenticationManager('sitename', 'Usertype');

All methods work the same way - plus automatic token management means you never have to worry about access tokens!

## Key Benefits

✅ **Automatic Token Management** - No need to handle access tokens manually  
✅ **Provider-Based** - Easy to extend for other authentication providers  
✅ **Simple API** - Just initialize and use - tokens handled internally  
✅ **Error Resilient** - Built-in token refresh capabilities  
✅ **Type Safe** - Full TypeScript support  
✅ **Backward Compatible** - Existing code continues to work