The Mozilla Developer Network describes the Referrer-Policy header like this:
The HTTP Referrer-Policy response header controls how much referrer information (sent with the Referer header) should be included with requests.
source: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Referrer-Policy
A Referrer-Policy header can be added in one of two ways, either using the default middleware options:
app.UseSecureHeadersMiddleware();
The above adds the Referrer-Policy header with a no-referrer
value.
Or by creating an instance of the SecureHeadersMiddlewareBuilder
class using the following code:
var customConfig = SecureHeadersMiddlewareBuilder
.CreateBuilder()
.UseReferrerPolicy()
.Build();
app.UseSecureHeadersMiddleware(customConfig);
The above adds the Referrer-Policy header with a no-referrer
value.
Full Options
The Referrer-Policy header object (known internally as ReferrerPolicy
) has the following options:
- enum:
ReferrerPolicyOptions
The values available for the ReferrerPolicyOptions
enum are:
noReferrer
noReferrerWhenDowngrade
origin
originWhenCrossOrigin
sameOrigin
strictOrigin
strictWhenCrossOrigin
unsafeUrl
These values can be set when creating a new instance of the ReferrerPolicyOptions
object, or by calling the UseReferrerPolicy
extension method on the SecureHeadersMiddlewareConfiguration
class.