Docs: productie is IIS in-process zonder proxy; ForwardedHeaders uit, HTTPS/www/client-IP gecontroleerd, canoniek adres zonder www

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-19 00:17:16 +01:00
co-authored by Claude Sonnet 5.5
parent 3c358fa94d
commit 1e908b3af0
@@ -35,7 +35,7 @@ Legenda: **V** = verplicht (de host start niet of werkt niet zonder), **A** = aa
|---|---|---|---| |---|---|---|---|
| `Website:Mode` | V (staat al goed) | nee | `PrerenderedPages` staat in de committed `appsettings.json`; niet overschrijven. | | `Website:Mode` | V (staat al goed) | nee | `PrerenderedPages` staat in de committed `appsettings.json`; niet overschrijven. |
| `Website:NoIndex` | V | nee | **`false`** op productie (committed standaard is `true` = geen zoekmachines). Pas zetten op het release-moment, na Bryans go. | | `Website:NoIndex` | V | nee | **`false`** op productie (committed standaard is `true` = geen zoekmachines). Pas zetten op het release-moment, na Bryans go. |
| `Website:PublicBaseUrl` | A | nee | Leeg op productie is toegestaan (de site wordt geserveerd met het adres waarmee hij is gebouwd). Wil je het expliciet: `https://www.andreaslop.nl` (zonder slash). Moet gelijk zijn aan `Website:AuthoredBaseUrl` of die vervangt het. | | `Website:PublicBaseUrl` | A | nee | Leeg op productie is toegestaan (de site wordt geserveerd met het adres waarmee hij is gebouwd). Wil je het expliciet: `https://andreaslop.nl` (zonder slash). Moet gelijk zijn aan `Website:AuthoredBaseUrl` of die vervangt het. |
| `Website:AuthoredBaseUrl` | O | nee | Het adres dat de websitebuild in pagina's, sitemap en robots schrijft; staat in de committed instellingen. | | `Website:AuthoredBaseUrl` | O | nee | Het adres dat de websitebuild in pagina's, sitemap en robots schrijft; staat in de committed instellingen. |
| `Website:LogLevel` | O | nee | Standaard `Warning` (productie). `Information` toont ook 301's en 404's: alleen tijdelijk. | | `Website:LogLevel` | O | nee | Standaard `Warning` (productie). `Information` toont ook 301's en 404's: alleen tijdelijk. |
| `Texts:DefaultLanguage` | O | nee | `nl` (standaard). | | `Texts:DefaultLanguage` | O | nee | `nl` (standaard). |
@@ -52,7 +52,7 @@ Mail staat uit zolang `Email:Smtp:Host` leeg is; dan kopieert de beheerder de li
| `Email:Smtp:Password` | A | **ja** | alleen in `appsettings.Production.json` | | `Email:Smtp:Password` | A | **ja** | alleen in `appsettings.Production.json` |
| `Email:FromAddress` / `Email:FromName` | A | nee | `no-reply@andreaslop.nl` / `Andrea Slop Fotografie` (SPF/DKIM moeten voor dit adres kloppen). | | `Email:FromAddress` / `Email:FromName` | A | nee | `no-reply@andreaslop.nl` / `Andrea Slop Fotografie` (SPF/DKIM moeten voor dit adres kloppen). |
| `Email:AllowedFromAddresses[0]` | O | nee | Extra afzenderadressen die de eigenaar in de admin mag kiezen. | | `Email:AllowedFromAddresses[0]` | O | nee | Extra afzenderadressen die de eigenaar in de admin mag kiezen. |
| `App:PublicBaseUrl` | V als mail aan staat | nee | `https://www.andreaslop.nl` (https, zonder pad). Gebruikt in de links van de mails. | | `App:PublicBaseUrl` | V als mail aan staat | nee | `https://andreaslop.nl` (https, zonder pad). Gebruikt in de links van de mails. |
| `App:DefaultLanguage` | O | nee | `nl` | | `App:DefaultLanguage` | O | nee | `nl` |
### 1d. Eerste beheerder en toegang ### 1d. Eerste beheerder en toegang
@@ -62,7 +62,7 @@ Mail staat uit zolang `Email:Smtp:Host` leeg is; dan kopieert de beheerder de li
| `Identity:Setup:Token` | A | **ja** | Minstens 32 willekeurige tekens. Beschermt het aanmaken van de eerste beheerder op een lege database; weghalen zodra die bestaat. Leeg = de setuppagina is niet beveiligd (op internet is dat een risico tot de eerste beheerder er is). | | `Identity:Setup:Token` | A | **ja** | Minstens 32 willekeurige tekens. Beschermt het aanmaken van de eerste beheerder op een lege database; weghalen zodra die bestaat. Leeg = de setuppagina is niet beveiligd (op internet is dat een risico tot de eerste beheerder er is). |
| `Identity:Invitation:ExpiryHours` | O | nee | `24` (standaard). | | `Identity:Invitation:ExpiryHours` | O | nee | `24` (standaard). |
| `RateLimiting:Login:PermitLimit` / `...WindowSeconds` | O | nee | `5` per `60` s per clientadres (standaard). | | `RateLimiting:Login:PermitLimit` / `...WindowSeconds` | O | nee | `5` per `60` s per clientadres (standaard). |
| `ForwardedHeaders:KnownProxies[0]` | O | nee | Alleen als er een reverse proxy/CDN van de hoster voor IIS staat en het echte bezoekersadres nodig is (rate limiting werkt per adres). Vraag de hoster; leeg = `X-Forwarded-*` wordt genegeerd. Een wildcard (`0.0.0.0`, `::`) laat de host niet starten. | | `ForwardedHeaders:KnownProxies[0]` | **niet zetten** | nee | Op productie **staat ForwardedHeaders uit**: de host draait in-process op IIS, zonder reverse proxy of CDN ervoor (Bryan, 2026-11-19). IIS levert schema (https) en client-IP zelf; `X-Forwarded-*` van buiten wordt genegeerd (geen spoofing). Zie 2a. Een wildcard (`0.0.0.0`, `::`) laat de host niet starten. |
### 1e. Foto's (Hero en Media) ### 1e. Foto's (Hero en Media)
@@ -123,7 +123,7 @@ Controle na de eerste start: het log toont `Image library Magick.NET self-test p
<!-- inprocess: de app draait in de IIS-werkproces (sneller, een proces). Vereist de ASP.NET Core Module <!-- inprocess: de app draait in de IIS-werkproces (sneller, een proces). Vereist de ASP.NET Core Module
(Hosting Bundle); aanwezig volgens de hoster. Valt het toch tegen: hostingModel="outofprocess" (Hosting Bundle); aanwezig volgens de hoster. Valt het toch tegen: hostingModel="outofprocess"
(Kestrel achter IIS; dan telt ForwardedHeaders:KnownProxies[0] = 127.0.0.1). --> (Kestrel achter IIS; dan zou ForwardedHeaders:KnownProxies[0] = 127.0.0.1 nodig zijn; niet de bedoeling). -->
<aspNetCore processPath=".\SlpModularCms.Api.AndreaSlopFotografie.exe" <aspNetCore processPath=".\SlpModularCms.Api.AndreaSlopFotografie.exe"
arguments="" arguments=""
hostingModel="inprocess" hostingModel="inprocess"
@@ -162,6 +162,40 @@ Opmerkingen:
- `processPath` hoort bij de self-contained build (`.exe` naast de web.config). Bij framework-dependent staat daar `dotnet` en `arguments=".\SlpModularCms.Api.AndreaSlopFotografie.dll"`. - `processPath` hoort bij de self-contained build (`.exe` naast de web.config). Bij framework-dependent staat daar `dotnet` en `arguments=".\SlpModularCms.Api.AndreaSlopFotografie.dll"`.
- Deploy: een `app_offline.htm` in de siteroot zet de app tijdens het uploaden stil (geen vergrendelde bestanden); verwijderen na afloop. - Deploy: een `app_offline.htm` in de siteroot zet de app tijdens het uploaden stil (geen vergrendelde bestanden); verwijderen na afloop.
## 2a. HTTPS, www en client-IP op IIS zonder proxy
Productie is IIS in-process, zonder reverse proxy of CDN ervoor. Daarom staat ForwardedHeaders **uit** (`ForwardedHeaders:KnownProxies` niet zetten). Gecontroleerd in de code (2026-11-19):
| Onderwerp | Zonder ForwardedHeaders | Toelichting |
|---|---|---|
| Schema (https) | Correct | In-process IIS geeft de echte verbinding door: `Request.IsHttps` is waar op het https-adres. Daarvan hangen af: de `Secure`-vlag op de refresh-cookie (`AuthController`), de mails en de absolute adressen. |
| Client-IP en rate limiting | Correct | `ClientPartitionKey` gebruikt `Connection.RemoteIpAddress`: het echte bezoekersadres van IIS. De middleware voor `X-Forwarded-For` wordt niet eens toegevoegd, dus een bezoeker kan zich met die header niet voordoen als een ander adres (geen spoofing, en geen gedeelde bucket zoals achter een proxy). |
| HSTS | Correct | `Strict-Transport-Security: max-age=31536000; includeSubDomains` gaat mee op elk antwoord buiten Development; browsers nemen hem alleen over via https. Zet HSTS pas breed aan als de redirect (hieronder) werkt. |
| Absolute adressen | Via configuratie | Website: `Website:PublicBaseUrl` (of leeg: het adres waarmee de site is gebouwd, `https://andreaslop.nl`); mails: `App:PublicBaseUrl`. Beide **zonder** `www`: het canonieke adres is `https://andreaslop.nl`. |
| HTTP naar HTTPS | **Doet de app niet** | `UseHttpsRedirection` heeft onder in-process IIS geen https-poort (er is geen Kestrel-adres) en doet dan niets (alleen een waarschuwing in het log). Dit moet IIS of de hoster doen. |
| www naar apex | **Doet de app niet** | Idem: IIS of de hoster. |
| Contact-formulier | N.v.t. | De releasevoorwaarde "KnownProxies = IP van de proxy" in `appsettings.json` geldt niet: er is geen proxy; elk bezoeker heeft eigen rate-limit-emmer. |
**Wat de hoster al doet is nog niet bevestigd** (open punt voor Bryan, zie 5): doet het hostingpaneel al "HTTP naar HTTPS" en "www naar apex"? Zo ja, niets toevoegen. Zo niet, en als de **URL Rewrite-module** op de server staat, voeg dan dit toe aan de `web.config` (binnen `<system.webServer>`, vóór `<handlers>` mag ook erna). Zonder die module geeft een `<rewrite>`-blok een HTTP 500.19 voor de hele site; daarom staat het **niet** in het standaardsjabloon.
```xml
<rewrite>
<rules>
<!-- www naar apex en http naar https in een keer (een enkele 301) -->
<rule name="Canonical host and https" stopProcessing="true">
<match url="(.*)" />
<conditions logicalGrouping="MatchAny">
<add input="{HTTPS}" pattern="off" />
<add input="{HTTP_HOST}" pattern="^www\.andreaslop\.nl$" />
</conditions>
<action type="Redirect" url="https://andreaslop.nl/{R:1}" redirectType="Permanent" />
</rule>
</rules>
</rewrite>
```
Een gebruiker die de oude WordPress-adressen via de redirectmap (`redirects.json`) afhandelt, krijgt de redirect pas ná deze regel: eerst naar het canonieke adres, dan naar de nieuwe plek. Test na het toevoegen: `http://andreaslop.nl/`, `https://www.andreaslop.nl/` en `http://www.andreaslop.nl/` geven elk één 301 naar `https://andreaslop.nl/`; `/health` blijft 200 (de health-check van de deploy gebruikt `https://andreaslop.nl/health`).
## 3. De productie-appsettings (`appsettings.Production.json`) ## 3. De productie-appsettings (`appsettings.Production.json`)
Eén bestand, **server-only**, naast het programma (naast de exe en de `appsettings.json` uit de release); rechten alleen voor de identiteit van de application pool en de beheerder. Het zit niet in het artefact, dus de FTPS-deploy overschrijft het niet; het staat niet in de repo en niet in `wwwroot` (wordt nooit geserveerd). Bryan mag het bestand zelf op de server zetten (bevestigd door de hoster). Eén bestand, **server-only**, naast het programma (naast de exe en de `appsettings.json` uit de release); rechten alleen voor de identiteit van de application pool en de beheerder. Het zit niet in het artefact, dus de FTPS-deploy overschrijft het niet; het staat niet in de repo en niet in `wwwroot` (wordt nooit geserveerd). Bryan mag het bestand zelf op de server zetten (bevestigd door de hoster).
@@ -175,10 +209,10 @@ Eén bestand, **server-only**, naast het programma (naast de exe en de `appsetti
| `JwtSettings:Secret` | eigen testsleutel (64+ tekens) | **nieuwe, andere** sleutel; niet de testsleutel hergebruiken | | `JwtSettings:Secret` | eigen testsleutel (64+ tekens) | **nieuwe, andere** sleutel; niet de testsleutel hergebruiken |
| `Identity:Setup:Token` | testtoken | nieuw token; na de eerste beheerder uit het bestand halen | | `Identity:Setup:Token` | testtoken | nieuw token; na de eerste beheerder uit het bestand halen |
| `Observability:SentryDsn` / `Environment` | test-DSN / `test` | productie-DSN (de bestaande ASF-website-DSN, tenzij Bryan een eigen project wil) / `production` | | `Observability:SentryDsn` / `Environment` | test-DSN / `test` | productie-DSN (de bestaande ASF-website-DSN, tenzij Bryan een eigen project wil) / `production` |
| `ForwardedHeaders:KnownProxies[0]` | `192.168.1.102` (nginx op de Pi) | **niet overnemen**; bij inprocess leeg laten, tenzij de hoster een proxy/CDN voor IIS zet (vraag) | | `ForwardedHeaders:KnownProxies[0]` | `192.168.1.102` (nginx op de Pi) | **niet zetten**: productie is IIS in-process zonder proxy; ForwardedHeaders staat uit (zie 2a) |
| `Website:NoIndex` | `true` (standaard) | `false`, pas op het release-moment na Bryans go | | `Website:NoIndex` | `true` (standaard) | `false`, pas op het release-moment na Bryans go |
| `Website:PublicBaseUrl` | het testadres (waarschijnlijk) | leeg of `https://www.andreaslop.nl` (zonder slash) | | `Website:PublicBaseUrl` | het testadres (waarschijnlijk) | leeg of `https://andreaslop.nl` (zonder slash) |
| `App:PublicBaseUrl` | het testadres (waarschijnlijk) | `https://www.andreaslop.nl` | | `App:PublicBaseUrl` | het testadres (waarschijnlijk) | `https://andreaslop.nl` |
| `Website:LogLevel` | `Information` | `Warning` (standaard); alleen tijdelijk `Information` | | `Website:LogLevel` | `Information` | `Warning` (standaard); alleen tijdelijk `Information` |
| `Email:Smtp:*` | testinstelling of leeg | SMTP-gegevens van de hoster of een andere aanbieder (zie 1c) | | `Email:Smtp:*` | testinstelling of leeg | SMTP-gegevens van de hoster of een andere aanbieder (zie 1c) |
| `Media:Directory` | map op de Pi | `uploads` naast `wwwroot` (zie 1e) | | `Media:Directory` | map op de Pi | `uploads` naast `wwwroot` (zie 1e) |
@@ -200,10 +234,10 @@ Waarden die alleen Bryan kent staan als `<geheim>`; de rest is voorgesteld.
}, },
"Website": { "Website": {
"NoIndex": true, "NoIndex": true,
"PublicBaseUrl": "https://www.andreaslop.nl" "PublicBaseUrl": "https://andreaslop.nl"
}, },
"App": { "App": {
"PublicBaseUrl": "https://www.andreaslop.nl" "PublicBaseUrl": "https://andreaslop.nl"
}, },
"Email": { "Email": {
"Smtp": { "Smtp": {
@@ -259,7 +293,8 @@ Nog open:
1. ~~Database-TLS~~ afgehandeld: de server biedt TLS, `SslMode=Required` staat in het voorbeeld. Restrisico: geen certificaatcontrole (`VerifyCA`/`VerifyFull` later, met het CA-certificaat van de hoster). 1. ~~Database-TLS~~ afgehandeld: de server biedt TLS, `SslMode=Required` staat in het voorbeeld. Restrisico: geen certificaatcontrole (`VerifyCA`/`VerifyFull` later, met het CA-certificaat van de hoster).
2. **Toegangsbeperking tot het IP van de webserver** is niet mogelijk; blijft een restrisico. Een sterk, uniek wachtwoord is verplicht (zie 4a). 2. **Toegangsbeperking tot het IP van de webserver** is niet mogelijk; blijft een restrisico. Een sterk, uniek wachtwoord is verplicht (zie 4a).
3. **Fysiek pad van `uploads`** uit het hostingpaneel invullen in `Media:Directory`, en schrijfrechten voor de application pool-identiteit zetten (Bryan). Daarna de test uit 1e. 3. **Fysiek pad van `uploads`** uit het hostingpaneel invullen in `Media:Directory`, en schrijfrechten voor de application pool-identiteit zetten (Bryan). Daarna de test uit 1e.
4. Staat er een reverse proxy/CDN van de hoster voor IIS (voor `ForwardedHeaders:KnownProxies[0]`)? Zo niet: leeg laten. 4. ~~Reverse proxy voor IIS~~ afgehandeld: er is geen proxy; ForwardedHeaders staat uit (zie 2a).
8. Doet de hoster al HTTP naar HTTPS en www naar apex? Zo niet: staat de URL Rewrite-module op de server? Zie 2a voor de regel.
5. Welke MariaDB-versie, en welke rechten (CREATE/ALTER/INDEX/DROP/REFERENCES) heeft de gebruiker `57409_andreaslopfotografie`; is de naam hoofdlettergevoelig? (Database en gebruiker: `57409_andreaslopfotografie`, letterlijk uit het paneel.) 5. Welke MariaDB-versie, en welke rechten (CREATE/ALTER/INDEX/DROP/REFERENCES) heeft de gebruiker `57409_andreaslopfotografie`; is de naam hoofdlettergevoelig? (Database en gebruiker: `57409_andreaslopfotografie`, letterlijk uit het paneel.)
6. Grootte van het pakket (2 GB totaal is de standaardgrens van de bibliotheek). 6. Grootte van het pakket (2 GB totaal is de standaardgrens van de bibliotheek).
7. SMTP-aanbieder en afzenderadres voor mail (zie 1c). 7. SMTP-aanbieder en afzenderadres voor mail (zie 1c).