The Cookbook

# Auth

• Asymmetric JWT token usage
• Standard JWT Auth with Swagger support
• Dynamically updating JWT signing key during runtime
• API Key Auth with Swagger support
• Session based Auth with Swagger support
• Basic Auth with Swagger support
• Dynamic claim/permission hydration (using IClaimsTransformation) instead of embedding in JWT
• Custom Authorization Handler (IAuthorizationHandler) Example
• MS Identity API Endpoints middleware config
• Sending a custom 401 response on Authentication failure

# Configuration

• Endpoint grouping
• Registration of additional assemblies for auto type discovery

# Job Persistence

• Storing IJobStorageRecord, IEventStorageRecord with EF Core
• Job storage provider with Dapper

# Middleware & Pipeline

• IEndpointFilter usage
• Intercept responses with an IResponseInterceptor
• Intercept responses with the global response modifier
• Correct middleware order for Blazor Server-Side
• Correct middleware order for UseSpa() from Microsoft.AspNetCore.SpaServices.Extensions
• Legacy host-builder style with Startup.cs file

# Miscellaneous

• OData endpoints

# Results Pattern

• Usage with Ardalis.Result package
• Results pattern with Post-Processor doing the response sending
• Results pattern with ErrorOr package

# Serialization

• Receiving and sending of XML via custom binder and send method
• Content negotiation example which supports XML and JSON responses
• JsonPatch usage with Swagger UI support
• Streaming JSON response with IAsyncEnumerable

# Swagger

• Customizing Swagger Spec With An IOperationProcessor
• Customizing Swagger Middleware & SwaggerUi Paths
• Api Visualization with Scalar
• OneOf support for polymorphic schema

# Testing

• Using a mock/test authentication handler for integration tests
• Integration testing with TestContainers & AppFixture
• Integration testing an endpoont that executes a command
• Integration testing an endpoint that publishes an event
• Unit testing an endpoint that executes a command
• Unit testing an endpoint that publishes an event
• Forwarding console log messages to xUnit's Message Sink

# Validation

• Adding & Throwing validation errors from deeper domain layers
• Request DTO inheritance and composition of Validators
• Validator inheritance for polymorphic DTOs.

# Versioning

• Versioning with Asp.Versioning.Http
• Showing deprecated versions in Swagger with built-in versioning