Franz.Common.Http
3.0.0
dotnet add package Franz.Common.Http --version 3.0.0
NuGet\Install-Package Franz.Common.Http -Version 3.0.0
<PackageReference Include="Franz.Common.Http" Version="3.0.0" />
<PackageVersion Include="Franz.Common.Http" Version="3.0.0" />
<PackageReference Include="Franz.Common.Http" />
paket add Franz.Common.Http --version 3.0.0
#r "nuget: Franz.Common.Http, 3.0.0"
#:package Franz.Common.Http@3.0.0
#addin nuget:?package=Franz.Common.Http&version=3.0.0
#tool nuget:?package=Franz.Common.Http&version=3.0.0
Franz.Common.Http
ASP.NET Core HTTP primitives for controller registration, CORS, error strategies, serialization, routing, and forwarded headers.
Overview
This package contains the lower-level HTTP service-registration and middleware extensions used by the Franz HTTP bootstrap package. Error handling is registered through the fluent AddErrors() capability and the bootstrap package's global exception handler.
Installation
dotnet add package Franz.Common.Http
Registering HTTP services
AddFranzHttp() registers MVC controllers and returns a fluent FranzHttpBuilder. Additional capabilities are composed through that builder:
using Franz.Common.Http.Extensions;
builder.Services
.AddFranzHttp()
.AddErrors()
.AddSerialization()
.AddFrenchRouting()
.AddDefaultCors(builder.Configuration)
.AddForwardedHeaders();
The available builder operations are:
AddErrors(): registers the error response provider, built-in response strategies, and MVC exception filter.AddSerialization(): configures the framework's JSON defaults and converters.AddFrenchRouting(): installs the French controller-parameter transformer convention.AddDefaultCors(configuration): configures exact allowed origins from theCorssetting.AddForwardedHeaders()orAddForwardedHeaders(configure): configures forwarded-header processing while preserving trusted-proxy restrictions.
Error response strategies
AddErrors() registers IErrorResponseProvider, IErrorResponseStrategy implementations, and ExceptionFilter. Applications can add or replace strategy registrations through dependency injection. Technical errors must use sanitized responses in production; do not expose raw exception details to clients.
The higher-level Franz.Common.Http.Bootstrap package registers the global FranzGlobalExceptionHandler and ProblemDetails support as part of AddHttpArchitecture(...).
Middleware helpers
The package exposes UseFrenchLocalization() and UseDefaultCors() as application-builder extensions. The standard composed middleware pipeline is owned by Franz.Common.Http.Bootstrap through UseHttpArchitecture().
CORS and forwarded headers
The Cors configuration value is a semicolon-separated list of exact HTTP/HTTPS origins. Wildcards and origin paths are rejected. An empty list does not grant cross-origin access.
Forwarded headers are not trusted from arbitrary clients. Configure the deployment's known proxy addresses or networks using ASP.NET Core's ForwardedHeadersOptions.
License
MIT. See the repository LICENSE.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Franz.Common (>= 3.0.0)
- Franz.Common.DependencyInjection (>= 3.0.0)
- Franz.Common.Errors (>= 3.0.0)
- Franz.Common.Serialization (>= 3.0.0)
- Microsoft.AspNetCore.Mvc.NewtonsoftJson (>= 10.0.14)
NuGet packages (3)
Showing the top 3 NuGet packages that depend on Franz.Common.Http:
| Package | Downloads |
|---|---|
|
Franz.Common.Http.MultiTenancy
Shared utility library for the Franz Framework. |
|
|
Franz.Common.Http.Identity
Shared utility library for the Franz Framework. |
|
|
Franz.Common.Http.Bootstrap
Shared utility library for the Franz Framework. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 3.0.0 | 144 | 11/10/2026 |
| 2.3.4 | 403 | 11/1/2026 |
| 2.3.3 | 372 | 10/28/2026 |
| 2.3.2 | 168 | 10/27/2026 |
| 2.3.1 | 229 | 10/26/2026 |
| 2.3.0 | 301 | 7/21/2026 |
| 2.2.19 | 202 | 7/19/2026 |
| 2.2.18 | 204 | 7/19/2026 |
| 2.2.17 | 859 | 7/12/2026 |
| 2.2.16 | 214 | 7/2/2026 |
| 2.2.15 | 206 | 6/29/2026 |
| 2.2.14 | 210 | 6/29/2026 |
| 2.2.13 | 212 | 6/29/2026 |
| 2.2.12 | 202 | 6/28/2026 |
| 2.2.11 | 211 | 6/28/2026 |
| 2.2.10 | 210 | 6/28/2026 |
| 2.2.9 | 205 | 6/28/2026 |
| 2.2.8 | 201 | 6/28/2026 |
| 2.2.7 | 202 | 6/7/2026 |
| 2.2.6 | 217 | 6/6/2026 |