Vault

A lightweight wrapper for Keycloak authentication, making it easy to manage authentication workflows.

Features

• Powerful authentication based on Keycloak.
• Provides an intuitive API for managing authentication, tokens, and session states

Installation

Install via npm

You can install the library using npm or yarn:

npm install @cizion/vault
or
yarn add @cizion/vault

install via CDN

<script src="https://cdn.jsdelivr.net/npm/@cizion/vault/dist/vault.min.js"></script>

Usage

권장 사용법

// 1. Vault 인스턴스 생성
const vault = new Vault({
  url: "https://vault.livere.org",
  realm: "cobook",
  clientId: "app",
});

// 2. 수동으로 초기화
await vault.init({
  onLoad: "check-sso",
  checkLoginIframe: false,
});

// 3. 사용
console.log(vault.authenticated);

레거시 모드 (cobook.ai, staging.cobook.ai)

cobook.ai 또는 staging.cobook.ai 도메인에서는 하위 호환성을 위해 자동 초기화됩니다:

// 레거시 모드에서는 VaultLegacy 클래스 사용
const vault = new Vault(config); // VaultLegacy 인스턴스
// 자동으로 초기화됨 (autoInit = true)
console.log(vault.authenticated); // 인증 상태 확인

도메인별 동작 방식

• cobook.ai, staging.cobook.ai: VaultLegacy 클래스 사용 (자동 초기화)
• 기타 도메인: Vault 클래스 사용 (수동 초기화)

Deploy

1. yarn
2. yarn build
3. npm publish --tag latest