TideCloak Csharp SDK Documentation

Welcome to the TideCloak SDK documentation for C# / ASP.NET. This guide helps you integrate authentication, session management, and role‑based access into ASP.NET Core apps, IIS‑hosted deployments, and classic WebForms (via a Core sub‑app).

TideCloak builds on Keycloak and adds developer‑friendly primitives for modern .NET apps: OpenID Connect flows, saved tokens, claims mapping, and simple login/logout endpoints-secured by Tide's Cybersecurity Fabric.

---

🔐 Key Features

• Standards‑based OpenID Connect sign‑in/sign‑out
• Cookie auth with SaveTokens for access/ID tokens
• Claims mapping (preferred_username, email, sub)
• Role/claim checks for UI gating and authorization
• Works with ASP.NET Core, IIS, and WebForms + Core sub‑app
• Local/dev friendly (RequireHttpsMetadata = false) with clear prod guidance

---

📘 Tutorials

Start here to scaffold a project and wire up a working login flow in minutes.

• 5 min Tutorial: Build a TideCloak + ASP.NET Core (Razor Pages)
• Tutorial: Host your ASP.NET Core app on IIS
• Tutorial: WebForms + ASP.NET Core sub‑application

---

🛠 How‑to Guides

Copy‑paste recipes: install NuGet packages, configure AddAuthentication(), set redirect URIs, map claims, display user info, and production hardening tips.

• How‑to Guide: Common Tasks with TideCloak in ASP.NET

---

💬 Discussions

Conceptual deep‑dives and flow diagrams: OIDC code flow, cookie vs. bearer usage, claims/roles best practices, IIS hosting considerations, and WebForms bridging via a Core sub‑app.

• Discussion: Understanding TideCloak Auth in .NET

---

📚 Reference

Complete API and configuration reference for the snippets used across the tutorials (auth options, claims, endpoints, and hosting notes).

• Reference: TideCloak C# / ASP.NET SDK

---

Building with React/Next.js or plain JS? See React SDK · Next.js SDK · JavaScript SDK