Voeg WebsiteMode.PrerenderedPages toe: nginx-gelijke serving van een voorgerenderde website

- Pure WebsitePathResolver (canonieke 301's, echte 404, dotfiles geweigerd, gereserveerde prefixes)
- PrerenderedSiteMiddleware, 404-fallback na de API-routes, gzip, Cache-Control, NoIndex/robots.txt
- Beleid StrictSite met eigen AllowedSite*Origins; volledige headerset op alle websiteresponses
- Tests: voorbeelden, FsCheck-properties en integratietests op een in-memory server

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-06 15:52:04 +01:00
co-authored by Claude Sonnet 5.5
parent d9cc539481
commit 7d21d9024a
25 changed files with 1859 additions and 23 deletions
@@ -0,0 +1,138 @@
using FluentAssertions;
using FsCheck;
using FsCheck.Fluent;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Options;
using SlpModularCms.Core.Hosting.Security;
using Xunit;
namespace SlpModularCms.Core.Tests.Hosting.Security;
/// <summary>Guards the StrictSite policy: byte-for-byte the CSP the prerendered site sends today.</summary>
public class StrictSitePolicyTests
{
private const string Umami = "https://analytics.slpsoftware.nl";
private const string Sentry = "https://o4511795618185216.ingest.de.sentry.io";
/// <summary>The exact nginx value of the website (security headers, test and production).</summary>
private const string ExpectedSiteCsp =
"default-src 'self'; script-src 'self' https://analytics.slpsoftware.nl; " +
"style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self'; " +
"connect-src 'self' https://analytics.slpsoftware.nl https://o4511795618185216.ingest.de.sentry.io; " +
"object-src 'none'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'";
[Fact]
public void StrictSite_WithTheSiteOrigins_MatchesTheNginxHeaderByteForByte()
{
var set = CspPolicyCatalog.Build(CspPolicyCatalog.StrictSite, [], [], [Umami], [Umami, Sentry]);
set.ContentSecurityPolicy.Should().Be(ExpectedSiteCsp);
set.FrameOptions.Should().Be("DENY");
set.ReferrerPolicy.Should().Be("strict-origin-when-cross-origin");
}
[Fact]
public void StrictSite_WithoutOrigins_AllowsOnlySelf()
{
var set = CspPolicyCatalog.Build(CspPolicyCatalog.StrictSite, [], []);
set.ContentSecurityPolicy.Should().Contain("script-src 'self';").And.Contain("connect-src 'self';");
set.ContentSecurityPolicy.Should().NotContain("script-src 'self' 'unsafe-inline'").And.NotContain("'unsafe-eval'");
}
[Fact]
public void SiteOrigins_AreUsedByStrictSiteOnly()
{
var strict = CspPolicyCatalog.Build(CspPolicyCatalog.Strict, [], [], [Umami], [Sentry]);
var relaxed = CspPolicyCatalog.Build(CspPolicyCatalog.Relaxed, [], [], [Umami], [Sentry]);
strict.ContentSecurityPolicy.Should().NotContain(Umami).And.NotContain(Sentry);
relaxed.ContentSecurityPolicy.Should().NotContain(Umami).And.NotContain(Sentry);
}
[Fact]
public void AdminOrigins_AreNotUsedByStrictSite()
{
var set = CspPolicyCatalog.Build(CspPolicyCatalog.StrictSite, [Umami], [Sentry]);
set.ContentSecurityPolicy.Should().NotContain(Umami).And.NotContain(Sentry);
}
[Fact]
public void StrictAndRelaxed_AreUnchangedByTheNewParameters()
{
foreach (var policy in new[] { CspPolicyCatalog.Strict, CspPolicyCatalog.Relaxed })
{
var before = CspPolicyCatalog.Build(policy, [Umami], [Sentry]);
var after = CspPolicyCatalog.Build(policy, [Umami], [Sentry], [Umami], [Sentry]);
after.Should().Be(before);
}
}
[Fact]
public void StrictSite_IsAKnownPolicy_AndUnknownNamesStillFail()
{
CspPolicyCatalog.IsKnownPolicy("StrictSite").Should().BeTrue();
CspPolicyCatalog.IsKnownPolicy("strictsite").Should().BeTrue();
CspPolicyCatalog.IsKnownPolicy("StrictSyte").Should().BeFalse();
}
[Fact]
public void Configuration_CanSelectStrictSite_AndBindsTheSiteOrigins()
{
var provider = BuildProvider(new Dictionary<string, string?>
{
["SecurityHeaders:DefaultPolicy"] = "StrictSite",
["SecurityHeaders:AllowedSiteScriptOrigins:0"] = Umami,
["SecurityHeaders:AllowedSiteConnectOrigins:0"] = Umami,
["SecurityHeaders:AllowedSiteConnectOrigins:1"] = Sentry
});
provider.GetRequiredService<IOptions<SecurityHeadersOptions>>().Value.DefaultPolicy.Should().Be("StrictSite");
provider.GetRequiredService<ICspPolicyProvider>().Get("StrictSite").ContentSecurityPolicy
.Should().Be(ExpectedSiteCsp);
}
[Theory]
[InlineData("AllowedSiteScriptOrigins", "analytics.example.com")]
[InlineData("AllowedSiteConnectOrigins", "https://example.com/path")]
[InlineData("AllowedSiteConnectOrigins", "htp://example.com")]
public void SiteOriginLists_AreValidatedLikeTheExistingOnes(string key, string origin)
{
var provider = BuildProvider(new Dictionary<string, string?> { [$"SecurityHeaders:{key}:0"] = origin });
var act = () => provider.GetRequiredService<IOptions<SecurityHeadersOptions>>().Value;
act.Should().Throw<OptionsValidationException>().WithMessage("*origins must be absolute scheme-and-host*");
}
/// <summary>PBT-02: every configured origin appears in the right directive and nowhere else.</summary>
[Fact]
public void Property_ConfiguredSiteOrigins_AppearInTheirDirectiveOnly()
{
var hosts = Gen.Elements("a", "b", "cdn", "stats", "x1").Select(h => $"https://{h}.example.com");
var lists = Gen.ListOf(hosts).Select(l => l.Distinct().ToArray());
Prop.ForAll(lists.ToArbitrary(), lists.ToArbitrary(), (script, connect) =>
{
var csp = CspPolicyCatalog.Build(CspPolicyCatalog.StrictSite, [], [], script, connect).ContentSecurityPolicy;
var directives = csp.Split("; ").ToDictionary(d => d.Split(' ')[0], d => d.Split(' ').Skip(1).ToArray());
return directives["script-src"].Skip(1).OrderBy(x => x).SequenceEqual(script.OrderBy(x => x))
&& directives["connect-src"].Skip(1).OrderBy(x => x).SequenceEqual(connect.OrderBy(x => x))
&& directives["default-src"].SequenceEqual(["'self'"]);
})
.Check(Config.QuickThrowOnFailure.WithMaxTest(300));
}
private static ServiceProvider BuildProvider(Dictionary<string, string?> values)
{
var configuration = new ConfigurationBuilder().AddInMemoryCollection(values).Build();
var services = new ServiceCollection();
services.AddLogging();
services.AddCmsSecurityHeaders(configuration);
return services.BuildServiceProvider();
}
}