HeaderPropagation 1.0.1

There is a newer version of this package available.
See the version list below for details.
dotnet add package HeaderPropagation --version 1.0.1
NuGet\Install-Package HeaderPropagation -Version 1.0.1
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="HeaderPropagation" Version="1.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add HeaderPropagation --version 1.0.1
#r "nuget: HeaderPropagation, 1.0.1"
#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.
// Install HeaderPropagation as a Cake Addin
#addin nuget:?package=HeaderPropagation&version=1.0.1

// Install HeaderPropagation as a Cake Tool
#tool nuget:?package=HeaderPropagation&version=1.0.1

This is a backport to ASP.NET Core 2.1 (and 2.2) of the HeaderPropagation middleware I had recently contributed to the ASP.NET Core project. All code is licensed under the Apache License, Version 2.0 and copyrighted by the .NET Foundation.

Motivation

I believe it is a common use case which deserves to be included in ASP.NET Core. Its main use case is probably to track distributed transaction which requires the ability to pass through a transaction identifier as well as generating a new one when not present.

Given the ASP.NET Core 3.0 release is quite far away, and the current policy doesn't allow to backport new features to already shipped releases, I have created this package as recommended so it can be used today on projects based on ASP.NET Core 2.1 or 2.2.

Usage

In Startup.Configure enable the middleware:

app.UseHeaderPropagation();

In Startup.ConfigureServices add the required services, eventually specifying a configuration action:

services.AddHeaderPropagation(o => o.Headers.Add("User-Agent", new HeaderPropagationEntry
{
    DefaultValue = "Mozilla/5.0 (trust me, I'm really Mozilla!)",
}));

If you are using the HttpClientFactory, add the DelegatingHandler to the client configuration using the AddHeaderPropagation extension method.

services.AddHttpClient<GitHubClient>(c =>
{
    c.BaseAddress = new Uri("https://api.github.com/");
    c.DefaultRequestHeaders.Add("Accept", "application/vnd.github.v3+json");
}).AddHeaderPropagation();

See samples/WebApplication.

Behaviour

HeaderPropagationOptions contains a dictionary where the key represent the name of the header to consume from the incoming request.

Each entry define the behaviour to propagate that header as follows:

  • OutboundHeaderName determines the name of the header to be used for the outbound http requests.

  • When present, the ValueFactory is the only method used to set the value. The factory should return StringValues.Empty to not add the header.

  • When not present, the value will be taken from the header in the incoming request named as the key of this entry in HeaderPropagationOptions.Headers or, if missing or empty, it will be the values specified in DefaultValue or, if the DefaultValue is empty, the header will not be added to the outbound calls.

Please note the factory is called only once per incoming request and the same value will be used by all the outbound calls.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on HeaderPropagation:

Package Downloads
ASK.HAL.Mvc

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
3.0.2 426,619 10/27/2019
3.0.1 31,734 5/30/2019
3.0.0 594 5/18/2019
2.0.0 74,000 5/8/2019
1.0.2 633 4/20/2019
1.0.1 5,546 4/7/2019
1.0.0 762 4/7/2019