TideCloak JavaScript SDK Documentation
Welcome to the TideCloak SDK documentation for Vanilla JavaScript. This guide helps you integrate authentication, session management, role checks, and tag-based encryption into any web app - no framework required.
TideCloak builds on Keycloak and adds developer-friendly primitives: a lightweight JS service (IAMService), silent SSO, auto token refresh, and end-to-end encryption (E2EE) using tags - backed by Tide's Cybersecurity Fabric.
🔐 Key Features
- Straightforward init with
IAMService.initIAM(config) - Login/logout + silent SSO
- Automatic & manual token refresh
- Tag-based E2EE:
doEncrypt()/doDecrypt() - Token & claims helpers + role checks
- Works with any bundler or plain
<script type="module">
📘 Tutorials
Start here to scaffold a Vite project and wire up a working login flow in minutes.
🛠 How-to Guides
Copy-paste recipes: install, init, set redirect URIs, read token claims, check roles, refresh tokens, and encrypt/decrypt data. Includes a ready-to-use /auth/redirect.html.
💬 Discussions
Conceptual deep-dives + flow diagrams: normal login, silent SSO, protected API calls, token refresh, and browser-side E2EE (no server-held keys). Common pitfalls and best practices included.
📚 Reference
Complete API reference for @tidecloak/js: IAMService events & methods, token helpers, and E2EE utilities.
Using React or Next.js instead? See React-SDK and Next.js-SDK