Guides
Deeper, cross-cutting subjects (logging, deployment, performance, etc.).
Available
| Guide | Description |
|---|---|
| Logging | Configure structured logging (C# & PowerShell) |
| Exception Handling | Middleware patterns and standardized error responses |
| HTTP Caching | Layered cache headers, middleware, validators |
| Health Monitoring | Health endpoints, probes, and operational guidance |
| HSTS & HTTPS Redirection | Secure transport policies and automatic redirection |
| Forwarded Headers | Honor X-Forwarded-* from proxies for correct scheme/host/IP |
| CORS | Cross-origin policies and browser preflight behavior |
| Authentication | JWT, OAuth 2.0, OpenID Connect (OIDC), and client certificates (mTLS) |
| OpenAPI Generation | Generate and document APIs with OpenAPI 3.0+ specifications |
| Dotnet Tool | Install, update, and use the kestrun CLI via Kestrun.Tool |
| Production Deployment (Service/Daemon) | Deploy custom Kestrun apps to VM/bare-metal service hosts |
| Real-time (SSE & SignalR) | Stream events via SSE or build interactive apps with SignalR |
| Scheduling | Background jobs via intervals and CRON (PS & C#) |
| Sessions | Cookie-based per-client state across requests |
| Tasks | On-demand background work with progress and results |
| Razor Pages | PowerShell-backed Razor Pages with per-request models |
| Status Code Pages | Friendly error pages and re-execution flows |
| Certificates | Generate, import, export, and validate X.509 |
| File & Form Uploads | Multipart parsing, streaming storage, and validation rules/limits |
| Imperative vs Declarative Routing | Compare Add-KrMapRoute with [OpenApiPath] attribute routing |
Planned
- Performance & benchmarking
- Configuration & environment separation
- Security / hardening checklist
Looking for step-by-step learning? Visit the Tutorials.
Table of contents
- Antiforgery (CSRF) Protection
- HTTP Caching
- Certificates Management
- Dotnet Tool
- Production Deployment (Service/Daemon)
- Response Compression
- CORS
- ExceptionHandling
- Localization
- Forwarded Headers
- Health Monitoring
- HSTS and HTTPS Redirection
- Authentication
- Kestrun Logging
- OpenAPI Generation
- Real-time (SSE & SignalR)
- Routing & Conventions
- Imperative vs Declarative Routing
- Razor Pages
- Scheduling
- Client Sessions
- File & Form Uploads
- Shared State & Runspaces
- Status Code Pages Middleware
- Ad-hoc Tasks