@brb-bank/sso-vue3
v0.1.7
Published
BRB custom Single Sign-On (SSO) client for Vue 3 applications
Readme
@brb-bank/sso-vue3
BRB SSO Vue-3 SDK — Vue 3 ilovalari uchun plug-and-play Single Sign-On yechimi. SDK autentifikatsiya flow’ni to‘liq o‘zi boshqaradi.
Siz faqat app.use() va logout() ishlatasiz — qolgan hammasi avtomatik.
✨ Asosiy imkoniyatlar
✅ Vue 3 plugin (app.use)
✅ OAuth2 / Keycloak SSO
✅ Avtomatik login redirect
✅ Avtomatik callback handling
✅ Tokenlarni saqlash va yangilash
✅ Global logout() API
✅ TypeScript support
✅ Zero config callback page
📦 O‘rnatish npm install @brb-bank/sso-vue3
🔧 Talablar
Consumer project’da bo‘lishi kerak:
vue ^3.x
vue-router ^4.x
axios ^1.x
🚀 Tez boshlash (Minimal setup) 1️⃣ main.ts — SSO ni ulash import { createApp } from 'vue' import App from './App.vue' import router from './router'
import { createSSOAuth } from '@brb-bank/sso-vue3'
const app = createApp(App)
app.use( createSSOAuth({ authBaseUrl: import.meta.env.VITE_SSO_URL, authApiBaseUrl: import.meta.env.VITE_SSO_API_URL, clientId: import.meta.env.VITE_SSO_CLIENT_ID }) )
app.use(router) app.mount('#app')
📌 Izoh:
Token tekshiruvi
Login redirect
Callback handling hammasi avtomatik bajariladi.
🌍 .env konfiguratsiya VITE_SSO_URL=https://sso.brb.uz VITE_SSO_API_URL=https://sso-api.brb.uz VITE_SSO_CLIENT_ID=crm-corporate-client
🚪 Logout (Top Navbar) import { logout } from '@brb-bank/sso-vue3'
function onLogout() { logout() }
📌 Nima qiladi:
Access & Refresh tokenlarni o‘chiradi
Foydalanuvchini SSO login sahifaga yo‘naltiradi
🧠 Qanday ishlaydi (ichkarida)
SDK ichida avtomatik bajariladi:
🔐 Tokenlarni saqlash (localStorage)
🔁 Login / redirect flow
🔄 Callback (code → token)
📡 Axios Authorization header
🧹 Logout & cleanup
👉 Consumer app hech narsa bilishi shart emas
📡 API (Minimal) createSSOAuth(config) logout()
🏗 Tavsiya etiladigan arxitektura src/ ├─ main.ts ← SSO shu yerda ulanadi ├─ router/ ├─ layouts/ │ └─ TopNavbar.vue (logout) └─ pages/
🧪 Qo‘shimcha sozlama talab qilinmaydi
📄 Litsenziya
MIT © BRB-TECH
✔ Production-ready ✔ Enterprise SSO ✔ Multi-project compatible
