Namespace Cuemon.AspNetCore.Http.Headers
Add HTTP caching headers, correlation identifiers, API key protection, and conditional request handling using middleware components for ASP.NET Core. Use this namespace when you need cache validation, request correlation, API key sentinel protection, or ETag/last-modified header support. Start with CacheableMiddleware and CacheableOptions for HTTP caching scenarios, or CorrelationIdentifierMiddleware for correlating requests across services. For API key protection, use ApiKeySentinelMiddleware.
Availability: .NET 10 and .NET 9
Complements: Microsoft.AspNetCore.Http.Headers namespace 🔗
Extension Members
| Type | Ext | Methods |
|---|---|---|
| IDecorator |
⬇️ | ToEntityTagHeaderValue |
Classes
ApiKeyException
The exception that is thrown when the requirements of an API key header is not meet.
ApiKeySentinelMiddleware
Provides an API key sentinel middleware implementation for ASP.NET Core.
ApiKeySentinelOptions
Configuration options for ApiKeySentinelMiddleware and related.
CacheableMiddleware
Provides a Cache-Control middleware implementation for ASP.NET Core.
CacheableOptions
Configuration options for CacheableMiddleware.
ChecksumBuilderDecoratorExtensions
Extension methods for the ChecksumBuilder class hidden behind the IDecorator<T> interface.
CorrelationIdentifierMiddleware
Provides a Correlation ID middleware implementation for ASP.NET Core.
CorrelationIdentifierOptions
Configuration options for CorrelationIdentifierMiddleware.
ExpiresHeaderValue
Represents a HTTP Expires header that contains the date/time after which the response is considered stale.
RequestIdentifierMiddleware
Provides a Request ID middleware implementation for ASP.NET Core.
RequestIdentifierOptions
Configuration options for RequestIdentifierMiddleware.
UserAgentException
The exception that is thrown when the requirements of an HTTP User-Agent header is not meet.
UserAgentSentinelMiddleware
Provides a HTTP User-Agent sentinel middleware implementation for ASP.NET Core.
UserAgentSentinelOptions
Configuration options for UserAgentSentinelMiddleware and related.
VaryAcceptMiddleware
Middleware that appends Vary: Accept to every response, signalling to HTTP
caches (and clients) that the representation varies based on the Accept
request header (RFC 9110 §12.5.5).
Interfaces
ICacheableValidator
An HTTP validator tailored for cacheable flows, that asynchronously surrounds execution of the intercepted response body.
Enums
RetryConditionScope
Specifies a set of values defining what value to use with a given HTTP header in regards to a retry condition. Recommended value is always DeltaSeconds as it does not rely on clock synchronization and is resilient to clock skew between client and server.