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
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Franz.Common.Http" Version="3.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Franz.Common.Http" Version="3.0.0" />
                    
Directory.Packages.props
<PackageReference Include="Franz.Common.Http" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Franz.Common.Http --version 3.0.0
                    
#r "nuget: Franz.Common.Http, 3.0.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Franz.Common.Http@3.0.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Franz.Common.Http&version=3.0.0
                    
Install as a Cake Addin
#tool nuget:?package=Franz.Common.Http&version=3.0.0
                    
Install as a Cake Tool

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 the Cors setting.
  • AddForwardedHeaders() or AddForwardedHeaders(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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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
Loading failed